ExternalizeInlineImages

文档优化、图像处理、性能

描述

在所选页面内容中查找字节完全相同的受支持内联图像,并将其重复的 BI 至 EI 定义替换为对同一共享 Image XObject 的引用

语法

Delphi

Function TPDFlib.ExternalizeInlineImages(Const PageRange: WideString= ''; MinimumOccurrences: Integer= 2): Integer;

参数

PageRange从一开始的页面范围,例如 1,3,5-7,或代表每页的空字符串;重复页码将被忽略
MinimumOccurrences提升所需的最小精确出现次数,且必须至少为 2

返回值

替换的内联图像出现次数;0 表示没有合格组、范围无效、最小值低于 2,或操作在应用前被取消

备注

分组包括尺寸、位深度、图像蒙版和插值标志、颜色空间、过滤链、解码参数、解码数组及编码负载,先进行 SHA-256 索引再精确比较

支持直接 DeviceGray、DeviceRGB 和 DeviceCMYK 图像以及模板蒙版,命名或复杂颜色空间和未知的内联字典条目保持不变

保留现有筛选器和解码参数;仅当压缩后的表示更小时,才会对未筛选的有效负载进行 Flate 压缩

仅当包含 Image XObject、页面资源和替换指令的保守估计小于原始内联跨度时,才会提升一个组

操作报告收集和应用进度,在页面边界响应 Abort,恢复先前选定页面,并且具有幂等性

收集期间取消不会更改任何内容;应用期间取消会保留已完成的页面

示例

ReplacedImages:= PDF.ExternalizeInlineImages('1-200', 3);
Writeln(ReplacedImages);

另请参阅

OptimizeImages、RecompressStreams、NormalizeContentStreams