RenderPageToFile
渲染和打印
描述
此函数将所选文档中的页面渲染到磁盘文件,写入磁盘的数据取决于 Options 参数
默认情况下,渲染使用 GDI+ 系统,该系统默认适用于 Windows XP 及更高版本
GDI+ 和 Cairo 渲染器支持 PDF 着色类型 1 和 4–7,包括自适应函数采样、源空间颜色插值、BBox 裁剪、Background 填充、透明度和受限的网格细分
选项 10 的 TIFF(G4)输出仅适用于 Windows Vista、Windows Server 2008 及更高版本
也可以使用 Cairo 渲染,请使用 SetCairoFileName 和 SelectRenderer
functions
对于具有 /Alternates 的图像,内置渲染器会保留可见的基础图像,或按 ISO 32000-1 的要求选择第一个可见的可选内容替代图像
语法
Delphi
Function TPDFlib.RenderPageToFile(DPI: Double; Page, Options: Integer; Const FileName: WideString): Integer;
ActiveX
Function PDFlib::RenderPageToFile(DPI As Double, Page As Long, Options As Long, FileName As String) As Long
DLL
int DLRenderPageToFile(int InstanceID, double DPI, int Page, int Options, const wchar_t * FileName);
参数
| DPI | 渲染页面时使用的 DPI。值超过 300 会导致过高的内存使用量 |
|---|---|
| Page | 要渲染的页码 |
| Options | 0 = BMP 输出 1 = JPEG 输出 2 = WMF 输出 3 = EMF 输出 4 = EPS 输出 5 = PNG 输出 6 = GIF 输出 7 = TIFF(LZW)输出 8 = EMF+ 输出 9 = HTML5 输出 10 = TIFF(G4)输出 11 = EMF+ Dual 输出 |
| FileName | 用于存储已渲染页面图像数据的待创建文件路径和文件名 |
返回值
| 0 | 页面无法渲染 |
|---|---|
| 1 | 页面已正确渲染,图像文件已保存到磁盘,无法将文件写入磁盘 2 |