Design DocumentsΒΆ Technical design documentation for osml-imagery-io internals. OversightML Imagery IO API Design: Tiled Image Pyramid Access Overview Core API Structure Asset Provider Hierarchy ImageAssetProvider Hierarchy GraphicsAssetProvider TextAssetProvider Writer API: Why Encoding Hints Use Metadata ImageOperation Pattern for Large Image Processing Format-Specific Implementations Parser Infrastructure (PyStructure Classes) Synthetic Codestream Codec Pattern The Problem The Pattern: Synthetic Codestream Reconstruction Precedent Format-Specific Details Why This Pattern Relationship to the Tile Index Pipeline Edge Tile Handling Security Considerations Summary Data-Driven Binary Parser Relationship to Kaitai Struct Architecture Overview Key Components Value Type Error Types Dependencies Repeated Field Access Example: NITF File Header Comparison with Kaitai Struct Property-Based Testing Framework Introduction Conceptual Model Property Categories Quality Thresholds Test Organization Shared Helpers Strategies Running Property Tests Extending for Future Formats Hypothesis Configuration Relationship to Unit Tests References Native Library FFI Design Overview Why Custom FFI Bindings Pinned Library Versions The libjpeg ABI Version Problem FFI Surface Area by Library Compile-Time Size Assertions Verification Procedure Process for Updating a C Library Version Historical Bugs