ExternalizeInlineImages
文件最佳化、影像處理、效能
描述
在所選頁面內容中找出位元組相同且受支援的行內影像，把重複的 BI 到 EI 定義換成對單一共用影像 XObject 的參照
語法
Delphi
Function TPDFlib.ExternalizeInlineImages(Const PageRange: WideString= ''; MinimumOccurrences: Integer= 2): Integer;參數
| PageRange | 以 1 起算的頁面範圍，例如 1,3,5-7；空字串表示所有頁面；重複頁碼會被忽略 |
|---|---|
| MinimumOccurrences | 升級所需的精確出現最小次數，必須至少 2 |
傳回值
被取代的行內影像出現次數；沒有分組符合條件、範圍無效、最小值低於 2，或操作在套用前被取消時為 0
備註
分組涵蓋尺寸、位元深度、影像遮罩與內插旗標、色彩空間、濾器鏈、decode 參數、decode 陣列與編碼承載，先以 SHA-256 索引再精確比對
支援直接的 DeviceGray、DeviceRGB、DeviceCMYK 影像與 stencil 遮罩；具名或複雜色彩空間與未知的行內字典項保持不變
既有濾器與 decode 參數保持不變；未壓縮的承載只在壓縮後更小時才做 Flate 壓縮
只有當保守估計（含 Image XObject、頁面資源與取代指令）小於原始行內範圍時，該群組才會被提升
此操作回報蒐集與套用進度、在頁面邊界回應 Abort、還原先前所選頁面，且具冪等性
蒐集期間取消不做任何變更；套用期間取消則保留已完成的頁面
範例
ReplacedImages:= PDF.ExternalizeInlineImages('1-200', 3);
Writeln(ReplacedImages);