Memory Cache

Tue, 19 May 2026 00:00:00 +0000

Cache System

RawCull uses several caches because RAW decoding is expensive and because different UI surfaces need different image sizes. The normal thumbnail path is layered RAM -> disk -> RAW extraction. The zoom path has its own disk cache for larger embedded JPEGs. Burst analysis has a separate JSON cache for derived analysis data.

Source Map

Cache	Main files	Stores
Preview memory cache	`Actors/SharedMemoryCache.swift`, `Model/Cache/CachedThumbnail.swift`	Larger `NSImage` thumbnails for detail/loupe use
Grid memory cache	`Actors/SharedMemoryCache.swift`	Small grid thumbnails, downscaled before insertion
Thumbnail disk cache	`Actors/DiskCacheManager.swift`	JPEG thumbnail files under the app cache directory
Full-size JPEG disk cache	`Actors/FullSizeJPGDiskCache.swift`, `Model/Handlers/ZoomPreviewHandler.swift`	Larger embedded JPEG previews for zoom
Burst analysis cache	`Actors/BurstAnalysisCache.swift`	JSON snapshots of embeddings, scores, groups, rankings, and review state
Diagnostics	`Model/Cache/CacheDelegate.swift`, `Model/Cache/CacheStatistics.swift`, `Views/Diagnostics/MemoryDiagnosticsView.swift`	Hit/miss/eviction/pressure counters

Thumbnail Lookup

flowchart TD
 A["Request thumbnail"] --> B{"Preview memory cache?"}
 B -->|"hit"| C["Return NSImage"]
 B -->|"miss"| D{"Disk thumbnail cache?"}
 D -->|"hit"| E["Decode JPEG and refill memory"]
 D -->|"miss"| F["RawParserKit extractThumbnail"]
 F --> G["Create NSImage"]
 G --> H["Store preview memory"]
 G --> I["Store grid memory copy"]
 G --> J["Save disk JPEG"]

The same lookup idea is used by preload and on-demand requests. ScanAndCreateThumbnails warms the cache after a catalog opens. ThumbnailLoader and RequestThumbnail resolve individual thumbnails while the user scrolls.

Memory on RawCull

Memory Cache

Cache System

Source Map

Thumbnail Lookup