PDFium Delphi Component Docs

الطريقة RenderTile

المكوّن: TPdf  ·  الوحدة: PDFium
تصيير منطقة مستطيلة من صفحة إلى صورة نقطية جديدة. يجب تحرير الصورة النقطية المُعادة يدويًا

الصياغة

function RenderTile(Left, Top, Width, Height, PageWidth, PageHeight: Integer; Rotation: TRotation = ro0; Options: TRenderOptions = []; Color: TColor = clWhite): TBitmap;

Left, TopInteger. ركن أعلى يسار منطقة البلاطة المطلوب تصييرها، بالبكسل، نسبة إلى الصفحة الكاملة عند مستوى التكبير المعطى
Width, HeightInteger. حجم البلاطة بالبكسل. ستكون للصورة النقطية المُعادة هذه الأبعاد
PageWidth, PageHeightInteger. أبعاد الصفحة الكاملة بالبكسل عند مستوى التكبير المطلوب. تحدد هذه المقياس الذي تصيَّر به الصفحة
RotationTRotation. دوران العرض المطبق على الصفحة: ro0 (الافتراضي)، أو ro90، أو ro180، أو ro270
OptionsTRenderOptions. مجموعة من أعلام TRenderOption تتحكم في جودة التصيير وسلوكه
ColorTColor. لون تعبئة الخلفية للصورة النقطية قبل التصيير. الافتراضي clWhite

 

procedure RenderTile(Bitmap: TBitmap; Left, Top, Width, Height, PageWidth, PageHeight: Integer; Rotation: TRotation = ro0; Options: TRenderOptions = []; Color: TColor = clWhite);

BitmapTBitmap. كائن TBitmap موجود لتصيير البلاطة فيه. المستدعي مسؤول عن إنشاء هذه الصورة النقطية وتحريرها
Left, TopInteger. ركن أعلى يسار منطقة البلاطة المطلوب تصييرها، بالبكسل، نسبة إلى الصفحة الكاملة عند مستوى التكبير المعطى
Width, HeightInteger. حجم البلاطة بالبكسل
PageWidth, PageHeightInteger. أبعاد الصفحة الكاملة بالبكسل عند مستوى التكبير المطلوب
RotationTRotation. دوران العرض المطبق على الصفحة: ro0 (الافتراضي)، أو ro90، أو ro180، أو ro270
OptionsTRenderOptions. مجموعة من أعلام TRenderOption تتحكم في جودة التصيير وسلوكه
ColorTColor. لون تعبئة الخلفية المطبق على الصورة النقطية قبل التصيير. الافتراضي clWhite

الوصف

يختار Color = clNone أو Color = clDefault خلفية شفافة و bitmap يدعم alpha؛ يبقى alpha بكسلات البلاطة غير المغطاة صفرًا مستقلًا عن الاستعلام الأصلي؛ clWhite الافتراضي معتم

تصيِّر بلاطة مستطيلة من الصفحة الحالية. على خلاف RenderPage، الذي يصيِّر الصفحة الكاملة بحجم معطى، يصيِّر RenderTile منطقة مقصوصة فقط. هذا مثالي للعرض عالي الدقة للصفحات الكبيرة حيث كان تصيير الصفحة الكاملة دفعة واحدة سيستهلك ذاكرة أكثر من اللازم

يحدد PageWidth / PageHeight الحجم المصيَّر الإجمالي للصفحة ("مستوى التكبير")، ويحدد Left / Top / Width / Height نافذة الإخراج داخل ذلك الحجم الإجمالي

مثال

// Render top-left 800x600 tile of a page scaled to 2000x2828
var Bmp: TBitmap;
Bmp := Pdf.RenderTile(0, 0, 800, 600, 2000, 2828);
try
  Image1.Picture.Assign(Bmp);
finally
  Bmp.Free;
end;

انظر أيضًا

RenderPage, PageWidth