AddImageFromFile

Image handling

Popis

Přidá do vybraného dokumentu obrázek ze souboru

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í podle verze PDF: import obrazových dat ve formátu 16-bit-per-component vyžaduje PDF 1.5. Pokud je dokument nastaven na PDF 1.4 nebo nižší verzi a verze ukládání není uzamčena, AddImageFromFile dokument automaticky povýší na PDF 1.5 a zapíše 16-bit image samples do AutoBumpedFeatures. Pokud volající uzamkne nižší verzi ukládání, kontrola kompatibility odmítne uložení 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.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parametry

FileName	Název souboru přidávaného obrázku
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)

FileName

Název souboru přidávaného obrázku

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	Obrázek se nepodařilo přidat. Buď se ho nepodařilo najít, nebo je v nepodporovaném formátu
Non-zero	Obrázek byl úspěšně přidán. Vrací se ImageID, který lze předat funkcím jako SelectImage nebo DrawImage