RenderPageToMetafileStream
渲染和打印
描述
此函数仅在 Delphi 版本中可用;它将选定文档中的页面渲染到 TStream 中作为 Windows 元文件(矢量输出),保留页面的文本和矢量内容,而不是将其栅格化为像素
所选的 Format 控制图元文件变体:mfEMF 使用经典的 GDI 增强型图元文件路径(广泛的消费者兼容性),mfEMFPlus 和 mfEMFDual 使用 GDI+ 记录路径(对透明度和抗锯齿有更好的保真度),而 mfWMF 生成传统的 16 位格式
mfEMFDual 在同一文件中同时记录 GDI 和 GDI+ 命令,以便仅支持 GDI 的旧取用端仍能读取它,代价是文件体积较大;当已知取用端支持 GDI+ 时,首选 mfEMFPlus(Office、Illustrator、现代查看器)
在内部,这是 RenderPageToStream 的一个便利包装器,它将 Format 映射为整数 Options 值,因此 DPI 仍然会乘以通过 SetRenderScale 设置的每个实例的 RenderScale
语法
Delphi
Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;
参数
| DPI | 渲染页面时使用的 DPI;控制图元文件框架尺寸,矢量内容本身与 DPI 无关 |
|---|---|
| Page | 要渲染的页码 |
| Format | mfEMF = 经典 GDI EMF;mfEMFPlus = 仅 GDI+ EMF+;mfEMFDual = GDI+ EMF+ Dual(GDI + GDI+ 记录,较大但广泛兼容);mfWMF = 传统 16 位 WMF |
| Target | 用于放置渲染后的元文件字节的流 |
返回值
| 0 | 页面无法渲染 |
|---|---|
| 1 | 页面已正确渲染,且图元文件字节已写入流中 |