THPDFHeadlessRenderOptions
声明于 HPDFHeadlessCairoDevice;修改单个限额前先用 Default 初始化
| 字段 | 含义 | 默认值 |
|---|---|---|
Scale: Double | 每个有效页面点的像素数,含 UserUnit | 1 |
MaxPixels: Int64 | 页面表面或图像像素数的取整上限 | 16,777,216 |
MaxWorkingBytes: Int64 | 活动托管缓冲与表面的保守准入 | 134,217,728 |
MaxDecodedBytes: Int64 | 累计解码内容、图像与字体流字节 | 33,554,432 |
MaxPNGBytes: Int64 | 私有编码 PNG 大小 | 33,554,432 |
MaxTokens: Integer | 有界 Token 工作与选定数组计数 | 500,000 |
MaxOperations: Integer | 累计分发的内容操作 | 500,000 |
MaxDepth: Integer | 递归、字体数组与图形栈深度 | 32 |
RenderAnnotations: Boolean | 渲染可用的 normal 外观流 | True |
Usage: THPDFHeadlessRenderUsage | view 或 print Raster 输出的注释可见性 | hruView |
ViewerState: THPDFHeadlessOptionalContentState | 借用的显式 optional-content 查看器状态,渲染期间保持存活且不变 | nil |
全部数值限制必须为正;Scale 必须有限且不超过 64,MaxDepth 不得超过 256,MaxPNGBytes 必须能放入正的有符号 32 位值
即使 RenderAnnotations 为 false,Usage 也必须是 hruView 或 hruPrint;非法枚举值在提取权限 Callback 或输出发布之前失败
Usage 只改变注释可见性与变换;渲染器保留其提取权限契约,不授权打印
即使累计 MaxDecodedBytes 额度更大,单次解码读取仍受借入 access 限制、剩余内存额度与有符号 32 位 Callback 大小约束
字体解码在解析前预留保守的瞬时容量,包括 32 MiB 基础额度、64 倍解码字体流大小、递归检查的数组额度以及两倍保留的解码器估算
内存预算很小时即使小字体也可能被拒绝;原生库缓存与操作系统 RSS 不在托管核算之内
借入 access 的解码字节与深度限制可能施加额外界限;取消来自其调用方自有 Token
受支持的 profile 与输出契约参见 Native Linux Cairo renderer