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