CompressImages

Gestione delle immagini, proprietà del documento

Descrizione

Imposta la modalità di compressione predefinita applicata ai dati di immagini raster non elaborati aggiunti al documento dopo questa chiamata. L'impostazione influisce sulle immagini i cui pixel vengono caricati senza compressione, come BMP e matrici di pixel non elaborati; le immagini già compresse, JPEG, JPEG 2000, CCITT e JBIG2, mantengono la codifica esistente e vengono memorizzate senza modifiche, poiché ricomprimerle aumenterebbe le dimensioni del file e ridurrebbe la qualità

Sintassi

Delphi

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

ActiveX

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

DLL

int DLCompressImages(int InstanceID, int Compress);

Parametri

Compress	0 — memorizza senza compressione le immagini raster non elaborate. 1 — comprime con flate le immagini raster non elaborate (filtro `/FlateDecode`).

Valori restituiti

0	Il parametro Compress era fuori intervallo
1	L'impostazione di compressione delle immagini è stata aggiornata

Note

L'impostazione influisce soltanto sulle immagini aggiunte dopo la chiamata. L'impostazione predefinita prevede la compressione. La disattivazione della compressione è occasionalmente utile durante l'integrazione con un renderer a valle che non supporta flussi di immagini decodificati con flate; nell'uso normale lasciare abilitata la compressione

La compressione Flate è senza perdita. Per JPEG con perdita, codificare prima il raster in JPEG e usare AddImageFromFile o AddImageFromStream — il flusso JPEG viene incorporato direttamente con /DCTDecode

Esempio

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

Vedere anche

CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream