AddAlternateImage
Gestione delle immagini, contenuto facoltativo
Descrizione
Aggiunge o aggiorna una rappresentazione alternativa di un XObject immagine di base secondo ISO 32000-1 §8.9.5.4
Immagini alternative possono fornire una versione di stampa ad alta risoluzione o controllata dal contenuto facoltativo senza duplicare il contenuto pagina
Sintassi
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Parametri
| BaseImageID | L'immagine usata dalle risorse di pagina e dagli operatori Do del flusso di contenuto |
|---|---|
| AlternateImageID | L'XObject immagine da associare come variante |
| DefaultForPrinting | Contrassegna la variante come immagine di stampa preferita e cancella il flag dalle altre varianti |
| OptionalContentID | Handle OCG o OCMD facoltativo che controlla la selezione della variante oppure 0 senza condizione |
Valore restituito
Restituisce l'indice alternativo in base 1, incluso l'indice esistente quando viene aggiornata la stessa immagine, oppure 0 quando la convalida non riesce
Note
L'immagine di base e quella alternativa devono essere oggetti immagine diversi nel documento selezionato
Un'immagine già usata come alternativa non può possedere /Alternates e un'immagine che possiede alternative non può essere associata come alternativa
Passare OCG o OCMD porta la versione minima a PDF 1.5; altrimenti resta PDF 1.3
Tutte le modalità PDF/A rifiutano l'operazione perché ISO 19005 vieta /Alternates nei dizionari immagine
Quando l'immagine di base contiene una voce /OC, il renderer incorporato mostra la base mentre è visibile; in caso contrario seleziona la prima alternativa visibile la cui voce contiene /OC
Esempio
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Vedere anche
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo