AddImageFromVariant

Billedhåndtering

Beskrivelse

Føjer et billede fra et variant-bytearray til det valgte dokument.

Når et billede er tilføjet dokumentet, kan det tegnes flere gange på enhver side uden yderligere at øge PDF-filens størrelse.

Understøttede billedfiltyper er: BMP, TIFF, JPEG, PNG, GIF, WMF og EMF.

For BMP- og TIFF-billeder kan funktionen CompressImages kaldes før denne funktion for at komprimere billeddataene. Andre billedtyper komprimeres automatisk.

Syntaks

ActiveX

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

Parametre

SourceData

En variant, der indeholder billeddataene

Options

For TIFF-billeder med flere sider angiver denne parameter det sidenummer, der skal indlæses.

For PNG-billeder:

0 = Indlæs billedet som normalt

1 = Indlæs alfakanalen som et gråtonebillede

2 = Indlæs billedet og alfakanalen (begræns alfa til 8-bit)

3 = Indlæs billedet (begræns billedet til 8-bit/kanal)

4 = Indlæs alfakanalen (begræns til 8 bit/kanal)

5 = Indlæs billedet med alfakanal (begræns begge til 8 bit/kanal)

6 = Indlæs billedet og alfakanalen

7 = Indlæs billedet og ICC-farveprofilen

For andre billedtyper skal denne parameter angives til 0.

Hvis Options angives til -1, gennemtvinges indlæsning af TIFF-, EMF- og WMF-billeder med grafikbiblioteket GDI+. TIFF-billeder med flere sider kan også indlæses med GDI+ ved at angive parameteren Options til -PageNumber (f.eks. -3 for side 3).

Returværdier

0Billedet kunne ikke tilføjes
Non-zeroBilledet blev tilføjet. Dette er ID'et for det nye billede.