AddImageFromStream

Kuvien käsittely

Kuvaus

Lisää kuvan TStreamista 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äytäntö: 16 bittiä/komponentti -kuvadatan tuonti vaatii PDF 1.5:n. Kun asiakirja on asetettu PDF 1.4:ään tai vanhemmaksi eikä tallennusversiota ole lukittu, AddImageFromStream nostaa asiakirjan automaattisesti PDF 1.5:een ja merkitsee 16-bit image samples -ominaisuuden AutoBumpedFeaturesiin. Jos kutsuja lukitsee vanhemman 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametrit

InStream	Kuvadatan sisältävä TStream-objekti. Virran nykyistä sijaintia ei oteta huomioon; kuvadata luetaan virran sijainnista 0
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)

InStream

Kuvadatan sisältävä TStream-objekti. Virran nykyistä sijaintia ei oteta huomioon; kuvadata luetaan virran sijainnista 0

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	Virran kelvollisen kuvadatan lukemisessa tapahtui virhe Kuva lisättiin asiakirjaan onnistuneesti. Palautettava arvo on kuvan tunnus, jota voi käyttää kuvien piirtofunktioissa kuten DrawImage
Non-zero