AddImageFromString

Zpracování obrázků

Popis

Přidá obrázek z paměti 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

Podporované typy obrázkových souborů jsou BMP, TIFF, JPEG, PNG, GIF, WMF, EMF a WebP, plus AVIF, HEIF, HEIC a JPEG XL, pokud je k dispozici moderní dekodér obrázků

Chování podle verze PDF: import obrazových dat s 16 bity na komponentu vyžaduje PDF 1.5. Pokud je dokument nastaven na PDF 1.4 nebo nižší a verze pro uložení není uzamčena, AddImageFromString automaticky zvýší dokument na PDF 1.5 a zaznamená 16-bit image samples v AutoBumpedFeatures. Pokud volající uzamkne nižší verzi pro uložení, brána 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parametry

Source	Řetězec obsahující obrazová data. V ActiveX verzi knihovny musí tento řetězec obsahovat 16bitové znaky, přičemž použije se jen dolních 8 bitů každého znaku
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)

Source

Řetězec obsahující obrazová data. V ActiveX verzi knihovny musí tento řetězec obsahovat 16bitové znaky, přičemž použije se jen dolních 8 bitů každého znaku

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)

Návratové hodnoty

1
0	Obrazová data byla neplatná, nebo byl obrázek v nepodporovaném formátu Obrázek se úspěšně přidal. Vrácená hodnota je ImageID použitelné s funkcemi jako SelectImage a DrawImage