THotPDF.DecodeLoadedImageColorKeyMask Method
برای تصویر بارگذاری‌شده‌ای که دیکشنری‌اش مدخل آرایه‌ای /Mask دارد، بیت‌مپ ماسک color-key را می‌سازد
اعلان
function DecodeLoadedImageColorKeyMask(
AImageStream: THPDFStreamObject): TBitmap;واحد
HPDFDoc
پارامترها
| نام | هدف |
|---|---|
AImageStream | شیء جریان تصویر بارگذاری‌شده‌ای که دیکشنری‌اش آرایهٔ color-key /Mask را حمل می‌کند |
مقدار بازگشت
بیت‌مپ خاکستری 24 بیتی هم‌اندازهٔ تصویر که در آن سیاه نشانگر پیکسل‌هایی است که همهٔ sampleهایشان داخل بازهٔ مؤلفه‌شان می‌افتد و سفید نشانگر پیکسل‌هایی که دست‌کم یک مؤلفه‌شان بیرون از بازه‌اش است؛ وقتی تصویر واجد شرایط نباشد nil
یادداشت‌های استفاده
- شرط واجد بودن، قواعد ماسک color-key PDF را بازتاب می‌دهد: تصویر باید قابل کدگشایی باشد، image mask نباشد، 1 تا 4 مؤلفهٔ رنگ داشته باشد و آرایهٔ /Mask با 2 مقدار به‌ازای هر مؤلفه داشته باشد
- بازه‌ها با sampleها مقایسه می‌شوند، همان‌طور که ذخیره شده‌اند و پیش از
/Decode؛ برای تصویر Indexed یعنی اندیس پالت، پس دو مدخل از یک رنگ می‌توانند متفاوت mask شوند - جریان‌های DCTDecode و JPXDecode و JBIG2Decode و کدشده با CCITT مقدار nil برمی‌گردانند: codecهای با اتلاف مقادیر دقیق sample را حفظ نمی‌کنند
RenderLoadedPageToBitmapوBuildLoadedPageSVGهنگام رسم تصویر این ماسک را اعمال می‌کنند- کدگشایی به بودجهٔ بایتی پیکربندی‌شدهٔ decode پایبند است، پس تصویرهای مخرب یا بیش‌ازحد بزرگ به‌جای تمام‌کردن حافظه، تمیز شکست می‌خورند
- بیت‌مپ برگشتی در مالکیت فراخواننده است؛ آن را با
DecodeLoadedImageStreamترکیب کنید تا ببینید کدام ناحیه‌ها در نمایشگر masked تلقی می‌شوند