HPDFRenderHeadlessPagePNGFile

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

Déclaré dans HPDFHeadlessCairoDevice ; effectue le rendu d'une page empruntée et publie atomiquement son PNG vers FileName

Le répertoire parent doit exister au préalable ; un appel réussi remplace une destination existante et renvoie ses compteurs de rendu

Access.RequireOutputPath est obligatoire et vérifie le chemin du source et l'identité physique du fichier avant le staging et avant la publication ; le GetRenderAccess du document fournit ce callback

Les alias de chemin du source et de lien physique du source sont rejetés ; le document emprunté reste chargé et inchangé pendant tout l'appel

Le helper crée exclusivement un fichier de staging possédé à côté de la destination, y écrit le PNG complet, vide le fichier, revérifie l'annulation, puis effectue un rename ou un remplacement atomique

Les échecs de budget, de rendu, d'annulation et de staging préservent une destination existante et suppriment le fichier de staging possédé non publié

Windows utilise au plus huit remplacements atomiques, en ne réessayant que les erreurs 5, 32 et 33 avec des attentes de 1, 2, 4, 8, 16, 16 et 16 millisecondes ; toutes les autres erreurs échouent immédiatement

L'annulation est vérifiée avant chaque tentative de remplacement et avant et après chaque attente ; aucune suppression de destination ni copie non atomique n'est utilisée en repli

Un remplacement Windows en échec lève EHPDFHeadlessRenderError avec le code d'erreur Windows final capturé ; l'annulation préserve le diagnostic d'annulation du renderer

Pour les flux, utilisez HPDFRenderHeadlessPagePNG ; voir le guide du renderer pour les frontières de format et de ressources