AddImageFromString

Billedhåndtering

Beskrivelse

Føjer et billede fra hukommelsen 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, EMF og WebP samt AVIF, HEIF, HEIC og JPEG XL, når en moderne billeddekoder er tilgængelig

PDF-versionsadfærd: Import af billeddata med 16 bit pr. komponent kræver PDF 1.5. Når et dokument er indstillet til PDF 1.4 eller lavere, og lagringsversionen ikke er låst, hæver AddImageFromString automatisk dokumentet til PDF 1.5 og registrerer 16-bit image samples i AutoBumpedFeatures. Hvis kalderen låser en lavere lagringsversion, afviser kompatibilitetskontrollen lagringen med LastErrorCode 602

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

Syntaks

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

Parametre

Source	En streng, som indeholder billeddataene. I ActiveX-versionen af biblioteket skal denne streng indeholde 16-bit-tegn; kun de nederste 8 bit af hvert tegn bruges
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 8 = Indlæs billedet, alfakanalen og ICC-farveprofilen, mens høj bitdybde bevares For andre billedtyper skal denne parameter sættes til 0. Hvis Options sættes til -1, tvinges TIFF-, EMF- og WMF-billeder til at blive indlæst med grafikbiblioteket GDI+. TIFF-billeder med flere sider kan også indlæses med GDI+ ved at sætte parameteren Options til -PageNumber (for eksempel -3 for side 3).

Source

En streng, som indeholder billeddataene. I ActiveX-versionen af biblioteket skal denne streng indeholde 16-bit-tegn; kun de nederste 8 bit af hvert tegn bruges

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 8 = Indlæs billedet, alfakanalen og ICC-farveprofilen, mens høj bitdybde bevares For andre billedtyper skal denne parameter sættes til 0. Hvis Options sættes til -1, tvinges TIFF-, EMF- og WMF-billeder til at blive indlæst med grafikbiblioteket GDI+. TIFF-billeder med flere sider kan også indlæses med GDI+ ved at sætte parameteren Options til -PageNumber (for eksempel -3 for side 3).

Returværdier

0	Billeddataene var ugyldige, eller billedet havde et format, der ikke understøttes Billedet blev tilføjet korrekt. Den returnerede værdi er ImageID, som kan bruges med funktioner såsom SelectImage og DrawImage.
1