AddImageFromStream

Gestionarea imaginilor

Descriere

Adaugă o imagine dintr-un TStream în documentul selectat

După ce o imagine a fost adăugată în document, poate fi desenată pe orice pagină de mai multe ori fără a mai crește dimensiunea fișierului PDF

Tipurile de fișiere imagine suportate sunt BMP, TIFF, JPEG, PNG, GIF, WMF, EMF și WebP, plus AVIF, HEIF, HEIC și JPEG XL când este disponibil un decodor de imagini modern

Comportamentul versiunii PDF: importul datelor de imagine pe 16 biți per componentă necesită PDF 1.5. Când un document este setat pe PDF 1.4 sau mai mic și versiunea de salvare nu este blocată, AddImageFromStream ridică automat documentul la PDF 1.5 și înregistrează 16-bit image samples în AutoBumpedFeatures. Dacă apelantul blochează o versiune de salvare mai mică, poarta de compatibilitate respinge salvarea cu LastErrorCode 602

Pentru imaginile BMP și TIFF, funcția CompressImages poate fi apelată înaintea acestei funcții pentru a comprima datele imaginii. Celelalte tipuri de imagini sunt comprimate automat

Sintaxă

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametri

InStream	Obiectul TStream care conține datele imaginii. Poziția curentă din stream va fi ignorată; datele imaginii vor fi citite de la poziția 0 din stream
Options	Pentru imaginile TIFF cu mai multe pagini acest parametru specifică numărul paginii de încărcat. Pentru imaginile PNG: 0 = Încarcă imaginea normal 1 = Încarcă canalul alpha ca imagine în tonuri de gri 2 = Încarcă imaginea și canalul alpha (alpha limitat la 8 biți) 3 = Încarcă imaginea (limitată la 8 biți/canal) 4 = Încarcă canalul alpha (limitat la 8 biți/canal) 5 = Încarcă imaginea cu canal alpha (ambele limitate la 8 biți/canal) 6 = Încarcă imaginea și canalul alpha 7 = Încarcă imaginea și profilul de culoare ICC 8 = Încarcă imaginea, canalul alpha și profilul de culoare ICC, păstrând adâncimea mare de biți Pentru celelalte tipuri de imagini acest parametru trebuie setat pe 0. Setarea Options pe -1 forțează încărcarea imaginilor TIFF, EMF și WMF prin biblioteca grafică GDI+. Imaginile TIFF multipagină pot fi încărcate și prin GDI+ setând parametrul Options pe -PageNumber (de exemplu -3 pentru pagina 3)

InStream

Obiectul TStream care conține datele imaginii. Poziția curentă din stream va fi ignorată; datele imaginii vor fi citite de la poziția 0 din stream

Options

Pentru imaginile TIFF cu mai multe pagini acest parametru specifică numărul paginii de încărcat. Pentru imaginile PNG: 0 = Încarcă imaginea normal 1 = Încarcă canalul alpha ca imagine în tonuri de gri 2 = Încarcă imaginea și canalul alpha (alpha limitat la 8 biți) 3 = Încarcă imaginea (limitată la 8 biți/canal) 4 = Încarcă canalul alpha (limitat la 8 biți/canal) 5 = Încarcă imaginea cu canal alpha (ambele limitate la 8 biți/canal) 6 = Încarcă imaginea și canalul alpha 7 = Încarcă imaginea și profilul de culoare ICC 8 = Încarcă imaginea, canalul alpha și profilul de culoare ICC, păstrând adâncimea mare de biți Pentru celelalte tipuri de imagini acest parametru trebuie setat pe 0. Setarea Options pe -1 forțează încărcarea imaginilor TIFF, EMF și WMF prin biblioteca grafică GDI+. Imaginile TIFF multipagină pot fi încărcate și prin GDI+ setând parametrul Options pe -PageNumber (de exemplu -3 pentru pagina 3)

Valori returnate

0	A apărut o eroare la citirea datelor de imagine valide din stream Imaginea a fost adăugată cu succes în document. Valoarea returnată este ID-ul imaginii, care poate fi folosit cu funcțiile de desenare a imaginilor precum DrawImage
Non-zero