AddImageFromFileOffset

Vaizdų apdorojimas

Aprašas

Šiame puslapyje aprašoma AddImageFromFileOffset 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.

Pavyzdžiui, jei į vieną failą sujungta daug vaizdų, ši funkcija leidžia atskirus vaizdus išskirti ir pridėti į dokumentą.

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, AddImageFromFileOffset 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.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Parametrai

FileName	`FileName` nurodo failo kelią arba failo pavadinimą. Naudokite galiojantį dabartinės darbo eigos kelią ir išlaikykite API tikėtiną kodavimą.
Offset	`Offset` nurodo poslinkį faile, nuo kurio prasideda reikiamas vaizdas. Pirmas failo baitas turi 0 poslinkį.
DataLength	`DataLength` yra vaizdo duomenų ilgis baitais.
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 nepavyko nuskaityti iš failo. Tai gali reikšti neteisingus vaizdo duomenis arba tai, kad failas nerastas.
Non-zero	Vaizdas buvo nuskaitytas iš failo ir sėkmingai pridėtas į dokumentą. Grąžinama reikšmė yra vaizdo ID, kurį galima naudoti su vaizdų piešimo funkcijomis, tokiomis kaip DrawImage.