AddImageFromStream

Image handling

Popis

Přidá obrázek z TStream do vybraného dokumentu

Jakmile je obrázek do dokumentu přidán, lze ho na libovolné stránce vykreslit libovolněkrát, aniž by se PDF soubor dále zvětšoval

Supported image file types are BMP, TIFF, JPEG, PNG, GIF, WMF, EMF and WebP, plus AVIF, HEIF, HEIC and JPEG XL when a modern image decoder is available

Chování verze PDF: import obrazových dat s 16 bity na složku vyžaduje PDF 1.5. Je-li dokument nastavený na PDF 1.4 nebo nižší a verze ukládání není uzamčená, AddImageFromStream dokument automaticky zvýší na PDF 1.5 a zaznamená 16-bit image samples do AutoBumpedFeatures. Uzamkne-li volající nižší verzi ukládání, brána kompatibility uložení odmítne s LastErrorCode 602

U obrázků BMP a TIFF lze před voláním této funkce data zkomprimovat funkcí CompressImages. Ostatní typy obrázků se komprimují automaticky

Syntaxe

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametry

InStream	Objekt TStream obsahující obrazová data. Aktuální pozice v proudu se ignoruje, obrazová data se čtou od pozice 0 v proudu
Options	U vícestránkových obrázků TIFF tento parametr určuje číslo načítané stránky. U obrázků PNG: 0 = Načíst obrázek obvyklým způsobem 1 = Načíst alfa kanál jako obrázek ve stupních šedi 2 = Načíst obrázek i alfa kanál (alfa omezeno na 8 bitů) 3 = Načíst obrázek (omezeno na 8 bitů/kanál) 4 = Načíst alfa kanál (omezeno na 8 bitů/kanál) 5 = Načíst obrázek s alfa kanálem (oba omezeny na 8 bitů/kanál) 6 = Načíst obrázek i alfa kanál 7 = Načíst obrázek i ICC barevný profil 8 = Načíst obrázek, alfa kanál a ICC barevný profil se zachováním větší bitové hloubky U ostatních typů obrázků se parametr nastavuje na 0. Hodnota Options = -1 vynutí načtení obrázků TIFF, EMF a WMF přes grafickou knihovnu GDI+. Vícestránkové obrázky TIFF lze přes GDI+ načíst také nastavením parametru Options na -PageNumber (například -3 pro stránku 3)

InStream

Objekt TStream obsahující obrazová data. Aktuální pozice v proudu se ignoruje, obrazová data se čtou od pozice 0 v proudu

Options

U vícestránkových obrázků TIFF tento parametr určuje číslo načítané stránky. U obrázků PNG: 0 = Načíst obrázek obvyklým způsobem 1 = Načíst alfa kanál jako obrázek ve stupních šedi 2 = Načíst obrázek i alfa kanál (alfa omezeno na 8 bitů) 3 = Načíst obrázek (omezeno na 8 bitů/kanál) 4 = Načíst alfa kanál (omezeno na 8 bitů/kanál) 5 = Načíst obrázek s alfa kanálem (oba omezeny na 8 bitů/kanál) 6 = Načíst obrázek i alfa kanál 7 = Načíst obrázek i ICC barevný profil 8 = Načíst obrázek, alfa kanál a ICC barevný profil se zachováním větší bitové hloubky U ostatních typů obrázků se parametr nastavuje na 0. Hodnota Options = -1 vynutí načtení obrázků TIFF, EMF a WMF přes grafickou knihovnu GDI+. Vícestránkové obrázky TIFF lze přes GDI+ načíst také nastavením parametru Options na -PageNumber (například -3 pro stránku 3)

Return values

0	Při čtení platných obrazových dat z proudu došlo k chybě Obrázek se úspěšně přidal do dokumentu. Vrácená hodnota je ID obrázku použitelné s kreslicími funkcemi jako DrawImage
Non-zero