HPDFRenderHeadlessPagePNGFile

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

宣告於 HPDFHeadlessCairoDevice;渲染一個借用頁面,並將其 PNG 原子式發布到 FileName

父目錄必須已存在;呼叫成功會取代既有目的地並回傳其渲染計數

Access.RequireOutputPath 為必要項,會在暫存前與發布前檢查來源路徑與實體檔案識別;文件的 GetRenderAccess 提供此 callback

來源路徑與來源硬連結別名會被拒絕;借用的文件在整個呼叫期間保持已載入且不變

輔助函式在目的地旁獨占建立自有的 staging 檔,寫入完成的 PNG、排清檔案、再次檢查取消,最後執行原子式改名或替換

預算、渲染、取消與暫存失敗會保留既有目的地,並刪除自有且未發布的 staging 檔

Windows 最多使用八次原子式替換,只對錯誤 5、32 與 33 重試,等待 1、2、4、8、16、16 與 16 毫秒;其他錯誤立即失敗

每次替換嘗試前與每次等待前後都檢查取消;不會以刪除目的地或非原子式複製作為後備

Windows 替換失敗會拋出 EHPDFHeadlessRenderError 並附最後捕捉到的 Windows 錯誤碼;取消則保留渲染器的取消診斷

串流目的地請使用 HPDFRenderHeadlessPagePNG;格式與資源邊界見 渲染器指南