THotPDF.DecodeLoadedImageRegion Method
Descodifica um retângulo exato em coordenadas de origem de um stream de XObject de imagem carregado para um TBitmap pertencente a quem chama
Declaração
function DecodeLoadedImageRegion(AImageStream: THPDFStreamObject;
RegionLeft, RegionTop, RegionRight, RegionBottom: Integer): TBitmap;
Unidade
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
AImageStream | Fluxo XObject de imagem carregado para descodificar |
RegionLeft | Coordenada de origem esquerda inclusiva |
RegionTop | Coordenada de origem superior inclusiva |
RegionRight | Coordenada de origem direita exclusiva |
RegionBottom | Coordenada de origem inferior exclusiva |
Valor devolvido
Devolve um bitmap recém-alocado com a região limitada não vazia, ou nil quando a imagem ou a geometria pedida não pode ser descodificada
Notas de utilização
- O chamador é proprietário de um bitmap devolvido não nulo e deve libertá-lo
- As coordenadas usam o espaço raster da imagem descodificada com origem no canto superior esquerdo, e os limites direito e inferior são exclusivos
- Os limites fora da imagem são ajustados (clamp) antes da descodificação
- JPEG 2000 requests the native decoder region before pixel expansion
- This method preserves the region's full decoded resolution
- Os restantes formatos de imagem suportados são descodificados normalmente e devolvem a região recortada exata
- O renderer de páginas carregadas usa automaticamente o overload com resolução para XObjects de imagem alinhados aos eixos que estejam recortados ou reduzidos