AddImageFromString

Gestionarea imaginilor

Descriere

Adaugă o imagine din memorie î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ă, AddImageFromString 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parametri

Source	Un șir care conține datele imaginii. În versiunea ActiveX a bibliotecii acest șir trebuie să conțină caractere de 16 biți; se vor folosi doar cei mai puțin semnificativi 8 biți ai fiecărui caracter
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)

Source

Un șir care conține datele imaginii. În versiunea ActiveX a bibliotecii acest șir trebuie să conțină caractere de 16 biți; se vor folosi doar cei mai puțin semnificativi 8 biți ai fiecărui caracter

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	Datele imaginii erau invalide sau imaginea avea un format nesuportat Imaginea a fost adăugată cu succes. Valoarea returnată este ImageID-ul, care poate fi folosit cu funcții precum SelectImage și DrawImage
1