AddImageFromStream

Bildehåndtering

Beskrivelse

Legger til et bilde fra en TStream 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 AddImageFromStream 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametere

InStream	TStream-objektet som inneholder bildedataene. Gjeldende posisjon i strømmen ignoreres; bildedata leses fra posisjon 0 i strømmen
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)

InStream

TStream-objektet som inneholder bildedataene. Gjeldende posisjon i strømmen ignoreres; bildedata leses fra posisjon 0 i strømmen

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	Det oppsto en feil ved lesing av gyldige bildedata fra strømmen Bildet ble lagt til dokumentet. Den returnerte verdien er bildets ID som kan brukes med bildetegnefunksjonene som DrawImage
Non-zero