AddImageFromString

Penanganan gambar

Deskripsi

Menambahkan image dari memori ke dokumen terpilih

Setelah image ditambahkan ke dokumen, image tersebut bisa digambar di halaman mana pun berkali-kali tanpa menambah ukuran file PDF

Tipe file image yang didukung adalah BMP, TIFF, JPEG, PNG, GIF, WMF, EMF, dan WebP, plus AVIF, HEIF, HEIC, dan JPEG XL saat image decoder modern tersedia

Perilaku versi PDF: mengimpor data image 16-bit per komponen membutuhkan PDF 1.5. Saat dokumen diset PDF 1.4 atau lebih rendah dan save version tidak dikunci, AddImageFromString otomatis menaikkan dokumen ke PDF 1.5 dan mencatat 16-bit image samples di AutoBumpedFeatures. Jika pemanggil mengunci save version lebih rendah, compatibility gate menolak penyimpanan dengan LastErrorCode 602

Untuk image BMP dan TIFF, fungsi CompressImages bisa dipanggil sebelum fungsi ini untuk mengompres data image. Tipe image lain dikompres secara otomatis

Sintaks

Delphi

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

DLL

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

Parameter

Source	String yang berisi data image. Di versi ActiveX dari library, string ini harus berisi karakter 16-bit dan hanya 8-bit rendah dari setiap karakter yang dipakai
Options	Untuk image TIFF multi-halaman, parameter ini menentukan nomor halaman yang dimuat. Untuk image PNG: 0 = Muat image seperti biasa 1 = Muat alpha channel sebagai image grayscale 2 = Muat image beserta alpha channel (alpha dibatasi 8-bit) 3 = Muat image (image dibatasi 8-bit/channel) 4 = Muat alpha channel (dibatasi 8-bit/channel) 5 = Muat image dengan alpha channel (keduanya dibatasi 8-bit/channel) 6 = Muat image beserta alpha channel 7 = Muat image beserta ICC color profile 8 = Muat image, alpha channel, dan ICC color profile dengan mempertahankan high bit depth Untuk tipe image lain, parameter ini harus diset ke 0. Mengset Options ke -1 memaksa image TIFF, EMF, dan WMF dimuat menggunakan library grafis GDI+. Image TIFF multipage juga bisa dimuat via GDI+ dengan mengset parameter Options ke -PageNumber (misalnya -3 untuk halaman 3)

Source

String yang berisi data image. Di versi ActiveX dari library, string ini harus berisi karakter 16-bit dan hanya 8-bit rendah dari setiap karakter yang dipakai

Options

Untuk image TIFF multi-halaman, parameter ini menentukan nomor halaman yang dimuat. Untuk image PNG: 0 = Muat image seperti biasa 1 = Muat alpha channel sebagai image grayscale 2 = Muat image beserta alpha channel (alpha dibatasi 8-bit) 3 = Muat image (image dibatasi 8-bit/channel) 4 = Muat alpha channel (dibatasi 8-bit/channel) 5 = Muat image dengan alpha channel (keduanya dibatasi 8-bit/channel) 6 = Muat image beserta alpha channel 7 = Muat image beserta ICC color profile 8 = Muat image, alpha channel, dan ICC color profile dengan mempertahankan high bit depth Untuk tipe image lain, parameter ini harus diset ke 0. Mengset Options ke -1 memaksa image TIFF, EMF, dan WMF dimuat menggunakan library grafis GDI+. Image TIFF multipage juga bisa dimuat via GDI+ dengan mengset parameter Options ke -PageNumber (misalnya -3 untuk halaman 3)

Nilai kembalian

0	Data image tidak valid atau image berformat tidak didukung Image berhasil ditambahkan. Nilai yang dikembalikan adalah ImageID yang bisa dipakai dengan fungsi seperti SelectImage dan DrawImage
1