CompressImages

Tratamiento de imágenes, propiedades del documento

Descripción

Establece el modo de compresión predeterminado que se aplica a los datos de imágenes ráster sin procesar añadidos al documento después de esta llamada. La configuración afecta a las imágenes cuyos píxeles se cargan sin comprimir (BMP, arrays de píxeles sin procesar); las imágenes ya comprimidas (JPEG, JPEG 2000, CCITT, JBIG2) conservan su codificación y se almacenan tal cual, ya que volver a comprimirlas aumentaría el archivo y reduciría la calidad

Sintaxis

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 — almacena sin comprimir las imágenes ráster sin procesar. 1 — comprime mediante Flate las imágenes ráster sin procesar (filtro `/FlateDecode`)

Valores devueltos

0	El parámetro Compress estaba fuera de intervalo
1	Se actualizó el ajuste de compresión de imágenes

Observaciones

La configuración solo afecta a las imágenes añadidas después de la llamada. El comportamiento predeterminado es comprimir. Desactivar la compresión puede resultar útil ocasionalmente al integrar un motor de renderizado posterior que no admita flujos de imágenes descodificados con Flate; para un uso normal, mantenga la compresión activada

Flate no tiene pérdidas. Para JPEG con pérdidas, codifique antes y use AddImageFromFile o AddImageFromStream; el flujo se incrusta con /DCTDecode

Ejemplo

// 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

Véase también

CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream