PDFium Delphi Component Docs

GetObjectRenderedStrokePattern الطريقة

المكوّن: TPdf  ·  الوحدة: PDFium
تصيِّر نمط التبليط الذي يُرسَّم به كائن الصفحة وتعيده كصورة نقطية يملكها المستدعي

الصياغة

function GetObjectRenderedStrokePattern(Index: Integer): TBitmap;

IndexInteger. فهرس كائن صفحة صفري الأساس في المدى 0 .. ObjectCount - 1
ResultTBitmap. صورة نقطية أُنشئت حديثًا يملكها المستدعي وعليه تحريرها، أو nil عندما لا يُرسَّم الكائن بنمط تبليط، أو يكون التصدير الأصلي ناقصًا، أو يفشل التصيير

الوصف

كائن المسار الذي يكون فضاء ألوان حدوده /Pattern مع نمط PatternType 1 (تبليط) يرسم محيطه بخلية متكررة بدل لون سادة. تصيِّر هذه الطريقة تلك الخلية وحدها عبر التصدير الأصلي FPDFPageObj_GetRenderedStrokePattern، فيستطيع المستدعي فحص النمط أو تصديره أو معاينته دون تصيير الصفحة كاملة

يُحتفظ بقفل التصيير أثناء الاستدعاء الأصلي، فالعملية آمنة أمام التصيير المتزامن على المكوّن نفسه. وتُحوَّل الصورة النقطية الأصلية وتُدمَّر قبل الإرجاع، وتنتمي TBitmap الناتجة إلى المستدعي

يتطلب الاستدعاء أن تكون الصفحة الحالية نشطة. والكائنات التي ليست مسارات، والمسارات المرسومة بلون سادة أو بنمط تظليل، والأنماط المخصصة للتعبئة فقط، جميعها تعيد nil بدل رفع استثناء؛ واستخدم PageObjectInfo أو PathInfo لمعرفة السبب

أنماط التبليط الملوَّنة (PaintType 1) تُصيَّر بألوانها الخاصة؛ أما غير الملوَّنة (PaintType 2) فتُصيَّر بلون الحدود الذي اختاره content stream

ملاحظات

مثال

var
  I: Integer;
  Bmp: TBitmap;
begin
  for I := 0 to Pdf1.ObjectCount - 1 do
  begin
    Bmp := Pdf1.GetObjectRenderedStrokePattern(I);
    if Bmp <> nil then
      try
        Bmp.SaveToFile(Format('stroke-pattern-%d.bmp', [I]));
      finally
        Bmp.Free;
      end;
  end;
end;

انظر أيضًا

GetImageObjectRenderedBitmap, GetTextObjectRenderedBitmap, PathInfo, StrokePatternRenderingFeaturesAvailable