AddImageFromStream

Penanganan gambar

Deskripsi

Menambahkan image dari TStream 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, AddImageFromStream 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parameter

InStream	Objek TStream yang berisi data image. Posisi saat ini di stream akan diabaikan; data image dibaca dari posisi 0 di stream
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)

InStream

Objek TStream yang berisi data image. Posisi saat ini di stream akan diabaikan; data image dibaca dari posisi 0 di stream

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	Terjadi error saat membaca data image yang valid dari stream Image berhasil ditambahkan ke dokumen. Nilai yang dikembalikan adalah ID image yang bisa dipakai dengan fungsi menggambar image seperti DrawImage
Non-zero