AddImageFromString

Afbeeldingsverwerking

Beschrijving

Voegt een afbeelding vanuit het geheugen 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 met betrekking tot 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 AddImageFromString het document automatisch naar PDF 1.5 en registreert het 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parameters

Source	Een string met de afbeeldingsdata. In de ActiveX-versie van de library moet deze string 16-bit-tekens bevatten; van elk teken worden alleen de onderste 8 bits gebruikt
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)

Source

Een string met de afbeeldingsdata. In de ActiveX-versie van de library moet deze string 16-bit-tekens bevatten; van elk teken worden alleen de onderste 8 bits gebruikt

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 afbeeldingsdata was ongeldig of de afbeelding had een niet-ondersteund formaat De afbeelding is toegevoegd. De geretourneerde waarde is de ImageID en kan worden gebruikt met functies als SelectImage en DrawImage
1