AddImageFromStream

Quản lý ảnh

Mô tả

Thêm ảnh từ một TStream 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, AddImageFromStream 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Tham số

InStream	Đối tượng TStream chứa dữ liệu ảnh. Vị trí hiện tại trong stream bị bỏ qua, dữ liệu ảnh được đọc từ vị trí 0 của stream
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)

InStream

Đối tượng TStream chứa dữ liệu ảnh. Vị trí hiện tại trong stream bị bỏ qua, dữ liệu ảnh được đọc từ vị trí 0 của stream

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	Có lỗi khi đọc dữ liệu ảnh hợp lệ từ stream Đã thêm ảnh 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
Non-zero