AddImageFromString
Gestione delle immagini
Descrizione
Aggiunge al documento selezionato un'immagine dalla memoria
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, AddImageFromString 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;DLL
int DLAddImageFromString(int InstanceID, const char * Source, int Options);Parametri
| Source | Stringa con dati immagine. In ActiveX deve contenere caratteri a 16 bit, dei quali vengono usati soltanto gli 8 bit inferiori. |
|---|---|
| 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 | Dati immagine non validi o formato non supportato L'immagine è stata aggiunta correttamente. Il valore è ImageID, usabile con SelectImage e DrawImage |
|---|---|
| 1 |