THPDFHeadlessRenderOptions

宣告於 HPDFHeadlessCairoDevice;調整個別限制之前,先以 Default 初始化

欄位意義預設
Scale: Double每個有效頁面點的像素數,含 UserUnit1
MaxPixels: Int64頁面表面或影像像素數(捨入後)上限16,777,216
MaxWorkingBytes: Int64活躍 managed 緩衝區與表面的保守准入量134,217,728
MaxDecodedBytes: Int64累計的解碼內容、影像與字型 stream 位元組33,554,432
MaxPNGBytes: Int64私下編碼的 PNG 大小33,554,432
MaxTokens: Integer有界 token 工作量與所選陣列計數500,000
MaxOperations: Integer累計派發的內容操作數500,000
MaxDepth: Integer遞迴、字型陣列與圖形堆疊深度32
RenderAnnotations: Booleanrender 可用的 normal 外觀 streamTrue
Usage: THPDFHeadlessRenderUsageview 或 print raster 輸出的標註可見性hruView
ViewerState: THPDFHeadlessOptionalContentState借用的明確optional-content 檢視器狀態,render 期間保持存活且不變nil

所有數值限制必須為正;Scale 必須為有限值且不超過 64,MaxDepth 不得超過 256,MaxPNGBytes 必須落在正的 signed 32 位元值內

Usage 必須是 hruView 或 hruPrint,即使 RenderAnnotations 為 false 也一樣;無效的 enum 值會在擷取權限 callback 或輸出發布之前失敗

Usage 只改變標註可見性與變換;renderer 保留其擷取權限契約,不授權列印

即使累計的 MaxDecodedBytes 額度更大,單次解碼讀取仍受借用的存取限制、剩餘記憶體額度與 signed 32 位元 callback 大小封頂

字型解碼在解析之前保留保守的暫時容量,包括 32 MiB 基礎額度、解碼字型 stream 大小的 64 倍、遞迴檢查的陣列額度,以及保留解碼器估算的兩倍

在很小的記憶體預算下,連小字型也可能被拒;原生程式庫快取與作業系統 RSS 不在 managed 記帳範圍內

借用的存取其解碼位元組與深度限制可能帶來額外界限;取消來自其呼叫端持有的 token

支援的設定檔與輸出契約請見原生 Linux Cairo renderer