AddImageFromString

Képkezelés

Leírás

Memóriából ad képet a kijelölt dokumentumhoz

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, EMF és WebP, továbbá AVIF, HEIF, HEIC és JPEG XL, ha elérhető korszerű képdekóder

PDF-verzió viselkedése: a komponensenként 16 bites képadatok importálásához PDF 1.5 szükséges. Ha egy dokumentum PDF 1.4 vagy alacsonyabb verzióra van állítva, és a mentési verzió nincs zárolva, az AddImageFromString 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 a mentést LastErrorCode 602 hibával elutasítja

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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Paraméterek

Source	A képadatokat tartalmazó karakterlánc. A könyvtár ActiveX-változatában ennek a karakterláncnak 16 bites karaktereket kell tartalmaznia, minden karakternek csak az alsó 8 bitje használható
Options	Többoldalas TIFF-képek esetén ez a paraméter a betöltendő oldal számát adja meg PNG-képek esetén: 0 = Kép betöltése szokásos módon 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átozása) 3 = Kép betöltése (kép 8 bit/csatornára korlátozása) 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 8 = Kép, alfa csatorna és ICC-színprofil betöltése a nagy bitmélység megőrzésével Más képtípusoknál ezt a paramétert 0-ra kell állítani Az Options -1 értékre állítása kikényszeríti a TIFF-, EMF- és WMF-képek betöltését a GDI+ grafikai könyvtárral A többoldalas TIFF-képek GDI+ használatával is betölthetők, ha az Options paramétert -PageNumber értékre állítja (például -3 a 3. oldalhoz)

Source

A képadatokat tartalmazó karakterlánc. A könyvtár ActiveX-változatában ennek a karakterláncnak 16 bites karaktereket kell tartalmaznia, minden karakternek csak az alsó 8 bitje használható

Options

Többoldalas TIFF-képek esetén ez a paraméter a betöltendő oldal számát adja meg PNG-képek esetén: 0 = Kép betöltése szokásos módon 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átozása) 3 = Kép betöltése (kép 8 bit/csatornára korlátozása) 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 8 = Kép, alfa csatorna és ICC-színprofil betöltése a nagy bitmélység megőrzésével Más képtípusoknál ezt a paramétert 0-ra kell állítani Az Options -1 értékre állítása kikényszeríti a TIFF-, EMF- és WMF-képek betöltését a GDI+ grafikai könyvtárral A többoldalas TIFF-képek GDI+ használatával is betölthetők, ha az Options paramétert -PageNumber értékre állítja (például -3 a 3. oldalhoz)

Visszatérési értékek

0	A képadat érvénytelen volt, vagy a kép nem támogatott formátumú A kép sikeresen hozzáadva. A visszaadott érték az ImageID, amely olyan függvényekkel használható, mint a SelectImage és a DrawImage
1