AddImageFromFileOffset

Képkezelés

Leírás

Képet ad hozzá egy fájl egy részéből a kijelölt dokumentumhoz

Például ha sok képet egyetlen fájlba fűztek, ez a függvény lehetővé teszi az egyes képek kinyerését és dokumentumhoz adását

Miután egy kép a dokumentumhoz lett adva, bármely oldalon többször is kirajzolható a PDF-fájl méretének további növelése nélkül

A támogatott képfájltípusok: BMP, TIFF, JPEG, PNG, GIF, WMF és EMF

PDF-verzió viselkedése: 16 bites komponensenkénti képadatok importálásához PDF 1.5 szükséges. Ha egy dokumentum PDF 1.4 vagy korábbi verzióra van beállítva, és a mentési verzió nincs zárolva, az AddImageFromFileOffset automatikusan PDF 1.5-re emeli a dokumentumot, és a 16-bit image samples értéket rögzíti az AutoBumpedFeatures mezőben. Ha a hívó alacsonyabb mentési verziót zárol, a kompatibilitási kapu LastErrorCode 602 értékkel elutasítja a mentést

BMP és TIFF képek esetén a CompressImages függvény e függvény előtt hívható a képadatok tömörítésére. Más képtípusok automatikusan tömörülnek

Szintaxis

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);

Paraméterek

FileName	A képeket tartalmazó fájl neve
Offset	Az eltolás a fájlban, ahol a szükséges kép kezdődik. A fájl első bájtjának eltolása 0
DataLength	A képadatok hossza bájtokban
Options	Többoldalas TIFF-képeknél ez a paraméter a betöltendő oldalszámot adja meg. PNG-képeknél: 0 = Kép szokásos betöltése 1 = Alfa-csatorna betöltése szürkeárnyalatos képként 2 = Kép és alfa-csatorna betöltése (alfa 8 bitesre korlátozva) 3 = Kép betöltése (8 bit/csatornára korlátozva) 4 = Alfa-csatorna betöltése (8 bit/csatornára korlátozva) 5 = Kép betöltése alfa-csatornával (mindkettő 8 bit/csatornára korlátozva) 6 = Kép és alfa-csatorna betöltése 7 = Kép és ICC-színprofil betöltése. Más képtípusoknál a paramétert 0-ra kell állítani. Az Options -1 értéke a TIFF-, EMF- és WMF-képek GDI+ grafikus könyvtárral történő betöltését kényszeríti. Többoldalas TIFF-képek GDI+-szal is betölthetők, ha az Options paraméter értéke -PageNumber (például a 3. oldalhoz -3)

Visszatérési értékek

0	A kép nem olvasható a fájlból. Ez érvénytelen képadatot jelezhet, vagy a fájl nem található
Non-zero	A kép beolvasása a fájlból és dokumentumhoz adása sikerült. A visszaadott érték a kép azonosítója, amely a DrawImage képrajzoló függvényekkel használható