AddImageJBIG2FromFileEx
Immagini
Descrizione
Carica un file bitmap, lo converte in dati immagine monocromatici e lo memorizza come un Image XObject JBIG2 utilizzando parametri opzionali con nome
Sintassi
Delphi
Function TPDFlib.AddImageJBIG2FromFileEx(Const FileName: WideString; Interpolate, SymbolExtract, UseExternalEncoder, SkipBlackDots, BlackDotSize, LossyLevel: Integer): Integer;
Parametri
| FileName | Il file bitmap da codificare |
|---|---|
| Interpolate | Scrive il flag di interpolazione dell'immagine quando è diverso da zero |
| SymbolExtract | Richiede l'estrazione del dizionario dei simboli quando il backend del codificatore attivo lo supporta |
| UseExternalEncoder | Preferisce il backend del codificatore JBIG2 esterno quando disponibile |
| SkipBlackDots | Abilita la pulizia dei punti neri isolati prima della codifica se diverso da zero |
| BlackDotSize | Dimensione massima del cluster di pixel neri isolati rimossa durante la pulizia |
| LossyLevel | Suggerimento sull'aggressività della pulizia da 0 a 9 per l'input monocromatico scansionato |
Valori restituiti
Restituisce il nuovo ImageID, oppure 0 quando il file non può essere letto o codificato
Note
La funzione mappa i parametri nominati sullo stesso percorso di codifica usato da AddImageJBIG2FromFile, preservando la compatibilità con le maschere di bit delle opzioni esistenti
Registrazione dei backend JBIG2
Sia l'encoder alla base della famiglia AddImageJBIG2* sia il decoder usato per le immagini JBIG2 nei documenti importati sono sostituibili. L'unità PDFlibJBIG2Enc espone la superficie di registrazione come funzioni autonome:
RegisterJBIG2EncoderBackend | Installa un TJBIG2EncodeCallback che riceve le scanline, la larghezza, l'altezza e un record TJBIG2EncodeOptions e restituisce i dati immagine compressi con i dati facoltativi del segmento globale; soddisfa la richiesta UseExternalEncoder fatta tramite l'opzione seguente |
|---|---|
RegisterJBIG2DecoderBackend | Installa il TJBIG2DecodeCallback primario, che riceve i byte dei dati dell'immagine e globali e compila un record TJBIG2DecodeResult |
RegisterJBIG2ExternalDecoderBackend | Registra il backend di decodifica esterno (il decoder C jbig2dec su Win64). Se registrato e con l'interruttore prefer-external attivo (predefinito), il percorso di caricamento /JBIG2Decode passa da esso e il decoder primario resta la riserva |
ClearJBIG2Backends | Rimuove ogni callback di codifica e decodifica registrato |
IsJBIG2EncoderBackendAvailable / IsJBIG2DecoderBackendAvailable / IsJBIG2ExternalDecoderBackendAvailable | Segnalano se il callback corrispondente è attualmente registrato |
SetPreferExternalJBIG2Decoder / GetPreferExternalJBIG2Decoder | Interruttore globale che sceglie il decoder esterno rispetto al decoder Pascal integrato quando entrambi sono disponibili; il valore predefinito è True, impostare False per forzare il ripiego nativo |
DefaultJBIG2EncodeOptions | Restituisce un record TJBIG2EncodeOptions inizializzato con i valori predefiniti da cui partono le chiamate AddImageJBIG2* (senza perdita, dizionario di simboli attivo, segmenti globali disattivati, encoder esterno preferito) |
ClearJBIG2DecodeResult | Rilascia la memoria delle scanline posseduta da un record TJBIG2DecodeResult e ne azzera i campi |