AddImageFromStream

Képkezelés

Leírás

TStreamből ad hozzá 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: 16 bites komponensenkénti képadatok importálásához PDF 1.5 szükséges. Ha egy dokumentum PDF 1.4 vagy régebbi értékre van állítva, és a mentési verzió nincs zárolva, az AddImageFromStream automatikusan PDF 1.5-re emeli a dokumentumot, és a 16-bit image samples elemet a AutoBumpedFeatures mezőben rögzíti. Ha a hívó alacsonyabb mentési verziót zárol, a kompatibilitási kapu LastErrorCode 602 hibával 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Paraméterek

InStream	A képadatait tartalmazó TStream objektum. Az adatfolyam aktuális pozíciója figyelmen kívül marad, a képadatok az adatfolyam 0. pozíciójától lesznek beolvasva
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)

InStream

A képadatait tartalmazó TStream objektum. Az adatfolyam aktuális pozíciója figyelmen kívül marad, a képadatok az adatfolyam 0. pozíciójától lesznek beolvasva

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	Hiba történt érvényes képadatok adatfolyamból való olvasásakor A kép hozzáadása a dokumentumhoz sikerült. A visszaadott érték a kép azonosítója, amely a DrawImage képrajzoló függvényekkel használható
Non-zero