THotPDF.RenderCacheFolder

THotPDF

指定为性能优化而存储已渲染页面缓存瓦片的磁盘目录路径

Delphi syntax:

property RenderCacheFolder: string read FRenderCacheFolder write FRenderCacheFolder;

Description

指定为性能优化而存储已渲染页面缓存瓦片的磁盘目录路径

该目录必须对应用程序进程具有适当的读/写权限

留空则使用仅内存的页面渲染缓存

路径是 Unicode 字符串，名称包含系统代码页之外字符的文件夹会按原样使用

页面图像和缓存索引以原子方式替换，写入中断不会暴露写了一半的 PNG，也不会截断先前的索引

成功的页面读取会刷新页面级近期使用状态；上限被调小时，文档和字节上限会立即驱逐最久未使用的条目

损坏的页面图像、过期的索引行、遗留的临时文件和未索引的文档文件夹会在缓存打开或读取时自动修复

无效的文档键、页面索引和 DPI 值会在创建路径之前被拒绝

缓存页面以已加载源的身份为键：从文件加载的文档由其大小、最后写入时间以及开头和结尾处的字节标识，因此该属性在加载之前或之后设置都可以；从流或随机访问源加载的文档会在加载过程中计算哈希，这类文档要在调用加载方法之前设置该属性

加密文档不会写入磁盘缓存；已加载文档一经编辑，本次会话就不再读写磁盘缓存，未修改文件的条目对后续会话仍然有效

渲染后端和 ICC 打样设置属于磁盘键的一部分，因此改动它们不会返回按先前设置渲染的页面

See also: THotPDF、缓存基础结构