Bitmap Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

Gibt ein frisch decodiertes VCL-<code>TBitmap</code> mit den Rasterdaten des angegebenen Bildobjekts auf der aktuellen Seite zurück. Das Bitmap wird bei jedem Aufruf neu angelegt; der Aufrufer besitzt es und ist für den Aufruf von <code>Free</code> verantwortlich

Bitmap gibt ein TBitmap zurück, das die Pixeldaten des n-ten Rasterbildes auf der aktuellen Seite enthält. PDFium dekodiert den zugrunde liegenden Stream (JPEG-, JPEG2000-, CCITT-, JBIG2- oder FlateDecode-Pixeldaten) und PDFiumPas wandelt das Ergebnis in ein VCL TBitmap mit der gespeicherten Auflösung des Bildes um, wobei Alpha als 32-Bit-ARGB-Oberfläche erhalten bleibt, wenn die Quelle eine weiche Maske liefert

Jeder Aufruf reserviert ein neues Bitmap; die Eigenschaft cached nicht. Dadurch ist die Eigenschaft zwar sicher 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 Begrenzungsrechteck des Bildes auf der Seite benötigen, verwenden Sie stattdessen Image[Index] - es gibt einen Datensatz zurück, der dasselbe TBitmap mit Positionsmetadaten bündelt. Das formagnostische Gegenstück ObjectBitmap[ObjectIndex] indiziert in das gesamte Seitenobjekt-Array (gemischter Text, Pfade, Bilder) und gibt dasselbe Bitmap zurück, wenn das Zielobjekt zufällig ein Bild ist

• Bei PDFs mit Tausenden kleiner Bilder sollten Sie in Batches iterieren und jedes Bitmap zeitnah freigeben, um den Spitzenbedarf an Speicher zu begrenzen
• Im zurückgegebenen Bitmap ist kein DPI-Hinweis codiert; richten Sie die Größe an der Quellauflösung aus, wenn Sie auf der nominalen Ausgabengröße der Seite drucken müssen
• Use the page's coordinate transform from Image wenn Sie beabsichtigen, das Bitmap wieder an der ursprünglichen Position auf der Seite zu platzieren
• Returns nil when Index außerhalb des Bereichs liegt oder wenn das Dokument nicht aktiv ist

BitmapCount, Image, ImageCount, ObjectBitmap