AddImageFromFileOffset

Image handling

Popis

Přidá do vybraného dokumentu obrázek z části souboru

Pokud je například mnoho obrázků spojeno do jednoho souboru, tato funkce umožní jednotlivé obrázky extrahovat a přidat do 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 and EMF.

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žší verzi a verze ukládání není uzamčena, AddImageFromFileOffset 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.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Parametry

FileName	Název souboru obsahujícího obrázky
Offset	Offset v souboru, kde požadovaný obrázek začíná. První bajt v souboru má offset 0
DataLength	Délka obrazových dat v bajtech
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 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 ze souboru nepodařilo přečíst. To může znamenat neplatná obrazová data, nebo se soubor nepodařilo najít
Non-zero	Obrázek se přečetl ze souboru a úspěšně přidal do dokumentu. Vrácená hodnota je ID obrázku, které lze použít s kreslicími funkcemi obrázků jako DrawImage