HPDFRenderHeadlessPagePNGFile

function HPDFRenderHeadlessPagePNGFile(const Access: THPDFHeadlessRenderAccess;
  const FileName: string; const Options: THPDFHeadlessRenderOptions):
  THPDFHeadlessRenderResult;

Declarado en HPDFHeadlessCairoDevice; renderiza una página prestada y publica atómicamente su PNG en FileName

El directorio padre debe existir previamente; una llamada exitosa reemplaza un destino existente y devuelve sus contadores de render

Access.RequireOutputPath es obligatorio y comprueba la ruta de la fuente y la identidad física del archivo antes del staging y antes de la publicación; el GetRenderAccess del documento suministra este callback

Los alias de ruta de fuente y de hardlink de fuente se rechazan; el documento prestado permanece cargado y sin cambios durante toda la llamada

El helper crea en exclusiva un archivo de staging propio junto al destino, escribe el PNG completo, vuelca el archivo, vuelve a comprobar la cancelación y realiza un rename o reemplazo atómico

Los fallos de presupuesto, rendering, cancelación y staging preservan un destino existente y borran el archivo de staging propio no publicado

Windows usa como máximo ocho reemplazos atómicos, reintentando solo los errores 5, 32 y 33 con esperas de 1, 2, 4, 8, 16, 16 y 16 milisegundos; todos los demás errores fallan inmediatamente

La cancelación se comprueba antes de cada intento de reemplazo y antes y después de cada espera; no se usa borrado del destino ni copia no atómica como fallback

Un reemplazo de Windows fallido lanza EHPDFHeadlessRenderError con el código de error final de Windows capturado; la cancelación preserva el diagnóstico de cancelación del renderer

Para streams use HPDFRenderHeadlessPagePNG; véase la guía del renderer para las fronteras de formato y recursos