ExternalizeInlineImages
Ottimizzazione dei documenti, gestione delle immagini, prestazioni
Descrizione
Individua nel contenuto delle pagine selezionate le immagini inline supportate identiche a livello di byte e sostituisce le relative definizioni ripetute da BI a EI con riferimenti a un unico Image XObject condiviso
Sintassi
Delphi
Function TPDFlib.ExternalizeInlineImages(Const PageRange: WideString= ''; MinimumOccurrences: Integer= 2): Integer;Parametri
| PageRange | Un intervallo di pagine in base 1, come 1,3,5-7, oppure una stringa vuota per tutte le pagine; i numeri di pagina duplicati vengono ignorati |
|---|---|
| MinimumOccurrences | Numero minimo di occorrenze esatte richiesto per la promozione, almeno 2 |
Valori restituiti
Numero di occorrenze inline sostituite oppure 0 senza gruppi idonei, intervallo non valido, minimo sotto 2 o annullamento
Note
Il raggruppamento comprende dimensioni, profondità di bit, flag di maschera e interpolazione, spazio colore, catena di filtri, parametri e array di decodifica e payload codificato, con indicizzazione SHA-256 seguita da confronto esatto
Sono supportate immagini DeviceGray, DeviceRGB e DeviceCMYK dirette e maschere stencil; spazi denominati o complessi e voci inline sconosciute restano invariati
Filtri e parametri di decodifica esistenti vengono conservati; un payload non filtrato viene compresso con Flate soltanto se la rappresentazione è più piccola
Un gruppo viene promosso soltanto se la stima conservativa, inclusi XObject immagine, risorse pagina e istruzioni sostitutive, è minore degli span inline originali
L'operazione segnala avanzamento di raccolta e applicazione, risponde a Abort tra pagine, ripristina la pagina precedente ed è idempotente
L'annullamento durante la raccolta non apporta modifiche; l'annullamento durante l'applicazione conserva le pagine già completate
Esempio
ReplacedImages:= PDF.ExternalizeInlineImages('1-200', 3);
Writeln(ReplacedImages);