Bitmap Propriedade

Bitmap retorna um TBitmap contendo os dados de pixel da n-ésima imagem raster na página atual. O PDFium decodifica o stream subjacente (JPEG, JPEG2000, CCITT, JBIG2 ou dados de pixel FlateDecode) e o PDFium Delphi Component converte o resultado em um TBitmap da VCL na resolução armazenada da imagem, com o alfa preservado como uma superfície ARGB de 32 bits quando a origem fornece uma soft mask.

Cada chamada aloca um bitmap novo; a propriedade não faz cache. Isso torna a propriedade segura para chamar de threads de trabalho, mas significa que os chamadores devem sempre liberar o objeto retornado, tipicamente dentro de um bloco try .. finally.

Quando você também precisa da matriz de transformação e do retângulo delimitador da imagem na página, use Image[Index] em vez disso — ele retorna um record que agrupa o mesmo TBitmap com metadados posicionais. O irmão independente de forma ObjectBitmap[ObjectIndex] indexa o array completo de objetos de página (texto, caminhos e imagens misturados) e retorna o mesmo bitmap se o objeto visado por acaso for uma imagem.

• Para PDFs contendo milhares de imagens pequenas, prefira iterar em lotes e liberar cada bitmap prontamente para limitar o pico de memória.
• O bitmap retornado não tem sugestão de DPI codificada; dimensione-o conforme a resolução de origem se precisar imprimir no tamanho nominal de saída da página.
• Use a transformação de coordenadas da página obtida de Image se pretender colocar o bitmap de volta no local original na página.
• Retorna nil quando Index está fora do intervalo ou quando o documento não está ativo.