AddImageFromFileOffset

Image handling

Beskrivelse

Legger til et bilde fra en del av en fil i det valgte dokumentet

Hvis for eksempel mange bilder er slått sammen til én fil, lar denne funksjonen de enkelte bildene trekkes ut og legges til 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 og EMF

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 AddImageFromFileOffset 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.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Parametere

FileName	Navnet på filen som inneholder bildene
Offset	Forskyvningen inn i filen der ønsket bilde starter. Den første byten i filen har forskyvning 0
DataLength	Lengden på bildedataene i bytes
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 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	Bildet kunne ikke leses fra filen. Dette kan tyde på ugyldige bildedata, eller at filen ikke ble funnet
Non-zero	Bildet ble lest fra filen og lagt til dokumentet. Den returnerte verdien er bildets ID, som kan brukes med bildetegnefunksjonene som DrawImage