AddImageFromFileOffsetA

Billedhåndtering

Beskrivelse

Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med AddImageFromFileOffset, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel

Føjer et billede fra en del af en fil til det valgte dokument.

Hvis mange billeder for eksempel er sammenkædet i én fil, gør denne funktion det muligt at udtrække de enkelte billeder og føje dem til dokumentet

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.

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 AddImageFromFileOffset 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 DLAddImageFromFileOffsetA(InstanceID: Integer; FileName: PAnsiChar; Offset, DataLength, Options: Integer): Integer;

DLL

int DLAddImageFromFileOffsetA(int InstanceID, const char * FileName, int Offset, int DataLength, int Options);

Parametre

FileName	Navnet på den fil, der indeholder billederne.
Offset	Forskydningen i filen, hvor det ønskede billede begynder. Filens første byte har forskydningen 0.
DataLength	Billeddataenes længde i byte
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

0	Billedet kunne ikke læses fra filen. Det kan skyldes ugyldige billeddata, eller at filen ikke blev fundet
Non-zero	Billedet blev læst fra filen og føjet til dokumentet. Den returnerede værdi er billedets ID, som kan bruges med billedtegnefunktioner såsom DrawImage.