AddImageFromFile

影像處理

描述

從檔案加入影像到所選文件

影像加入文件後，可在任何頁面重複繪製多次，PDF 檔案大小不會再增加

支援的影像檔案類型為 BMP、TIFF、JPEG、PNG、GIF、WMF、EMF 與 WebP；有現代影像解碼器可用時還支援 AVIF、HEIF、HEIC 與 JPEG XL

PDF 版本行為：匯入每色彩分量 16 位元的影像資料需要 PDF 1.5。當文件設定為 PDF 1.4 或更低版本，且未鎖定儲存版本時，AddImageFromFile 會自動將文件提升至 PDF 1.5，並將 16-bit image samples 記錄於 AutoBumpedFeatures。若呼叫端鎖定較低的儲存版本，相容性閘門會以 LastErrorCode 602 拒絕儲存

BMP 與 TIFF 影像可在呼叫此函式前先呼叫 CompressImages 函式壓縮影像資料；其他影像類型會自動壓縮

語法

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

參數

FileName	要加入影像的檔名。
Options	多頁 TIFF 影像時，此參數指定要載入的頁碼。 PNG 影像：0 = 以一般方式載入影像 1 = 將 Alpha 色版載入為灰階影像 2 = 載入影像與 Alpha 色版（Alpha 上限 8 位元） 3 = 載入影像（每色版上限 8 位元） 4 = 載入 Alpha 色版（每色版上限 8 位元） 5 = 載入含 Alpha 色版的影像（兩者每色版上限 8 位元） 6 = 載入影像與 Alpha 色版 7 = 載入影像與 ICC 色彩設定檔 8 = 載入影像、Alpha 色版與 ICC 色彩設定檔並保留高位元深度其他影像類型此參數應設為 0。Options 設為 -1 會強制以 GDI+ 圖形程式庫載入 TIFF、EMF 與 WMF 影像。多頁 TIFF 也可以用 GDI+ 載入，把 Options 設為 -頁碼即可（例如第 3 頁傳 -3）。

FileName

要加入影像的檔名。

Options

多頁 TIFF 影像時，此參數指定要載入的頁碼。 PNG 影像：0 = 以一般方式載入影像 1 = 將 Alpha 色版載入為灰階影像 2 = 載入影像與 Alpha 色版（Alpha 上限 8 位元） 3 = 載入影像（每色版上限 8 位元） 4 = 載入 Alpha 色版（每色版上限 8 位元） 5 = 載入含 Alpha 色版的影像（兩者每色版上限 8 位元） 6 = 載入影像與 Alpha 色版 7 = 載入影像與 ICC 色彩設定檔 8 = 載入影像、Alpha 色版與 ICC 色彩設定檔並保留高位元深度其他影像類型此參數應設為 0。Options 設為 -1 會強制以 GDI+ 圖形程式庫載入 TIFF、EMF 與 WMF 影像。多頁 TIFF 也可以用 GDI+ 載入，把 Options 設為 -頁碼即可（例如第 3 頁傳 -3）。

傳回值

0	無法加入影像。可能是找不到影像，或格式不受支援。
Non-zero	影像加入成功。傳回 ImageID，可傳給 SelectImage、DrawImage 等函式。