AddImageFromFile

Image handling

Mô tả

Thêm ảnh từ file vào tài liệu đang chọn

Sau khi ảnh đã được thêm vào tài liệu, có thể vẽ ảnh đó lên bất kỳ trang nào nhiều lần mà không làm tăng thêm kích thước file PDF

Các kiểu file ảnh được hỗ trợ: BMP, TIFF, JPEG, PNG, GIF, WMF, EMF và WebP, cộng thêm AVIF, HEIF, HEIC và JPEG XL khi có một image decoder hiện đại

Hành vi theo phiên bản PDF: việc nhập dữ liệu hình ảnh 16 bit mỗi thành phần yêu cầu PDF 1.5. Khi tài liệu được đặt là PDF 1.4 hoặc thấp hơn và phiên bản lưu không bị khóa, AddImageFromFile tự động nâng tài liệu lên PDF 1.5 và ghi 16-bit image samples vào AutoBumpedFeatures. Nếu bên gọi khóa phiên bản lưu thấp hơn, cổng tương thích sẽ từ chối lưu với LastErrorCode 602.

Với ảnh BMP và TIFF, có thể gọi hàm CompressImages trước hàm này để nén dữ liệu ảnh. Các loại ảnh khác được tự động nén

Cú pháp

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);

Tham số

FileName	Tên file ảnh cần thêm
Options	Với ảnh TIFF nhiều trang, tham số này chỉ định số trang cần nạp. Với ảnh PNG: 0 = Nạp ảnh như bình thường 1 = Nạp alpha channel dưới dạng ảnh grayscale 2 = Nạp ảnh và alpha channel (giới hạn alpha 8-bit) 3 = Nạp ảnh (giới hạn 8-bit/kênh) 4 = Nạp alpha channel (giới hạn 8-bit/kênh) 5 = Nạp ảnh kèm alpha channel (cả hai giới hạn 8-bit/kênh) 6 = Nạp ảnh và alpha channel 7 = Nạp ảnh và ICC color profile 8 = Nạp ảnh, alpha channel và ICC color profile, giữ nguyên độ sâu bit cao Với các loại ảnh khác, tham số này nên đặt bằng 0. Đặt Options = -1 sẽ buộc ảnh TIFF, EMF và WMF nạp qua thư viện đồ họa GDI+. Ảnh TIFF nhiều trang cũng có thể nạp bằng GDI+ bằng cách đặt tham số Options thành -PageNumber (ví dụ -3 cho trang 3)

FileName

Tên file ảnh cần thêm

Options

Với ảnh TIFF nhiều trang, tham số này chỉ định số trang cần nạp. Với ảnh PNG: 0 = Nạp ảnh như bình thường 1 = Nạp alpha channel dưới dạng ảnh grayscale 2 = Nạp ảnh và alpha channel (giới hạn alpha 8-bit) 3 = Nạp ảnh (giới hạn 8-bit/kênh) 4 = Nạp alpha channel (giới hạn 8-bit/kênh) 5 = Nạp ảnh kèm alpha channel (cả hai giới hạn 8-bit/kênh) 6 = Nạp ảnh và alpha channel 7 = Nạp ảnh và ICC color profile 8 = Nạp ảnh, alpha channel và ICC color profile, giữ nguyên độ sâu bit cao Với các loại ảnh khác, tham số này nên đặt bằng 0. Đặt Options = -1 sẽ buộc ảnh TIFF, EMF và WMF nạp qua thư viện đồ họa GDI+. Ảnh TIFF nhiều trang cũng có thể nạp bằng GDI+ bằng cách đặt tham số Options thành -PageNumber (ví dụ -3 cho trang 3)

Giá trị trả về

0	Không thể thêm ảnh. Hoặc không tìm thấy, hoặc định dạng không được hỗ trợ
Non-zero	Đã thêm ảnh thành công. Hàm trả về ImageID, có thể truyền ImageID này cho các hàm như SelectImage hay DrawImage