AddImageFromFile

Obrada slika

Opis

Dodaje sliku iz datoteke u odabrani dokument

Nakon što je slika dodana u dokument, može se crtati na bilo kojoj stranici više puta bez daljnjeg povećavanja veličine PDF datoteke

Podržane vrste slikovnih datoteka su: BMP, TIFF, JPEG, PNG, GIF, WMF i EMF

Ponašanje ovisno o verziji PDF-a: uvoz podataka slike s 16 bitova po komponenti zahtijeva PDF 1.5. Kada je dokument postavljen na PDF 1.4 ili niže i verzija spremanja nije zaključana, AddImageFromFile automatski podiže dokument na PDF 1.5 i zapisuje 16-bit image samples u AutoBumpedFeatures. Ako pozivatelj zaključa nižu verziju spremanja, provjera kompatibilnosti odbija spremanje s LastErrorCode 602

Za BMP i TIFF slike funkciju CompressImages možete pozvati prije ove funkcije kako biste komprimirali podatke slike. Druge vrste slika automatski se komprimiraju

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	Naziv datoteke slike koju treba dodati
Options	Za višestrani TIFF ovaj parametar određuje broj stranice koju treba učitati. Za PNG slike: 0 = Učitaj sliku kao i obično 1 = Učitaj alfa kanal kao sivu sliku 2 = Učitaj sliku i alfa kanal (ograniči alfa na 8-bitni) 3 = Učitaj sliku (ograniči sliku na 8-bitno po kanalu) 4 = Učitaj alfa kanal (ograniči na 8-bitno po kanalu) 5 = Učitaj sliku s alfa kanalom (ograniči oba na 8-bitno po kanalu) 6 = Učitaj sliku i alfa kanal 7 = Učitaj sliku i ICC profil boja Za druge vrste slika ovaj parametar treba postaviti na 0. Postavljanje Options na -1 prisiljava TIFF, EMF i WMF slike da se učitaju pomoću grafičke biblioteke GDI+. Višestrani TIFF može se također učitati pomoću GDI+ postavljanjem parametra Options na -PageNumber (na primjer -3 za stranicu 3)

FileName

Naziv datoteke slike koju treba dodati

Options

Za višestrani TIFF ovaj parametar određuje broj stranice koju treba učitati. Za PNG slike: 0 = Učitaj sliku kao i obično 1 = Učitaj alfa kanal kao sivu sliku 2 = Učitaj sliku i alfa kanal (ograniči alfa na 8-bitni) 3 = Učitaj sliku (ograniči sliku na 8-bitno po kanalu) 4 = Učitaj alfa kanal (ograniči na 8-bitno po kanalu) 5 = Učitaj sliku s alfa kanalom (ograniči oba na 8-bitno po kanalu) 6 = Učitaj sliku i alfa kanal 7 = Učitaj sliku i ICC profil boja Za druge vrste slika ovaj parametar treba postaviti na 0. Postavljanje Options na -1 prisiljava TIFF, EMF i WMF slike da se učitaju pomoću grafičke biblioteke GDI+. Višestrani TIFF može se također učitati pomoću GDI+ postavljanjem parametra Options na -PageNumber (na primjer -3 za stranicu 3)

Povratne vrijednosti

0	Slika nije mogla biti dodana. Ili nije pronađena ili je u nepodržanom formatu
Non-zero	Slika je dodana uspješno. Vraća se ImageID koji se može proslijediti funkcijama kao što su SelectImage i DrawImage