THPDFHeadlessRenderOptions
宣告於 HPDFHeadlessCairoDevice;調整個別限制之前,先以 Default 初始化
| 欄位 | 意義 | 預設 |
|---|---|---|
Scale: Double | 每個有效頁面點的像素數,含 UserUnit | 1 |
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: Boolean | render 可用的 normal 外觀 stream | True |
Usage: THPDFHeadlessRenderUsage | view 或 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