AddImageFromString

Obdelava slik

Opis

Doda sliko iz pomnilnika 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, AddImageFromString 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parametri

Source	Niz, ki vsebuje slikovne podatke. V različici knjižnice ActiveX mora ta niz vsebovati 16-bitne znake, uporabiti se bodo le spodnjih 8 bitov vsakega znaka
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)

Source

Niz, ki vsebuje slikovne podatke. V različici knjižnice ActiveX mora ta niz vsebovati 16-bitne znake, uporabiti se bodo le spodnjih 8 bitov vsakega znaka

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	Slikovni podatki so bili neveljavni ali pa je bila slika v nepodprtem formatu. Slika je bila uspešno dodana. Vrnjena vrednost je ImageID, ki ga je mogoče uporabiti s funkcijami, kot sta SelectImage in DrawImage
1