AddImageFromVariant

Gestione delle immagini

Descrizione

Aggiunge al documento selezionato un'immagine da un array di byte Variant

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

I tipi di file immagine supportati sono: BMP, TIFF, JPEG, PNG, GIF, WMF ed EMF

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

Sintassi

ActiveX

Function PDFlib::AddImageFromVariant(SourceData As Variant, Options As Long) As Long

Parametri

SourceData

Una variante contenente i dati dell'immagine

Options

Per le immagini TIFF multipagina questo parametro specifica il numero della pagina da caricare

Per le immagini PNG:

0 = Carica l'immagine normalmente

1 = Carica il canale alfa come immagine in scala di grigi

2 = Carica l'immagine e il canale alfa (limita l'alfa a 8 bit)

3 = Carica l'immagine (limita l'immagine a 8 bit/canale)

4 = Carica il canale alfa (limita a 8 bit/canale)

5 = Carica l'immagine con canale alfa (limita entrambi a 8 bit/canale)

6 = Carica l'immagine e il canale alfa

7 = Carica l'immagine e il profilo colore ICC

Per altri tipi di immagini questo parametro deve essere impostato su 0

L'impostazione di Options su -1 forza il caricamento delle immagini TIFF, EMF e WMF tramite la libreria grafica GDI+. È possibile caricare con GDI+ anche le immagini TIFF multipagina impostando il parametro Options su -PageNumber, ad esempio -3 per la pagina 3

Valori restituiti

0Impossibile aggiungere l'immagine
Non-zeroL'immagine è stata aggiunta correttamente Questo è l'ID della nuova immagine