THotPDF.DecodeLoadedImageColorKeyMask Method
يبني الصورة النقطية لقناع color-key لصورة محمَّلة يحمل قاموسها مدخل /Mask على شكل مصفوفة
التصريح
function DecodeLoadedImageColorKeyMask(
AImageStream: THPDFStreamObject): TBitmap;الوحدة
HPDFDoc
المعاملات
| الاسم | الغرض |
|---|---|
AImageStream | كائن stream لصورة محمَّلة يحتوي قاموسه مصفوفة /Mask الخاصة بـ color-key |
القيمة المُعادة
bitmap رمادي 24-bit يوافق أبعاد الصورة، يُظهر بالأسود البكسلات التي تقع جميع عيناتها ضمن مدى مكوناتها، وبالأبيض البكسلات التي يخرج أحد مكوناتها عن مداها؛ ويعيد nil إذا لم تكن الصورة مؤهلة
ملاحظات الاستخدام
- شروط الأهلية تحاكي قواعد PDF لقناع color-key: يجب أن تكون الصورة قابلة لفك الترميز، وأن لا تكون image mask، وأن تحمل من 1 إلى 4 مكونات لونية، وأن تملك مصفوفة /Mask بقيمتين لكل مكون
- تُقارن المديات بالعينات كما هي مخزنة، قبل
/Decode؛ وفي الصورة المفهرسة (Indexed) يعني ذلك فهرس اللوحة، في يمكن أن يُقنَّع مدخلان للون نفسه بطريقتين مختلفتين - التدفقات المرمزة بـ DCTDecode أو JPXDecode أو JBIG2Decode أو CCITT تعيد nil: codecs الفاقدة لا تحفظ قيم العينات الدقيقة
RenderLoadedPageToBitmapوBuildLoadedPageSVGيطبقان هذا القناع عند رسم الصورة- يحترم فك الترميز ميزانية البايتات المضبوطة له، فتفشل الصور العدائية أو الضخمة بأمان بدل استنفاد الذاكرة
- الـ bitmap المعاد ملك للمستدعي؛ ادمجه مع
DecodeLoadedImageStreamلمعاينة المناطق التي سيعتبرها القارئ مقنَّعة