AddImageFromString

Bildehåndtering

Beskrivelse

Legger til et bilde fra minnet i det valgte dokumentet

Når et bilde er lagt til dokumentet, kan det tegnes på vilkårlige sider så mange ganger som ønsket uten at PDF-filen vokser mer

Støttede bildefiltyper er BMP, TIFF, JPEG, PNG, GIF, WMF, EMF og WebP, pluss AVIF, HEIF, HEIC og JPEG XL når en moderne bildedekoder er tilgjengelig

PDF-versjonsoppførsel: import av bildedata med 16 bit per komponent krever PDF 1.5. Når et dokument er satt til PDF 1.4 eller lavere og lagringsversjonen ikke er låst, hever AddImageFromString automatisk dokumentet til PDF 1.5 og registrerer 16-bit image samples i AutoBumpedFeatures. Hvis kalleren låser en lavere lagringsversjon, avslår kompatibilitetsporten lagringen med LastErrorCode 602

For BMP- og TIFF-bilder kan CompressImages-funksjonen kalles før denne funksjonen for å komprimere bildedataene. Andre bildetyper komprimeres automatisk

Syntaks

Delphi

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

DLL

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

Parametere

Source	En streng som inneholder bildedataene. I ActiveX-versjonen av biblioteket må denne strengen inneholde 16-bit tegn; bare de laveste 8 bitene av hvert tegn brukes
Options	For TIFF-bilder med flere sider angir denne parameteren sidenummeret som skal lastes inn. For PNG-bilder: 0 = Last inn bildet som vanlig 1 = Last inn alfakanalen som et gråtonsbilde 2 = Last inn bildet og alfakanalen (begrens alfakanalen til 8-bit) 3 = Last inn bildet (begrens bildet til 8 bit/kanal) 4 = Last inn alfakanalen (begrens til 8 bit/kanal) 5 = Last inn bildet med alfakanal (begrens begge til 8 bit/kanal) 6 = Last inn bildet og alfakanalen 7 = Last inn bildet og ICC-fargeprofilen 8 = Last inn bildet, alfakanalen og ICC-fargeprofilen med bevart høy bitdybde For andre bildetyper skal denne parameteren settes til 0. Å sette Options til -1 tvinger TIFF-, EMF- og WMF-bilder til å lastes inn med GDI+-grafikkbiblioteket. TIFF-bilder med flere sider kan også lastes inn med GDI+ ved å sette Options-parameteren til -PageNumber (for eksempel -3 for side 3)

Source

En streng som inneholder bildedataene. I ActiveX-versjonen av biblioteket må denne strengen inneholde 16-bit tegn; bare de laveste 8 bitene av hvert tegn brukes

Options

For TIFF-bilder med flere sider angir denne parameteren sidenummeret som skal lastes inn. For PNG-bilder: 0 = Last inn bildet som vanlig 1 = Last inn alfakanalen som et gråtonsbilde 2 = Last inn bildet og alfakanalen (begrens alfakanalen til 8-bit) 3 = Last inn bildet (begrens bildet til 8 bit/kanal) 4 = Last inn alfakanalen (begrens til 8 bit/kanal) 5 = Last inn bildet med alfakanal (begrens begge til 8 bit/kanal) 6 = Last inn bildet og alfakanalen 7 = Last inn bildet og ICC-fargeprofilen 8 = Last inn bildet, alfakanalen og ICC-fargeprofilen med bevart høy bitdybde For andre bildetyper skal denne parameteren settes til 0. Å sette Options til -1 tvinger TIFF-, EMF- og WMF-bilder til å lastes inn med GDI+-grafikkbiblioteket. TIFF-bilder med flere sider kan også lastes inn med GDI+ ved å sette Options-parameteren til -PageNumber (for eksempel -3 for side 3)

Returverdier

0	Bildedataene var ugyldige, eller bildet var i et ustøttet format Bildet ble lagt til. Den returnerte verdien er ImageID-en som kan brukes med funksjoner som SelectImage og DrawImage
1