AddImageFromString

טיפול בתמונות

תיאור

מוסיף תמונה מהזיכרון למסמך הנבחר

לאחר שתמונה התווספה למסמך אפשר לצייר אותה מספר פעמים בכל עמוד בלי להגדיל יותר את גודל קובץ ה-PDF

סוגי קובצי התמונה הנתמכים הם BMP, TIFF, JPEG, PNG, GIF, WMF, EMF ו-WebP, וכן AVIF, HEIF, HEIC ו-JPEG XL כאשר מפענח תמונות מודרני זמין

התנהגות גרסת PDF: ייבוא נתוני תמונה של 16-bit-per-component דורש PDF 1.5. כאשר מסמך מוגדר ל-PDF 1.4 ומטה וגרסת השמירה אינה נעולה, AddImageFromString מעלה אוטומטית את המסמך ל-PDF 1.5 ורושמת 16-bit image samples בתוך AutoBumpedFeatures. אם הקורא נועל גרסת שמירה נמוכה יותר, שער התאימות דוחה את השמירה עם LastErrorCode 602

עבור תמונות BMP ו-TIFF ניתן לקרוא ל-CompressImages לפני קריאה לפונקציה זו כדי לדחוס את נתוני התמונה; סוגי תמונות אחרים נדחסים אוטומטית

תחביר

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

פרמטרים

Sourceמחרוזת המכילה את נתוני התמונה. בגרסת ה-ActiveX של הספרייה המחרוזת חייבת להכיל תווים בני 16 סיביות, ורק 8 הסיביות הנמוכות של כל תו ינוצלו
Optionsעבור תמונות TIFF מרובות דפים הפרמטר מציין את מספר הדף לטעינה. עבור תמונות PNG: 0 = טעינת התמונה כרגיל 1 = טעינת ערוץ ה-alpha כתמונת גווני אפור 2 = טעינת התמונה וערוץ ה-alpha (הגבלת ה-alpha ל-8 סיביות) 3 = טעינת התמונה (הגבלת התמונה ל-8 סיביות לערוץ) 4 = טעינת ערוץ ה-alpha (הגבלה ל-8 סיביות לערוץ) 5 = טעינת התמונה עם ערוץ ה-alpha (הגבלת שניהם ל-8 סיביות לערוץ) 6 = טעינת התמונה וערוץ ה-alpha 7 = טעינת התמונה ופרופיל הצבע ICC 8 = טעינת התמונה, ערוץ ה-alpha ופרופיל הצבע ICC תוך שמירה על עומק סיביות גבוה עבור סוגי תמונה אחרים יש להגדיר פרמטר זה ל-0. הגדרת Options ל-1- כופה טעינה של תמונות TIFF, EMF ו-WMF באמצעות ספריית הגרפיקה GDI+. אפשר לטעון גם תמונות TIFF מרובות דפים באמצעות GDI+ על ידי הגדרת הפרמטר Options ל- -PageNumber (למשל -3 עבור דף 3)

ערכי החזרה

0נתוני התמונה לא היו תקינים או שהתמונה הייתה בפורמט לא נתמך התמונה נוספה בהצלחה. הערך שמוחזר הוא ה-ImageID שאפשר להשתמש בו עם פונקציות כמו SelectImage ו-DrawImage
1