AddImageFromString

Kuvien käsittely

Kuvaus

Lisää kuvan muistista valittuun asiakirjaan

Kun kuva on lisätty asiakirjaan, sen voi piirtää mille tahansa sivulle monta kertaa ilman että PDF-tiedoston koko kasvaa enää

Tuetut kuvatiedostotyypit ovat BMP, TIFF, JPEG, PNG, GIF, WMF, EMF ja WebP sekä AVIF, HEIF, HEIC ja JPEG XL, kun moderni kuvadekooderi on saatavilla

PDF-versiokäyttäytyminen: 16-bittisten komponenttikohtaisten kuvatietojen tuonti edellyttää PDF 1.5:tä. Kun asiakirjaksi on asetettu PDF 1.4 tai aiempi eikä tallennusversiota ole lukittu, AddImageFromString nostaa asiakirjan automaattisesti PDF 1.5:een ja kirjaa 16-bit image samples kohteeseen AutoBumpedFeatures. Jos kutsuja lukitsee alemman tallennusversion, yhteensopivuusportti hylkää tallennuksen virheellä LastErrorCode 602.

BMP- ja TIFF-kuvien kuvadatan voi pakata kutsumalla CompressImages-funktiota ennen tätä kutsua. Muut kuvatyypit pakataan automaattisesti

Syntaksi

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parametrit

Source	Kuvadatan sisältävä merkkijono. Kirjaston ActiveX-versiossa merkkijonon on sisällettävä 16-bittisiä merkkejä; jokaisen merkin alemmat 8 bittiä käytetään
Options	Monisivuisilla TIFF-kuvilla tämä parametri määrittää ladattavan sivunumeron. PNG-kuville: 0 = lataa kuva tavallisesti 1 = lataa alfakanava harmaasävykuvana 2 = lataa kuva ja alfakanava (alfa rajoitettuna 8 bittiin) 3 = lataa kuva (kuva rajoitettuna 8 bittiin/kanava) 4 = lataa alfakanava (rajoitettuna 8 bittiin/kanava) 5 = lataa kuva alfakanavalla (molemmat rajoitettuna 8 bittiin/kanava) 6 = lataa kuva ja alfakanava 7 = lataa kuva ja ICC-väriprofiili 8 = lataa kuva, alfakanava ja ICC-väriprofiili säilyttäen suuremman bittisyvyyden Muilla kuvatyypeillä parametrin arvon tulee olla 0. Options-arvo -1 pakottaa lataamaan TIFF-, EMF- ja WMF-kuvat GDI+-grafiikkakirjastolla. Myös monisivuiset TIFF-kuvat voi ladata GDI+:lla asettamalla Options-parametriksi -PageNumber (esimerkiksi -3 sivulle 3)

Source

Kuvadatan sisältävä merkkijono. Kirjaston ActiveX-versiossa merkkijonon on sisällettävä 16-bittisiä merkkejä; jokaisen merkin alemmat 8 bittiä käytetään

Options

Monisivuisilla TIFF-kuvilla tämä parametri määrittää ladattavan sivunumeron. PNG-kuville: 0 = lataa kuva tavallisesti 1 = lataa alfakanava harmaasävykuvana 2 = lataa kuva ja alfakanava (alfa rajoitettuna 8 bittiin) 3 = lataa kuva (kuva rajoitettuna 8 bittiin/kanava) 4 = lataa alfakanava (rajoitettuna 8 bittiin/kanava) 5 = lataa kuva alfakanavalla (molemmat rajoitettuna 8 bittiin/kanava) 6 = lataa kuva ja alfakanava 7 = lataa kuva ja ICC-väriprofiili 8 = lataa kuva, alfakanava ja ICC-väriprofiili säilyttäen suuremman bittisyvyyden Muilla kuvatyypeillä parametrin arvon tulee olla 0. Options-arvo -1 pakottaa lataamaan TIFF-, EMF- ja WMF-kuvat GDI+-grafiikkakirjastolla. Myös monisivuiset TIFF-kuvat voi ladata GDI+:lla asettamalla Options-parametriksi -PageNumber (esimerkiksi -3 sivulle 3)

Paluuarvot

0	Kuvadata oli virheellinen tai kuva oli ei-tuetussa muodossa Kuva lisättiin onnistuneesti. Palautettava arvo on ImageID, jota voi käyttää funktioissa kuten SelectImage ja DrawImage
1