AddImageFromString

Práca s obrázkami

Opis

Pridáva obrázok z pamäte do vybraného dokumentu

Keď sa obrázok pridá do dokumentu, možno ho na ľubovoľnej stránke vykresliť viackrát bez ďalšieho zväčšenia veľkosti súboru PDF

Podporované typy obrazových súborov sú: BMP, TIFF, JPEG, PNG, GIF, WMF a EMF

Správanie verzie PDF: import obrazových dát s 16 bitmi na komponent vyžaduje PDF 1.5. Keď je dokument nastavený na PDF 1.4 alebo nižšiu verziu a verzia uloženia nie je uzamknutá, AddImageFromString automaticky zvýši dokument na PDF 1.5 a zaznamená 16-bit image samples do AutoBumpedFeatures. Ak volajúci uzamkne nižšiu verziu uloženia, kontrola kompatibility odmietne uloženie s LastErrorCode 602

Pre obrázky BMP a TIFF možno pred volaním tejto funkcie zavolať funkciu CompressImages na kompresiu obrazových dát. Ostatné typy obrázkov sa komprimujú automaticky

Syntax

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parametre

Source	Reťazec obsahujúci obrazové dáta. V ActiveX verzii knižnice musí tento reťazec obsahovať 16-bitové znaky, použijú sa iba dolné 8 bity každého znaku
Options	Pre viacstranové TIFF obrázky tento parameter určuje číslo stránky, ktorá sa má načítať. Pre PNG obrázky: 0 = Načíta obrázok ako zvyčajne 1 = Načíta alfa kanál ako sivotónový obrázok 2 = Načíta obrázok a alfa kanál (obmedzí alfu na 8 bitov) 3 = Načíta obrázok (obmedzí obrázok na 8 bitov na kanál) 4 = Načíta alfa kanál (obmedzí na 8 bitov na kanál) 5 = Načíta obrázok s alfa kanálom (obmedzí obe na 8 bitov na kanál) 6 = Načíta obrázok a alfa kanál 7 = Načíta obrázok a ICC farebný profil. Pre ostatné typy obrázkov by mal byť tento parameter nastavený na 0. Nastavenie Options na -1 vynúti načítanie obrázkov TIFF, EMF a WMF pomocou grafickej knižnice GDI+. Viacstranové TIFF obrázky možno tiež načítať pomocou GDI+ nastavením parametra Options na -PageNumber (napríklad -3 pre stranu 3)

Source

Reťazec obsahujúci obrazové dáta. V ActiveX verzii knižnice musí tento reťazec obsahovať 16-bitové znaky, použijú sa iba dolné 8 bity každého znaku

Options

Pre viacstranové TIFF obrázky tento parameter určuje číslo stránky, ktorá sa má načítať. Pre PNG obrázky: 0 = Načíta obrázok ako zvyčajne 1 = Načíta alfa kanál ako sivotónový obrázok 2 = Načíta obrázok a alfa kanál (obmedzí alfu na 8 bitov) 3 = Načíta obrázok (obmedzí obrázok na 8 bitov na kanál) 4 = Načíta alfa kanál (obmedzí na 8 bitov na kanál) 5 = Načíta obrázok s alfa kanálom (obmedzí obe na 8 bitov na kanál) 6 = Načíta obrázok a alfa kanál 7 = Načíta obrázok a ICC farebný profil. Pre ostatné typy obrázkov by mal byť tento parameter nastavený na 0. Nastavenie Options na -1 vynúti načítanie obrázkov TIFF, EMF a WMF pomocou grafickej knižnice GDI+. Viacstranové TIFF obrázky možno tiež načítať pomocou GDI+ nastavením parametra Options na -PageNumber (napríklad -3 pre stranu 3)

Návratové hodnoty

0	Obrazové dáta boli neplatné alebo bol obrázok v nepodporovanom formáte
1	Obrázok bol úspešne pridaný. Vrátenou hodnotou je ImageID, ktoré možno použiť s funkciami ako SelectImage a DrawImage