AddImageFromFile

Image handling

Deskripsi

Menambahkan image dari file 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 gambar 16-bit-per-komponen memerlukan PDF 1.5. Ketika dokumen diatur ke PDF 1.4 atau yang lebih rendah dan versi simpan tidak dikunci, AddImageFromFile secara otomatis menaikkan dokumen ke PDF 1.5 dan mencatat 16-bit image samples dalam AutoBumpedFeatures. Jika pemanggil mengunci versi simpan yang lebih rendah, gerbang kompatibilitas 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.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parameter

FileName	Nama file image yang akan ditambahkan
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)

FileName

Nama file image yang akan ditambahkan

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	Image gagal ditambahkan. Entah tidak ditemukan atau formatnya tidak didukung
Non-zero	Image berhasil ditambahkan. ImageID dikembalikan dan bisa diteruskan ke fungsi seperti SelectImage dan DrawImage