AddImageFromFile

Afbeeldingsverwerking

Beschrijving

Voegt een afbeelding uit een bestand toe aan het geselecteerde document

Zodra een afbeelding aan het document is toegevoegd, kan deze op elke pagina meerdere keren worden getekend zonder dat het PDF-bestand verder groeit

Ondersteunde afbeeldingstypen zijn BMP, TIFF, JPEG, PNG, GIF, WMF, EMF en WebP, plus AVIF, HEIF, HEIC en JPEG XL wanneer een moderne imagedecoder beschikbaar is

Gedrag van de PDF-versie: voor het importeren van afbeeldingsgegevens met 16 bits per component is PDF 1.5 vereist. Wanneer een document is ingesteld op PDF 1.4 of lager en de opslagversie niet is vergrendeld, verhoogt AddImageFromFile het document automatisch naar PDF 1.5 en registreert 16-bit image samples in AutoBumpedFeatures. Als de aanroeper een lagere opslagversie vergrendelt, weigert de compatibiliteitscontrole de opslag met LastErrorCode 602

Voor BMP- en TIFF-afbeeldingen kan de functie CompressImages vóór deze functie worden aangeroepen om de afbeeldingsdata te comprimeren. Andere afbeeldingstypen worden automatisch gecomprimeerd

Syntaxis

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);

Parameters

FileName	De bestandsnaam van de toe te voegen afbeelding
Options	Voor multipage-TIFF-afbeeldingen geeft deze parameter het te laden paginanummer op. Voor PNG-afbeeldingen: 0 = De afbeelding normaal laden 1 = Het alphakanaal als grijswaardenafbeelding laden 2 = De afbeelding en het alphakanaal laden (alfa beperkt tot 8-bit) 3 = De afbeelding laden (afbeelding beperkt tot 8-bit/kanaal) 4 = Het alphakanaal laden (beperkt tot 8-bit/kanaal) 5 = De afbeelding met alphakanaal laden (beide beperkt tot 8-bit/kanaal) 6 = De afbeelding en het alphakanaal laden 7 = De afbeelding en het ICC-kleurprofiel laden 8 = De afbeelding, het alphakanaal en het ICC-kleurprofiel laden met behoud van hoge bitdiepte Voor andere afbeeldingstypen moet deze parameter op 0 worden gezet. Als Options op -1 wordt gezet, worden TIFF-, EMF- en WMF-afbeeldingen met de GDI+ graphics library geladen. Multipage-TIFF-afbeeldingen kunnen ook met GDI+ worden geladen door de parameter Options op -PageNumber te zetten (bijvoorbeeld -3 voor pagina 3)

FileName

De bestandsnaam van de toe te voegen afbeelding

Options

Voor multipage-TIFF-afbeeldingen geeft deze parameter het te laden paginanummer op. Voor PNG-afbeeldingen: 0 = De afbeelding normaal laden 1 = Het alphakanaal als grijswaardenafbeelding laden 2 = De afbeelding en het alphakanaal laden (alfa beperkt tot 8-bit) 3 = De afbeelding laden (afbeelding beperkt tot 8-bit/kanaal) 4 = Het alphakanaal laden (beperkt tot 8-bit/kanaal) 5 = De afbeelding met alphakanaal laden (beide beperkt tot 8-bit/kanaal) 6 = De afbeelding en het alphakanaal laden 7 = De afbeelding en het ICC-kleurprofiel laden 8 = De afbeelding, het alphakanaal en het ICC-kleurprofiel laden met behoud van hoge bitdiepte Voor andere afbeeldingstypen moet deze parameter op 0 worden gezet. Als Options op -1 wordt gezet, worden TIFF-, EMF- en WMF-afbeeldingen met de GDI+ graphics library geladen. Multipage-TIFF-afbeeldingen kunnen ook met GDI+ worden geladen door de parameter Options op -PageNumber te zetten (bijvoorbeeld -3 voor pagina 3)

Retourwaarden

0	De afbeelding kon niet worden toegevoegd. Deze is niet gevonden of heeft een niet-ondersteund formaat
Non-zero	De afbeelding is toegevoegd. De ImageID wordt geretourneerd en kan worden doorgegeven aan functies als SelectImage en DrawImage