THPDFCacheAdmissionPolicy 记录
描述一个渲染缓存层的准入策略:启用开关、自适应频率模式,以及条目数、总字节数和单条目字节数上限
声明
THPDFCacheAdmissionPolicy= record
Enabled: boolean;
AdaptiveAdmission: boolean;
MaxEntries: Integer;
MaxTotalBytes: Int64;
MaxEntryBytes: Int64;
end;
单元
HPDFDoc
字段
| 字段 | 用途 |
|---|---|
Enabled | 为该层打开准入控制;启用的策略必须携带正值上限,否则验证会抛出 ERangeError |
AdaptiveAdmission | 启用基于频率的自适应准入,让很少复用的条目直接被拒绝,而不是之后才被淘汰 |
MaxEntries | 缓存条目数上限,验证范围为 0 到 1000000;对栅格层而言它镜像 RenderCacheCapacity |
MaxTotalBytes | 缓存总字节数上限;对解码图像层而言它镜像 ImageCacheMaxBytes |
MaxEntryBytes | 单个可缓存条目的大小上限;不得超过 MaxTotalBytes,原始压缩层把它限制在 4096-16777216 字节 |
使用说明
- 每个
THPDFCacheLayerKind对应一条记录,通过THotPDF.SetCacheAdmissionPolicy配置;取值会经过校验并立即生效 - 用
THotPDF.GetCacheAdmissionPolicy读回当前生效的配置,它会复制所请求层的已存储策略 - 用
THotPDF.GetCacheAdmissionStatistics把这些上限与实际的命中、未命中和淘汰计数对比