AddImageFromString

Vaizdų apdorojimas

Aprašas

Šiame puslapyje aprašoma AddImageFromString funkcija PDFlibPas žinyne, skiltyje Vaizdų apdorojimas. API pavadinimai, parametrai, klasės, failai ir literalų reikšmės paliekami nepakeisti, kad atitiktų Delphi biblioteką ir DLL įėjimo taškus.

Kai vaizdas jau pridėtas į dokumentą, jį galima piešti bet kuriame puslapyje kelis kartus ir taip nedidinti PDF failo dydžio.

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š kviečiant šią funkciją galima iškviesti CompressImages, kad vaizdo duomenys būtų suspausti. Kiti vaizdų tipai suspaudžiami 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 Source yra vaizdo duomenis turinti eilutė. ActiveX bibliotekos versijoje šioje eilutėje turi būti 16 bitų simboliai, o bus naudojami tik kiekvieno simbolio apatiniai 8 bitai.

Options Kelių puslapių TIFF vaizdams šis parametras nurodo įkeliamo puslapio numerį. PNG vaizdams: 0 = įkelti vaizdą įprastai 1 = įkelti alfa kanalą kaip pilkų atspalvių vaizdą 2 = įkelti vaizdą ir alfa kanalą (apriboti alfa 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į Kitų tipų vaizdams šis parametras turi būti 0. Nustačius Options į -1, TIFF, EMF ir WMF vaizdai įkeliami naudojant GDI+ grafikos biblioteką. Kelių puslapių TIFF vaizdus taip pat galima įkelti naudojant GDI+, nustačius Options parametrą į -PageNumber (pavyzdžiui, -3 3-iajam puslapiui).

Source	`Source` yra vaizdo duomenis turinti eilutė. ActiveX bibliotekos versijoje šioje eilutėje turi būti 16 bitų simboliai, o bus naudojami tik kiekvieno simbolio apatiniai 8 bitai.
Options	Kelių puslapių TIFF vaizdams šis parametras nurodo įkeliamo puslapio numerį. PNG vaizdams: 0 = įkelti vaizdą įprastai 1 = įkelti alfa kanalą kaip pilkų atspalvių vaizdą 2 = įkelti vaizdą ir alfa kanalą (apriboti alfa 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į Kitų tipų vaizdams šis parametras turi būti 0. Nustačius `Options` į -1, TIFF, EMF ir WMF vaizdai įkeliami naudojant GDI+ grafikos biblioteką. Kelių puslapių TIFF vaizdus taip pat galima įkelti naudojant GDI+, nustačius `Options` parametrą į -PageNumber (pavyzdžiui, -3 3-iajam puslapiui).

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