ObjectTransparent - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

يشير إلى ما إذا كان كائن صفحة يشارك في شفافية PDF — سواء عبر ألفا تعبئة/حد غير معتم أو عبر نمط مزج غير Normal — وبالتالي يحتاج إلى تركيب لا إلى عرض بسيط وفق خوارزمية الرسام

Syntax

property ObjectTransparent[Index: Integer]: Boolean; // read only

Description

قدّم PDF 1.4 نموذج التصيير بالشفافية (PDF 32000-1 § 11) الذي يتيح لأي كائن صفحة تحديد ألفا حالة رسوميات (ca/CA) ونمط مزج (BM في قاموس ExtGState). وتُرجع ObjectTransparent ‏True إذا كشف PDFium أيًّا منهما على الكائن عند Index، أي أن العارض لا يستطيع الطلاء البسيط فوقه وعليه تخصيص مخزن تركيب معزول للكائن.

هذه هي النسخة على مستوى الكائن من Transparent التي تُبلغ عما إذا كانت الصفحة الحالية كلها تحتوي أي محتوى شفاف. استخدمها عندما تريد تسطيح الأجزاء المكلفة فقط من صفحة، أو تدقيق ملفات PDF الواردة لسير عمل مطابع لا تفهم الشفافية، أو تسريع العرض المخصص بتجاوز التركيب لغالبية الكائنات المعتمة تمامًا.

تعكس النتيجة حالة الرسوميات الخاصة بالكائن وقت الإدراج. وتغيير الكائن (مثلًا عبر FPDFPageObj_SetFillColor الأصلية بألفا غير 255) لا يغير القيمة المبلغ عنها إلا بعد أن يعيد UpdatePage و ReloadPage بناء الصفحة المخزنة مؤقتًا.

Parameters

Index فهرس كائن صفحة يبدأ من الصفر، 0 ≤ Index < ObjectCount.

Remarks

كائنات الصور التي يحوي مصدرها قناة ألفا (قناع ناعم / SMask) تُبلغ أيضًا True.
قد يكون الكائن جزئيًا خلف جار شفاف ومع ذلك يُبلغ False — فالخاصية تصف الكائن نفسه، لا كيفية تركيبه مع إخوته.
تغلف FPDFPageObj_HasTransparency من PDFium وهي مقصودًا رخيصة الاستدعاء داخل الحلقات على ObjectCount.
القيمة المبلغ عنها مستقلة عن PageRotation وتحجيم الصفحة و DPI العرض الحالي.

Example

// Count opaque vs transparent objects on the current page.
var I, NOpaque, NAlpha: Integer;
begin
  NOpaque := 0; NAlpha := 0;
  for I := 0 to Pdf1.ObjectCount - 1 do
    if Pdf1.ObjectTransparent[I] then Inc(NAlpha)
    else Inc(NOpaque);
  Memo1.Lines.Add(Format('opaque=%d, transparent=%d', [NOpaque, NAlpha]));
end;

ObjectTransparent الخاصية