PDFium Component Docs

ImageCount eigenschap

Component: TPdf  ·  Unit: PDFium
Aantal rasterafbeelding-XObjects op de momenteel actieve pagina

Syntax

property ImageCount: Integer; // read only

Description

ImageCount enumerateert elk pagina-object waarvan het type FPDF_PAGEOBJ_IMAGE is op de pagina geselecteerd door PageNumber. In PDF-termen zijn dit de Image-XObjects waarnaar wordt verwezen vanuit de inhoudsstroom van de pagina (PDF 1.7-specificatie, sectie 8.9). Vectorinhoud, form-XObjects, arceringen en tekstglyfen worden opzettelijk uitgesloten, zodat de waarde overeenkomt met wat een menselijke lezer een “afbeelding” op de pagina zou noemen.

De eigenschap vereist dat Active True is en een geldige PageNumber. Wanneer het document niet is geladen is de waarde 0. ImageCount is een hoeveelheid per pagina; doorloop elke pagina en accumeleer het aantal voor een documentbrede totaal. ImageCount is equivalent aan BitmapCount en wordt aangeboden om natuurlijk te combineren met de indexeerder Image[Index], die een gedecodeerd TPdfImage-record retourneert (Width, Height, ruwe pixelbytes).

Het typische luspatroon is for I := 0 to Pdf.ImageCount - 1 do, waarbij Pdf.Image[I] de gedecodeerde pixels geeft. De kosten schalen met de afbeeldingsgegevensgrootte omdat PDFium JPEG-/JPEG2000-/CCITTFax-/Flate-stromen op aanvraag decodeert; cachel het resultaat als u het meer dan eens per pagina nodig heeft.

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