AddImageFromString

Quản lý ảnh

Mô tả

Thêm ảnh từ memory 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 phiên bản PDF: import dữ liệu ảnh 16-bit mỗi thành phần đòi PDF 1.5. Khi tài liệu đặt PDF 1.4 trở xuống và phiên bản lưu chưa bị khóa, AddImageFromString tự nâng tài liệu lên PDF 1.5 và ghi 16-bit image samples vào AutoBumpedFeatures. Nếu caller khóa một phiên bản lưu thấp hơn, cổng tương thích từ chối việc 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Tham số

Source	Chuỗi chứa dữ liệu ảnh. Ở phiên bản ActiveX của thư viện, chuỗi này phải chứa ký tự 16-bit, và chỉ 8-bit thấp của mỗi ký tự được dùng
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)

Source

Chuỗi chứa dữ liệu ảnh. Ở phiên bản ActiveX của thư viện, chuỗi này phải chứa ký tự 16-bit, và chỉ 8-bit thấp của mỗi ký tự được dùng

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	Dữ liệu ảnh không hợp lệ hoặc ảnh ở định dạng không được hỗ trợ Đã thêm ảnh thành công. Giá trị trả về là ImageID, dùng được với các hàm như SelectImage và DrawImage
1