NEF on RawCull

Thumbnails and Scan Pipeline

Wed, 15 Jul 2026 00:00:00 +0000

Thumbnails and Scan Pipeline

RawCull separates catalog scanning, thumbnail preloading, UI-driven thumbnail requests, and full-size preview extraction. They share RawParserKit and disk-cache infrastructure, but they have deliberately different memory-admission rules.

The key current invariant is: catalog preloading warms the 200 px grid cache and disk cache, but only UI demand may admit an image to the preview-size RAM cache. This keeps scan order from displacing the images the user is actively viewing.

How RawParserKit Is Constructed

Thu, 30 Jul 2026 00:00:00 +0000

How RawParserKit Is Constructed

RawParserKit is RawCull’s camera-file boundary. It knows how Sony ARW and Nikon NEF files are structured, how to locate their embedded JPEGs and AF metadata, and how to turn those sources into orientation-normalized images and display-ready metadata.

The package stops at decoding. It does not score sharpness, generate embeddings, group bursts, cache application results, or decide which photo should be kept.

1. Begin With The Package Boundary

RawParserKit owns:

Sony/Nikon MakerNote Parser

Wed, 25 Mar 2026 00:00:00 +0000

Sony/Nikon MakerNote Parser

RawCull reads autofocus points and embedded JPEG locations directly from RAW metadata. This is implemented in RawParserKit, while the app consumes the parser through the vendor-neutral RawFormat protocol.

Source Map

Area	Files
Format protocol/registry	`RawParserKit/Sources/RawParserKit/RawFormat.swift`, `RawFormatRegistry.swift`
Sony parser	`SonyMakerNoteParser.swift`, `SonyRawFormat.swift`
Nikon parser	`NikonMakerNoteParser.swift`, `NikonRawFormat.swift`
Thumbnail/JPEG extractors	`SonyThumbnailExtractor.swift`, `NikonThumbnailExtractor.swift`, `JPGSonyARWExtractor.swift`, `JPGNikonNEFExtractor.swift`
Diagnostics	`RawParserDiagnostics.swift`, app `RawFileDiagnostics.swift`
App scan consumer	`Actors/ScanFiles.swift`
Focus-point normalization	`RawCullCore/Sources/RawCullCore/FocusPointParser.swift`
Tests	`RawParserKit/Tests/RawParserKitTests/`, `RawCullCore/Tests/RawCullCoreTests/FocusPointParserTests.swift`

Vendor-Neutral Contract

App code usually does not call SonyMakerNoteParser or NikonMakerNoteParser directly. It resolves a format first: