HPDFRenderHeadlessPagePNGFile

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

Deklarováno v HPDFHeadlessCairoDevice; vyrenderuje jednu vypůjčenou stránku a atomicky publikuje její PNG do FileName

Nadřazený adresář už musí existovat; úspěšné volání nahradí existující cíl a vrátí jeho render počítadla

Access.RequireOutputPath je povinný a kontroluje zdrojovou cestu i fyzickou identitu souboru dřív před stagingem i před publikací; tenhle callback dodává GetRenderAccess dokumentu

Aliasy zdrojové cesty i source-hardlink se odmítají; vypůjčený dokument zůstává po celé volání načtený a beze změny

Helper výhradně vytvoří vlastněný staging soubor vedle cíle, zapíše dokončené PNG, flushne soubor, znovu zkontroluje zrušení a provede atomické přejmenování či náhradu

Selhání rozpočtu, renderu, zrušení i stagingu zachová existující cíl a smaže vlastněný nepublikovaný staging soubor

Windows používá nejvýše osm atomických náhrad a opakuje jen chyby 5, 32 a 33 s čekáním 1, 2, 4, 8, 16, 16 a 16 milisekund; všechny ostatní chyby selžou okamžitě

Zrušení se kontroluje před každým pokusem o náhradu i před a po každém čekání; jako fallback se nepoužívá mazání cíle ani neatomická kopie

Neúspěšná Windows náhrada vyhodí EHPDFHeadlessRenderError s zachyceným finálním Windows chybovým kódem; zrušení zachová cancellation diagnostiku rendereru

Pro streamy použijte HPDFRenderHeadlessPagePNG; formátové a zdrojové hranice popisuje průvodce rendererem