CompressImages

Manipulação de imagens, Propriedades do documento

Descrição

Define o modo de compressão padrão aplicado aos dados de imagem raster brutos adicionados ao documento depois desta chamada. A configuração afeta imagens cujos pixels são enviados sem compressão (BMP, arrays brutos de pixels); imagens que já estão comprimidas (JPEG, JPEG 2000, CCITT, JBIG2) mantêm sua codificação existente e são armazenadas como estão, já que recomprimi-las inflaria o arquivo e degradaria a qualidade

Sintaxe

Delphi

Function TPDFlib.CompressImages(Compress: Integer): Integer;

ActiveX

Function PDFlib::CompressImages(Compress As Long) As Long

DLL

int DLCompressImages(int InstanceID, int Compress);

Parâmetros

Compress	0 — store raw raster images uncompressed. 1 — flate-compress raw raster images (`/FlateDecode` filter).

Valores retornados

0	O parâmetro Compress estava fora do intervalo.
1	A configuração de compressão de imagens foi atualizada.

Observações

A configuração só afeta imagens adicionadas depois da chamada. O padrão é comprimir. Desligar a compressão ocasionalmente é útil ao integrar com um renderer downstream que não suporta streams de imagem com FlateDecode; no uso normal, deixe a compressão habilitada.

A compressão Flate é sem perdas. Para compressão JPEG com perdas de uma imagem raster bruta, codifique a origem para JPEG antes de adicioná-la e use AddImageFromFile ou AddImageFromStream — o stream de bytes JPEG é então embutido diretamente com um filtro /DCTDecode.

Exemplo

// Compress raw bitmaps but leave the pre-encoded JPEG as-is
PDF.CompressImages(1);
PDF.AddImageFromFile('logo.bmp');        // BMP -> flate compressed
PDF.AddImageFromFile('photo.jpg');       // JPEG bytes embedded directly (DCT)
PDF.AddImageFromFile('chart.png');       // PNG decoded -> flate compressed

Veja também

CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream