THPDFHeadlessRenderAccess

HPDFHeadlessRenderAccess 中的记录由 THPDFHeadlessDocument.GetRenderAccess(PageIndex) 返回,用于对当前文档对象图的串行只读访问

使用期间所属文档必须保持加载且未被修改;指针、资源字典与 Callback 结果都是借用的,调用方不得释放或修改

字段约定
Context不透明文档指针,原样传给每个 Callback
PageDictionary, PageResources已解析的页面字典与继承的资源字典
Resolve: THPDFHeadlessRenderResolve通过既有 xref、对象流与安全路径解析借用对象
ReadStream: THPDFHeadlessRenderReadStream返回解码字节,解码前先应用给定上限,并受文档预算约束
ReadImageBytes: THPDFHeadlessRenderReadImage认证并解密图像流,解码有界前缀过滤器,返回解码样本或最终 JPEG、JPEG 2000、CCITT、JBIG2 载荷,连同末端过滤器名与借用的 DecodeParms 字典
FontResolver: THPDFHeadlessRenderFontResolver为既有资源字体解码器创建接口
RequireExtractionPermission: THPDFHeadlessRenderPermission检查取消与已认证的提取权限
RequireOutputPath: THPDFHeadlessRenderOutputPath检查取消,并按规范路径与物理文件同一性拒绝源别名,不创建文件
CancellationToken借用的调用方自有文档取消 Token
MaxDecodedBytes, MaxDepth从文档选项继承的上限

CatalogDictionary: THPDFDictionaryObject 出借已解析的 catalog 用于 optional-content 配置;nil 表示未提供 catalog,optional-content 结构对可见性没有影响

ResolveOptional: THPDFHeadlessRenderResolve 解析可选组成员关系,缺失、已删除或过期 generation 的引用返回 nil;有效的存活对象保留常规解析、对象流、安全、取消与深度检查,错误照常传播

手工组装的 access 记录在赋 Callback 前先用 Default(THPDFHeadlessRenderAccess) 初始化;nil 的 ResolveOptional 使用普通 resolver,nil catalog 保持渲染但不做 optional-content 配置

输出渲染器必须在创建文件前调用 RequireOutputPath(Context, FileName),并应用自己的 staging、发布与目标预算策略

Lifetime: IHPDFHeadlessRenderLifetime 持有 graph-lifetime lease;静态渲染允许 nil,显式查看器状态要求有效 lease,并在调用 Callback 前拒绝已过期的 access

所属文档被关闭、重新加载、修改或销毁后视图即失效