BitmapCount property

Number of image page objects on the active page, accessible as VCL TBitmap

BitmapCount returns the count of image page objects on the currently active page (PDF 1.7 spec section 8.9). It pairs with the indexer Bitmap[Index], which decodes the underlying image stream into a fully rendered Delphi TBitmap (32-bit RGBA, ready for Canvas.Draw, clipboard transfer, or saving to PNG/BMP)

The value is 0 when Active is False, when PageNumber is invalid, or when the page contains no image objects. The count is identical to ImageCount; the two properties differ only in the return type of their indexers — Image[Index] hands back a TPdfImage record whose Data holds the decoded pixel buffer and whose RawData carries the still-encoded image stream, whereas Bitmap[Index] wraps that buffer into a managed VCL TBitmap owned by the caller

The typical loop is for I := 0 to Pdf.BitmapCount - 1 do followed by Pdf.Bitmap[I]. Each access allocates a new TBitmap and copies pixels — do not call it in tight rendering loops; cache the bitmap when reused Free each returned bitmap when finished to release GDI resources promptly

• Image masks (soft masks, stencil masks) are merged into the decoded TBitmap alpha channel automatically by PDFium
• If you only need pixel data for export (PNG/JPEG/etc.) and not for drawing, ImageCount / Image[Index] avoids the GDI bitmap allocation overhead
• A page’s BitmapCount is not affected by zoom level, viewport, or page rotation — it is a structural property of the page content stream

Bitmap, ImageCount, Image, ObjectBitmap