Bitmap Proprietà

Bitmap restituisce una TBitmap con i dati pixel dell'immagine raster numero n della pagina corrente. PDFium decodifica lo stream sottostante (dati pixel JPEG, JPEG2000, CCITT, JBIG2 o FlateDecode) e PDFium Delphi Component converte il risultato in una VCL TBitmap alla risoluzione memorizzata dell'immagine, con l'alpha preservato come superficie ARGB a 32 bit quando la sorgente fornisce una soft mask

Ogni chiamata alloca una bitmap nuova; la proprietà non fa caching. Questo rende la proprietà sicura da chiamare dai thread di lavoro ma implica che i chiamanti devono sempre liberare l'oggetto restituito, in genere dentro un blocco try .. finally

Quando servono anche la matrice di trasformazione e il rettangolo di delimitazione dell'immagine sulla pagina usa Image[Index] — restituisce un record che riunisce la stessa TBitmap con i metadati posizionali. Il sibling indipendente dalla forma ObjectBitmap[ObjectIndex] indicizza l'intero array di oggetti di pagina (testo, tracciati e immagini misti) e restituisce la stessa bitmap se l'oggetto puntato è a sua volta un'immagine

• Per i PDF con migliaia di immagini piccole, preferisci iterare a blocchi liberando subito ogni bitmap per limitare la memoria di picco
• La bitmap restituita non codifica alcun suggerimento DPI; dimensionala in base alla risoluzione sorgente se devi stampare alla dimensione di output nominale della pagina
• Usa la trasformazione di coordinate della pagina da Image se intendi rimettere la bitmap nella posizione originale sulla pagina
• Restituisce nil quando Index è fuori intervallo o il documento non è attivo