PDFium Delphi Component Docs

ImageCount الخاصية

Component: TPdf  ·  Unit: PDFium
عدد كائنات الصورة النقطية XObject على الصفحة النشطة حاليًا

Syntax

property ImageCount: Integer; // read only

Description

تستعرض الخاصية ImageCount كل كائن صفحة نوعه FPDF_PAGEOBJ_IMAGE على الصفحة المختارة في PageNumber. وبمصطلحات PDF فهذه هي Image XObjects المشار إليها من مسار محتوى الصفحة (القسم 8.9 من مواصفة PDF 1.7). وقد استُبعد محتوى المتجهات و form XObjects والتظليلات ورموز النص عمدًا، فتطابق القيمة ما يسميه القارئ البشري “صورة” على الصفحة.

تتطلب الخاصية أن تكون Active تساوي True وأن يكون PageNumber صالحًا. وعندما لا يكون المستند محمَّلًا تكون القيمة 0. مقدار ImageCount لكل صفحة؛ فاستعرض كل صفحة واجمع العدد للحصول على إجمالي على مستوى المستند. وتكافئ ImageCount قيمة BitmapCount وقد وُفرت لتتناغم طبيعيًا مع مفهرس Image[Index] الذي يُرجع سجل TPdfImage مفكوك الترميز (Width و Height وبايتات البكسل الخام).

النمط الاعتيادي للحلقة هو for I := 0 to Pdf.ImageCount - 1 do، حيث يعطي Pdf.Image[I] البكسلات المفكوكة الترميز. وتتدرج التكلفة مع حجم بيانات الصورة لأن PDFium يفك ترميز مسارات JPEG / JPEG2000 / CCITTFax / Flate عند الطلب؛ فخزّن النتيجة مؤقتًا إذا احتجتها أكثر من مرة لكل صفحة.

Remarks

Example

// Save every image on the current page to disk.
var I: Integer;
var Img: TPdfImage;
begin
  Pdf1.Active := True;
  for I := 0 to Pdf1.ImageCount - 1 do
  begin
    Img := Pdf1.Image[I];
    TFile.WriteAllBytes(Format('page%d_img%d.bin', [Pdf1.PageNumber, I]), Img.Data);
  end;
end;

See Also

Image, BitmapCount, Bitmap, ObjectCount