Bitmap Eigenschaft

Bitmap liefert ein TBitmap mit den Pixeldaten des n-ten Rasterbilds auf der aktuellen Seite. PDFium dekodiert den zugrunde liegenden Stream (JPEG, JPEG2000, CCITT, JBIG2- oder FlateDecode-Pixeldaten) und PDFium Delphi Component wandelt das Ergebnis in ein VCL-TBitmap mit der gespeicherten Auflösung des Bilds um; Alpha bleibt als 32-Bit-ARGB-Oberfläche erhalten, wo die Quelle eine Softmask mitliefert

Jeder Aufruf allokiert eine frische Bitmap; die Eigenschaft cacht nicht. Damit ist sie bedenkenlos aus Worker-Threads aufrufbar, aber Aufrufer müssen das zurückgegebene Objekt immer freigeben, typischerweise in einem try .. finally-Block

Wenn Sie zusätzlich die Transformationsmatrix und das umgebende Rechteck des Bilds auf der Seite brauchen, verwenden Sie Image[Index] — es liefert einen Record, der dasselbe TBitmap mit Positionsmetadaten bündelt. Der formunabhängige Bruder ObjectBitmap[ObjectIndex] indiziert das vollständige Seitenobjekt-Array (gemischt aus Text, Pfaden, Bildern) und liefert dieselbe Bitmap, falls das anvisierte Objekt zufällig ein Bild ist

• Bei PDFs mit Tausenden kleiner Bilder lieber in Batches iterieren und jede Bitmap zeitnah freigeben, um den Speicherhöchststand zu begrenzen
• Die zurückgegebene Bitmap trägt keinen DPI-Hinweis; dimensionieren Sie sie anhand der Quellauflösung, wenn Sie in der nominalen Ausgabegröße der Seite drucken wollen
• Verwenden Sie die Koordinatentransformation der Seite aus Image, wenn Sie die Bitmap an der ursprünglichen Position auf der Seite platzieren wollen
• Liefert nil, wenn Index außerhalb des Bereichs liegt oder das Dokument nicht aktiv ist