AddImageFromFileOffset

Image handling

Mô tả

Thêm ảnh từ một phần của file vào tài liệu đang chọn

Ví dụ, nếu nhiều ảnh đã được nối chung vào một file, hàm này cho phép trích xuất từng ảnh riêng lẻ và thêm vào tài liệu

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 và EMF

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, AddImageFromFileOffset 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.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Tham số

FileName	Tên file chứa các ảnh
Offset	Vị trí offset trong file nơi ảnh cần lấy bắt đầu. Byte đầu tiên trong file có offset 0
DataLength	Độ dài của dữ liệu ảnh tính bằng byte
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 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 đọc được ảnh từ file. Có thể dữ liệu ảnh không hợp lệ hoặc không tìm thấy file
Non-zero	Ảnh đã được đọc từ file và thêm vào tài liệu thành công. Giá trị trả về là ID của ảnh, dùng được với các hàm vẽ ảnh như DrawImage