EHPDFHeadlessRenderError

EHPDFHeadlessRenderError = class(Exception);

Declarada em HPDFHeadlessCairoDevice; reporta opções de renderização inválidas, orçamentos esgotados, cancelamento cooperativo, conteúdo não suportado, geometria de render malformada, Forms cíclicos e falhas de publicação

A exceção transporta uma mensagem de diagnóstico sem um código de erro enumerado estável; as aplicações devem evitar analisar a mensagem como se fosse um protocolo

Callbacks de documentos emprestados também podem levantar EHPDFHeadlessDocumentError, a ponte do runtime pode levantar EHPDFCairoError, e um destino próprio de quem chama pode levantar a sua própria exceção de I/O

Erros de orçamento, de conteúdo e de cancelamento ocorrem antes da publicação da stream; uma falha final de escrita da stream pode reter bytes aceites, enquanto o helper de ficheiros mantém o staging privado até à publicação atómica

As falhas deixam o documento fonte emprestado inalterado; quem chama mantém a propriedade do documento, do token e da stream de saída

Ver renderer Cairo nativo para Linux quanto ao âmbito e saída de ficheiro atómica quanto à preservação do destino