THPDFHeadlessRenderAccess
O record em HPDFHeadlessRenderAccess é retornado por THPDFHeadlessDocument.GetRenderAccess(PageIndex) para acesso serial somente leitura ao grafo atual do documento
O documento dono precisa permanecer carregado e inalterado durante todo o uso; ponteiros, dicionários de recursos e resultados de callbacks são emprestados, e os chamadores não devem liberá-los nem mutá-los
| Campo | Contrato |
|---|---|
Context | Ponteiro opaco do documento passado inalterado a cada callback |
PageDictionary, PageResources | Dicionário da página resolvido e dicionário de recursos herdado |
Resolve: THPDFHeadlessRenderResolve | Resolve um objeto emprestado pelos paths existentes de xref, object-stream e segurança |
ReadStream: THPDFHeadlessRenderReadStream | Retorna bytes decodificados com o máximo fornecido aplicado antes da decodificação, limitado pelo orçamento do documento |
ReadImageBytes: THPDFHeadlessRenderReadImage | Autentica e descriptografa um stream de imagem, decodifica filters de prefixo delimitados e retorna amostras decodificadas ou o payload final JPEG, JPEG 2000, CCITT ou JBIG2 junto do nome do filter terminal e do dicionário DecodeParms emprestado |
FontResolver: THPDFHeadlessRenderFontResolver | Cria uma interface para o decoder existente de fontes de recursos |
RequireExtractionPermission: THPDFHeadlessRenderPermission | Checa cancelamento e permissão autenticada de extração |
RequireOutputPath: THPDFHeadlessRenderOutputPath | Checa cancelamento e rejeita aliases da origem por caminho canônico e identidade física de arquivo, sem criar arquivo |
CancellationToken | Token de cancelamento do documento, emprestado e de posse do chamador |
MaxDecodedBytes, MaxDepth | Bounds superiores herdados das opções do documento |
CatalogDictionary: THPDFDictionaryObject empresta o catalog resolvido para configuração de optional content; nil significa que nenhum catalog foi fornecido e as estruturas de optional content não têm efeito de visibilidade
ResolveOptional: THPDFHeadlessRenderResolve resolve participações opcionais em grupos e retorna nil para referências ausentes, apagadas ou de geração velha; objetos vivos válidos retêm as checagens normais de parsing, object-stream, segurança, cancelamento e profundidade, e seus erros propagam
Inicialize records de acesso montados manualmente com Default(THPDFHeadlessRenderAccess) antes de atribuir callbacks; um ResolveOptional nil usa o resolver comum, e catalog nil preserva o rendering sem configuração de optional content
Renderers de saída precisam chamar RequireOutputPath(Context, FileName) antes de criar arquivo e aplicar suas próprias políticas de staging, publicação e orçamento de destino
Lifetime: IHPDFHeadlessRenderLifetime retém um lease de tempo de vida do grafo; nil permanece válido para rendering estático, enquanto viewer states explícitos exigem um lease válido e rejeitam acesso expirado antes de invocar callbacks
Uma view é inválida depois que o documento dono é fechado, recarregado, modificado ou destruído