AddImageFromFile

Obdelava slik

Opis

Doda sliko iz datoteke v izbran dokument

Ko je slika dodana v dokument, jo je mogoče na katerikoli strani večkrat narisati brez nadaljnjega povečevanja velikosti datoteke PDF

Podprte vrste slikovnih datotek so: BMP, TIFF, JPEG, PNG, GIF, WMF in EMF

Vedenje glede različice PDF: uvoz slikovnih podatkov z 16 bitov na komponento zahteva PDF 1.5. Ko je dokument nastavljen na PDF 1.4 ali nižje in različica shranjevanja ni zaklenjena, AddImageFromFile samodejno dvigne dokument na PDF 1.5 in zabeleži 16-bit image samples v AutoBumpedFeatures. Če klicatelj zaklene nižjo različico shranjevanja, združljivostni nadzor zavrne shranjevanje z LastErrorCode 602

Pri slikah BMP in TIFF lahko funkcijo CompressImages pokličete pred tem klicem, da stisnete slikovne podatke. Druge vrste slik se stisnejo samodejno

Sintaksa

Delphi

Function TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parametri

FileName	Ime datoteke s slike, ki jo želite dodati
Options	Za večstranske slike TIFF ta parameter določa številko strani, ki jo je treba naložiti. Za slike PNG: 0 = Naloži sliko kot običajno 1 = Naloži kanal alfa kot sivinsko sliko 2 = Naloži sliko in kanal alfa (omeji alfa na 8 bitov) 3 = Naloži sliko (omeji sliko na 8 bitov/kanal) 4 = Naloži kanal alfa (omeji na 8 bitov/kanal) 5 = Naloži sliko s kanalom alfa (omeji oba na 8 bitov/kanal) 6 = Naloži sliko in kanal alfa 7 = Naloži sliko in barvni profil ICC. Za druge vrste slik je treba ta parameter nastaviti na 0. Če Options nastavite na -1, se slike TIFF, EMF in WMF naložijo s knjižnico grafike GDI+. Večstranske slike TIFF lahko naložite tudi z GDI+ tako, da parameter Options nastavite na -PageNumber (na primer -3 za stran 3)

FileName

Ime datoteke s slike, ki jo želite dodati

Options

Za večstranske slike TIFF ta parameter določa številko strani, ki jo je treba naložiti. Za slike PNG: 0 = Naloži sliko kot običajno 1 = Naloži kanal alfa kot sivinsko sliko 2 = Naloži sliko in kanal alfa (omeji alfa na 8 bitov) 3 = Naloži sliko (omeji sliko na 8 bitov/kanal) 4 = Naloži kanal alfa (omeji na 8 bitov/kanal) 5 = Naloži sliko s kanalom alfa (omeji oba na 8 bitov/kanal) 6 = Naloži sliko in kanal alfa 7 = Naloži sliko in barvni profil ICC. Za druge vrste slik je treba ta parameter nastaviti na 0. Če Options nastavite na -1, se slike TIFF, EMF in WMF naložijo s knjižnico grafike GDI+. Večstranske slike TIFF lahko naložite tudi z GDI+ tako, da parameter Options nastavite na -PageNumber (na primer -3 za stran 3)

Vrnjene vrednosti

0	Slike ni bilo mogoče dodati. Morda je ni bilo mogoče najti ali pa je v nepodprtem formatu
Non-zero	Slika je bila uspešno dodana. Vrne se ImageID, ki ga je mogoče posredovati funkcijam, kot sta SelectImage in DrawImage