AddImageFromStream

Práca s obrázkami

Opis

Pridáva obrázok z TStream 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á, AddImageFromStream 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametre

InStream	Objekt TStream obsahujúci obrazové dáta. Aktuálna pozícia v streame sa ignoruje, obrazové dáta sa budú čítať od pozície 0 v streame
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)

InStream

Objekt TStream obsahujúci obrazové dáta. Aktuálna pozícia v streame sa ignoruje, obrazové dáta sa budú čítať od pozície 0 v streame

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	Pri čítaní platných obrazových dát zo streamu nastala chyba. Obrázok sa nepodarilo pridať do dokumentu
Non-zero	Obrázok bol úspešne pridaný do dokumentu. Vrátená hodnota je ID obrázka, ktoré možno použiť s funkciami na kreslenie obrázkov, ako je DrawImage