PDFium Delphi Component Docs

TextSnapshotCacheCapacity Свойство

Компонент: TPdf  ·  Модуль: PDFium
Задаёт, сколько полных снимков текстовой страницы удерживает кэш текстовых снимков для повторного использования

Syntax

property TextSnapshotCacheCapacity: Integer; // read and write, default 8

Description

Чтение TextPageSnapshot снимает текст страницы, записи по символам и записи текстовых объектов с бюджетами по умолчанию. Кэш хранит по одному слоту на страницу документа и удерживает завершённые снимки в порядке LRU (наименее недавно использовавшихся) до этой ёмкости, так что повторное извлечение текста, чтение структурированного текста и проходы в порядке чтения используют одно снятие

Каждый удерживаемый снимок измеряется оценкой, покрывающей запись снимка, текст страницы, массивы символов и текстовых объектов и строки имён шрифтов, и резервирует эту оценку в общем регуляторе CacheBudgetBytes

Уменьшение ёмкости немедленно вытесняет наименее недавно использовавшиеся снимки и освобождает занятые ими байты регулятора

Remarks

Нулевая ёмкость очищает кэш и отключает удержание, при этом прямые ограниченные чтения через TextPageSnapshot и ReadTextPageSnapshot продолжают работать и просто снимают копию заново при каждом обращении

Отрицательные значения возбуждают EPdfError

Незавершённое снятие — то, у которого Status.Completed равно False из-за исчерпания бюджета символов, текстовых объектов или имён шрифтов, — возвращается вызывающему коду, но никогда не кэшируется

Example

Pdf.TextSnapshotCacheCapacity := 16;
Snapshot := Pdf.TextPageSnapshot[PageNumber];
LogSnapshotText(Snapshot.Text);

See Also

TextSnapshotCacheCount, TextSnapshotCacheHitCount, TextPageSnapshot, CacheBudgetBytes, TextPageSnapshots