PDFium Delphi Component Docs

Propiedades del gobernador de caché de TPdf

Componente: TPdf  ·  Unidades: PDFium, FPdfCache
Coordina las escenas de página retenidas, las miniaturas, los datos de estructura, las instantáneas de texto y las instantáneas de objetos de página bajo un único techo de bytes medible

CacheBudgetBytes

property CacheBudgetBytes: Int64; // default 256 MiB

Cambiar el valor se aplica de inmediato en todas las cachés participantes propiedad de esta instancia de TPdf

Establecer el valor en cero deshabilita la nueva retención y expulsa cada entrada inactiva

Los valores negativos lanzan EPdfError

Las escenas de página analizadas activas están fijadas y pueden mantener el uso medido temporalmente por encima de un presupuesto reducido hasta que el renderizado las libere

CacheGovernor

property CacheGovernor: TPdfCacheGovernor; // read-only, owned by TPdf

Devuelve el gobernador compartido para consultas de uso por tipo y coordinación opcional con cachés propiedad de la aplicación

No libere el objeto devuelto y no lo retenga después de que la instancia de TPdf propietaria sea destruida

Los llamadores pueden registrar entradas pckApplication a través de un participante que sigue el contrato de retrollamadas y ciclo de vida de FPdfCache

CacheGovernorStatistics

property CacheGovernorStatistics: TPdfCacheGovernorStatistics;

Devuelve los bytes medidos actuales y pico, los bytes fijados, el conteo de entradas, la actividad de reservas y toques, las expulsiones y las reservas rechazadas

La instantánea cubre solo las entradas retenidas de la caché de la biblioteca

Las copias de mapas de bits propiedad del llamador y las copias de instantáneas devueltas quedan fuera del presupuesto, mientras que las lecturas de flujos decodificados siguen siendo efímeras y conservan sus límites estrictos existentes por operación

Modelo de medición

Las cachés de mapas de bits usan ancho por alto por cuatro bytes

Las cachés de instantáneas administradas incluyen matrices de registros, cadenas, búferes de bytes, segmentos de ruta, datos de recorte, marcas, metadatos de imagen y valores anidados

Las escenas de página de PDFium analizadas son manejadores nativos opacos y reciben un cargo contable de 8 MiB por cada escena retenida en lugar de una afirmación del uso exacto del montón nativo

Example

var
  Stats: TPdfCacheGovernorStatistics;
begin
  Pdf.CacheBudgetBytes := Int64(128) * 1024 * 1024;
  Stats := Pdf.CacheGovernorStatistics;
  LogCacheUsage(Stats.StoredBytes, Stats.PeakStoredBytes,
    Pdf.CacheGovernor.UsageForKind(pckThumbnail));
end;

See Also

FPdfCache, Thumbnail cache, PageSceneCacheCapacity, Structure cache, Text snapshot cache, Page-object snapshot cache