https://techrawcull.netlify.app/tags/imageio/Recent content in Imageio on RawCullHugoenThu, 30 Jul 2026 08:19:52 +0200https://techrawcull.netlify.app/docs/packages/rawparserkit/Thu, 30 Jul 2026 00:00:00 +0000https://techrawcull.netlify.app/docs/packages/rawparserkit/<h1 id="how-rawparserkit-is-constructed">How RawParserKit Is Constructed<a class="td-heading-self-link" href="#how-rawparserkit-is-constructed" aria-label="Heading self-link"></a></h1> <p>RawParserKit is RawCull&rsquo;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.</p> <p>The package stops at decoding. It does not score sharpness, generate embeddings, group bursts, cache application results, or decide which photo should be kept.</p> <h2 id="1-begin-with-the-package-boundary">1. Begin With The Package Boundary<a class="td-heading-self-link" href="#1-begin-with-the-package-boundary" aria-label="Heading self-link"></a></h2> <p>RawParserKit owns:</p>https://techrawcull.netlify.app/docs/heavy/Tue, 19 May 2026 00:00:00 +0000https://techrawcull.netlify.app/docs/heavy/<h1 id="synchronous-code">Synchronous Code<a class="td-heading-self-link" href="#synchronous-code" aria-label="Heading self-link"></a></h1> <p>Most RawCull code uses async/await, actors, and task groups. Some Apple framework work is still fundamentally synchronous: ImageIO thumbnail decode, CoreImage RAW rendering, JPEG encoding, and direct binary MakerNote parsing. This page explains where that work lives and how the app keeps it from freezing the UI or starving Swift&rsquo;s cooperative executor.</p> <h2 id="source-map">Source Map<a class="td-heading-self-link" href="#source-map" aria-label="Heading self-link"></a></h2> <table> <thead> <tr> <th>Area</th> <th>Files</th> </tr> </thead> <tbody> <tr> <td>Cancellation-aware blocking bridge</td> <td><code>RawParserKit/Sources/RawParserKit/CancellableImageIOWork.swift</code></td> </tr> <tr> <td>Thumbnail extraction</td> <td><code>SonyThumbnailExtractor.swift</code>, <code>NikonThumbnailExtractor.swift</code></td> </tr> <tr> <td>Embedded JPEG extraction</td> <td><code>JPGSonyARWExtractor.swift</code>, <code>JPGNikonNEFExtractor.swift</code>, <code>SonyRAWJPEGCreator.swift</code></td> </tr> <tr> <td>MakerNote parsing</td> <td><code>SonyMakerNoteParser.swift</code>, <code>NikonMakerNoteParser.swift</code></td> </tr> <tr> <td>App callers</td> <td><code>RequestThumbnail.swift</code>, <code>ScanAndCreateThumbnails.swift</code>, <code>ExtractAndSaveJPGs.swift</code>, <code>ScanAndExtractJPGs.swift</code>, <code>ZoomPreviewHandler.swift</code></td> </tr> <tr> <td>Sharpness scoring</td> <td><code>FocusMaskEngine+Scoring.swift</code>, <code>FocusMaskEngine+MaskGeneration.swift</code></td> </tr> </tbody> </table> <h2 id="why-blocking-work-matters">Why Blocking Work Matters<a class="td-heading-self-link" href="#why-blocking-work-matters" aria-label="Heading self-link"></a></h2> <p>Swift&rsquo;s cooperative thread pool expects async tasks to suspend instead of occupying threads for long periods. ImageIO and CoreImage calls often do not suspend; they block until decode/render work is done.</p>