THotPDF.RenderCacheFolder

THotPDF

Specifies the disk directory path where rendered page cache tiles are stored for performance optimization

Delphi syntax:

property RenderCacheFolder: string read FRenderCacheFolder write FRenderCacheFolder;

Description

Specifies the disk directory path where rendered page cache tiles are stored for performance optimization

The directory must have appropriate read/write permissions for the application process

Leave empty to use memory-only page rendering caching

The path is a Unicode string, so folders whose names contain characters outside the system code page are used as given

Page images and the cache index are replaced atomically so an interrupted write cannot expose a partially written PNG or truncate the previous index

Successful page reads refresh page-level recency, and document and byte limits evict the least recently used entries immediately when a limit is reduced

Corrupt page images, stale index rows, abandoned temporary files, and unindexed document folders are repaired automatically when the cache is opened or read

Invalid document keys, page indexes, and DPI values are rejected before a path is created

Cached pages are keyed by the identity of the loaded source: a document loaded from a file is identified by its size, last-write time and the bytes at its start and end, so set this property before or after loading as you like; a document loaded from a stream or a random-access source is hashed while it loads, so set this property before calling the load method for such documents

Encrypted documents are not written to the disk cache, and once a loaded document is edited the disk cache is no longer read or written for that session; entries for the unmodified file stay valid for later sessions

The rendering backend and the ICC proofing settings are part of the disk key, so changing them does not return pages rendered with the previous settings

See also: THotPDF, Cache Infrastructure