AddImageFromStream

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

תיאור

מוסיף תמונה מ-TStream למסמך הנבחר

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

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

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

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

תחביר

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

פרמטרים

InStreamאובייקט ה-TStream המכיל את נתוני התמונה. את המיקום הנוכחי בזרם יתעלמו, ונתוני התמונה ייקראו מהמיקום 0 בזרם
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אירעה שגיאה בקריאת נתוני תמונה תקינים מהזרם התמונה נוספה למסמך בהצלחה. הערך שמוחזר הוא המזהה של התמונה, שאפשר להשתמש בו עם פונקציות ציור תמונות כמו DrawImage
Non-zero