AddImageFromString

Vaizdų tvarkymas

Aprašymas

Prideda vaizdą iš atminties 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, AddImageFromString 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parametrai

Source	Eilutė, kurioje yra vaizdo duomenys. Bibliotekos ActiveX versijoje ši eilutė turi būti sudaryta iš 16 bitų simbolių, tačiau naudojami tik kiekvieno simbolio apatiniai 8 bitai
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į)

Source

Eilutė, kurioje yra vaizdo duomenys. Bibliotekos ActiveX versijoje ši eilutė turi būti sudaryta iš 16 bitų simbolių, tačiau naudojami tik kiekvieno simbolio apatiniai 8 bitai

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	Vaizdo duomenys buvo neteisingi arba vaizdas buvo nepalaikomo formato. Vaizdas sėkmingai pridėtas. Grąžinama reikšmė yra ImageID, kurį galima naudoti su tokiomis funkcijomis kaip SelectImage ir DrawImage.
1