AddImageDirectFromString
معالجة الصور
الوصف
ينشئ XObject صورة مباشرةً من بايتات عينات صورة مرمزة سلفًا بدلًا من اكتشاف صيغة حاوية مثل PNG أو TIFF أو JPEG
سلوك إصدار PDF: يتطلب مرشح صورة JBIG2Decode إصدار PDF 1.4 بينما تتطلب JPXDecode وCrypt وعينات الصور ذات BitsPerComponent = 16 إصدار PDF 1.5. وعندما يُضبط المستند تحت الإصدار المطلوب ولم يكن إصدار الحفظ مقفلًا يرفع AddImageDirectFromString إصدار المستند تلقائيًا ويسجل JBIG2Decode filter أو JPXDecode filter أو Crypt filter أو 16-bit image samples في AutoBumpedFeatures. وإذا قفل المستدعي إصدار حفظ أقل رفضت بوابة التوافق الحفظ مع LastErrorCode 602
الصيغة
Delphi
Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;المعاملات
| Source | بيانات صورة خام أو مرمزة المطلوب تخزينها في تدفق الصورة |
|---|---|
| Width | Image width in pixels. |
| Height | Image height in pixels. |
| BitsPerComponent | عدد البتات لكل مركّب عينة. وتسمح قواميس صور PDF بـ 1 و2 و4 و8 في الإصدارات الأقدم؛ وعينات 16 بت هي PDF 1.5 |
| ColorSpace | اسم أو مصفوفة فضاء ألوان PDF لقاموس الصورة، مثل /DeviceGray أو /DeviceRGB أو مصفوفة فضاء لون مفهرس |
| Filter | اسم مرشح تدفق PDF، مثل FlateDecode أو DCTDecode أو JPXDecode. استخدم سلسلة فارغة لبيانات غير مرشحة |
| Decode | نص مصفوفة PDF Decode اختياري. مرِّر سلسلة فارغة عندما لا تكون مدخلة Decode مطلوبة |
| Interpolate | يكتب غير الصفري علم /Interpolate true |
قيم الإرجاع
| 0 | تعذّر إنشاء الصورة أو يحظر وضع PDF/A الحالي المرشح المطلوب |
|---|---|
| Non-zero | ImageID الجديد. وتُختار الصورة المنشأة لعمليات الصور اللاحقة |
ملاحظات
يرفض وضع PDF/A LZWDecode في كل الأجزاء ويرفض JBIG2Decode / JPXDecode في PDF/A-1. وعلى المستدعي مسؤولية مطابقة بايتات Source مع ColorSpace وFilter وDecode والأبعاد وعمق العينة المعلنة
انظر أيضا
AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage