THPDFHeadlessRenderOptions

声明于 HPDFHeadlessCairoDevice;修改单个限额前先用 Default 初始化

字段含义默认值
Scale: Double每个有效页面点的像素数,含 UserUnit1
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: THPDFHeadlessRenderUsageview 或 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