AddImageFromString

Obrada slika

Opis

Dodaje sliku iz memorije 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, AddImageFromString 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

Parametri

Source	Niz koji sadrži podatke slike. U ActiveX verziji biblioteke ovaj niz mora sadržavati 16-bitne znakove, upotrijebit će se samo nižih 8 bitova svakog znaka
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)

Source

Niz koji sadrži podatke slike. U ActiveX verziji biblioteke ovaj niz mora sadržavati 16-bitne znakove, upotrijebit će se samo nižih 8 bitova svakog znaka

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	Podaci slike nisu valjani ili je slika u nepodržanom formatu
1	Slika je uspješno dodana. Vraćena vrijednost je ImageID koji se može koristiti s funkcijama kao što su SelectImage i DrawImage