AddImageFromString

影像處理

描述

從記憶體加入影像到所選文件

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

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

PDF 版本行為：匯入每成分 16 位元的影像資料需要 PDF 1.5。文件設為 PDF 1.4 以下且儲存版本未鎖定時，AddImageFromString 會自動把文件提升到 PDF 1.5，並在 AutoBumpedFeatures 記下 16-bit image samples；呼叫端鎖定了較低的儲存版本時，相容性閘門會以 LastErrorCode 602 拒絕儲存。

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

語法

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

參數

Source	字串，內含影像資料。程式庫的 ActiveX 版本中，此字串必須是 16 位元字元，且只會使用每個字元的低 8 位元。
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）。

Source

字串，內含影像資料。程式庫的 ActiveX 版本中，此字串必須是 16 位元字元，且只會使用每個字元的低 8 位元。

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	影像資料無效，或影像格式不受支援影像加入成功。傳回值是 ImageID，可搭配 SelectImage、DrawImage 等函式使用。
1