AddImageFromStream

Vaizdų tvarkymas

Aprašymas

Prideda vaizdą iš TStream prie pasirinkto dokumento

Pridėtą vaizdą galima daug kartų atvaizduoti bet kuriame puslapyje, o PDF failo dydis dėl to daugiau nepadidėja

Palaikomi šie vaizdų failų tipai: BMP, TIFF, JPEG, PNG, GIF, WMF ir EMF.

PDF versijos elgsena: importuojant 16 bitų vienam komponentui vaizdo duomenis reikia PDF 1.5. Kai dokumentui nustatyta PDF 1.4 arba žemesnė versija ir saugojimo versija nėra užrakinta, AddImageFromStream automatiškai pakelia dokumentą iki PDF 1.5 ir įrašo 16-bit image samples į AutoBumpedFeatures. Jei iškviečiantis kodas užrakina žemesnę saugojimo versiją, suderinamumo tikrinimas atmeta įrašymą su LastErrorCode 602.

BMP ir TIFF vaizdams prieš iškviečiant šią funkciją galima iškviesti CompressImages, kad būtų suglaudinti vaizdo duomenys. Kitų tipų vaizdai suglaudinami automatiškai

Sintaksė

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametrai

InStream	Vaizdo duomenis laikantis TStream objektas. Dabartinė srauto padėtis ignoruojama, o vaizdo duomenys nuskaitomi nuo 0 padėties sraute
Options	Kelių puslapių TIFF vaizdams šis parametras nurodo įkeliamą puslapio numerį. PNG vaizdams: 0 = įkelti vaizdą įprastai 1 = įkelti alfa kanalą kaip pilkų atspalvių vaizdą 2 = įkelti vaizdą ir alfa kanalą (apriboti alfa kanalą iki 8 bitų) 3 = įkelti vaizdą (apriboti vaizdą iki 8 bitų vienam kanalui) 4 = įkelti alfa kanalą (apriboti iki 8 bitų vienam kanalui) 5 = įkelti vaizdą su alfa kanalu (apriboti abu iki 8 bitų vienam kanalui) 6 = įkelti vaizdą ir alfa kanalą 7 = įkelti vaizdą ir ICC spalvų profilį 8 = įkelti vaizdą, alfa kanalą ir ICC spalvų profilį, išsaugant didelį bitų gylį Kitų tipų vaizdams šis parametras turi būti 0. Nustačius Options į -1, TIFF, EMF ir WMF vaizdai priverstinai įkeliami naudojant GDI+ grafikos biblioteką. Kelių puslapių TIFF vaizdus taip pat galima įkelti naudojant GDI+, nustačius Options parametrą į -PageNumber (pavyzdžiui, -3 reiškia 3 puslapį)

InStream

Vaizdo duomenis laikantis TStream objektas. Dabartinė srauto padėtis ignoruojama, o vaizdo duomenys nuskaitomi nuo 0 padėties sraute

Options

Kelių puslapių TIFF vaizdams šis parametras nurodo įkeliamą puslapio numerį. PNG vaizdams: 0 = įkelti vaizdą įprastai 1 = įkelti alfa kanalą kaip pilkų atspalvių vaizdą 2 = įkelti vaizdą ir alfa kanalą (apriboti alfa kanalą iki 8 bitų) 3 = įkelti vaizdą (apriboti vaizdą iki 8 bitų vienam kanalui) 4 = įkelti alfa kanalą (apriboti iki 8 bitų vienam kanalui) 5 = įkelti vaizdą su alfa kanalu (apriboti abu iki 8 bitų vienam kanalui) 6 = įkelti vaizdą ir alfa kanalą 7 = įkelti vaizdą ir ICC spalvų profilį 8 = įkelti vaizdą, alfa kanalą ir ICC spalvų profilį, išsaugant didelį bitų gylį Kitų tipų vaizdams šis parametras turi būti 0. Nustačius Options į -1, TIFF, EMF ir WMF vaizdai priverstinai įkeliami naudojant GDI+ grafikos biblioteką. Kelių puslapių TIFF vaizdus taip pat galima įkelti naudojant GDI+, nustačius Options parametrą į -PageNumber (pavyzdžiui, -3 reiškia 3 puslapį)

Grąžinamos reikšmės

0	Nuskaitant iš srauto galiojančius vaizdo duomenis įvyko klaida; vaizdas sėkmingai pridėtas į dokumentą. Grąžinama reikšmė yra vaizdo ID, kurį galima naudoti su tokiomis vaizdų piešimo funkcijomis kaip DrawImage.
Non-zero