HPDFRenderHeadlessPagePNGFile

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

Deklariert in HPDFHeadlessCairoDevice; rendert eine geliehene Seite und veröffentlicht ihr PNG atomar unter FileName

Das übergeordnete Verzeichnis muss bereits existieren; ein erfolgreicher Aufruf ersetzt ein vorhandenes Ziel und liefert seine Render-Zähler

Access.RequireOutputPath ist erforderlich und prüft Source-Pfad und physikalische Datei-Identität vor dem Staging und vor der Veröffentlichung; das GetRenderAccess des Dokuments liefert diesen Callback

Source-Pfad- und Source-Hardlink-Aliase werden zurückgewiesen; das geliehene Dokument bleibt während des Aufrufs geladen und unverändert

Der Helper legt exklusiv eine eigene Staging-Datei neben dem Ziel an, schreibt das fertige PNG, flusht die Datei, prüft erneut den Abbruch und führt ein atomares Umbenennen oder Ersetzen aus

Budget-, Rendering-, Abbruch- und Staging-Fehler bewahren ein vorhandenes Ziel und löschen die eigene, unveröffentlichte Staging-Datei

Windows nutzt höchstens acht atomare Ersetzungen und wiederholt nur die Fehler 5, 32 und 33 mit Wartezeiten von 1, 2, 4, 8, 16, 16 und 16 Millisekunden; alle anderen Fehler schlagen sofort fehl

Der Abbruch wird vor jedem Ersetzungsversuch sowie vor und nach jeder Wartezeit geprüft; weder Ziel-Löschung noch nicht-atomare Kopie dienen als Fallback

Eine fehlgeschlagene Windows-Ersetzung löst EHPDFHeadlessRenderError mit dem erfassten letzten Windows-Fehlercode aus; Abbruch bewahrt die Abbruch-Diagnose des Renderers

Für Streams nutze HPDFRenderHeadlessPagePNG; Format- und Ressourcengrenzen beschreibt der Renderer-Leitfaden