AddImageFromFile

Gestione delle immagini

Descrizione

Aggiunge al documento selezionato un'immagine da un file

Dopo l'aggiunta al documento, un'immagine può essere disegnata più volte su qualsiasi pagina senza aumentare ulteriormente le dimensioni del PDF.

Tipi immagine supportati: BMP, TIFF, JPEG, PNG, GIF, WMF, EMF e WebP, più AVIF, HEIF, HEIC e JPEG XL con decoder moderno disponibile

Comportamento della versione PDF: l'importazione di dati immagine a 16 bit per componente richiede PDF 1.5. Quando un documento è impostato su PDF 1.4 o precedente e la versione di salvataggio non è bloccata, AddImageFromFile porta automaticamente il documento a PDF 1.5 e registra 16-bit image samples in AutoBumpedFeatures. Se il chiamante blocca una versione di salvataggio precedente, il controllo di compatibilità rifiuta il salvataggio con LastErrorCode 602

Per immagini BMP e TIFF è possibile chiamare CompressImages prima di questa funzione. Gli altri tipi vengono compressi automaticamente.

Sintassi

Delphi

Function TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parametri

FileName	Il nome del file immagine da aggiungere
Options	Per TIFF multipagina specifica la pagina. Per PNG: 0 = Normale 1 = Alfa come grigio 2 = Immagine e alfa (8 bit) 3 = Immagine (8 bit/canale) 4 = Alfa (8 bit/canale) 5 = Immagine con alfa (entrambi 8 bit) 6 = Immagine e alfa 7 = Immagine e profilo ICC 8 = Immagine, alfa e ICC ad alta profondità. Per altri tipi usare 0. Options -1 forza GDI+ per TIFF, EMF e WMF; per TIFF multipagina usare -PageNumber, ad esempio -3

FileName

Il nome del file immagine da aggiungere

Options

Per TIFF multipagina specifica la pagina. Per PNG: 0 = Normale 1 = Alfa come grigio 2 = Immagine e alfa (8 bit) 3 = Immagine (8 bit/canale) 4 = Alfa (8 bit/canale) 5 = Immagine con alfa (entrambi 8 bit) 6 = Immagine e alfa 7 = Immagine e profilo ICC 8 = Immagine, alfa e ICC ad alta profondità. Per altri tipi usare 0. Options -1 forza GDI+ per TIFF, EMF e WMF; per TIFF multipagina usare -PageNumber, ad esempio -3

Valori restituiti

0	Impossibile aggiungere l'immagine. Non è stata trovata oppure usa un formato non supportato
Non-zero	L'immagine è stata aggiunta correttamente. Viene restituito ImageID, che può essere passato a funzioni come SelectImage e DrawImage.