opencodecs 0.1.7__tar.gz → 0.1.9__tar.gz

{opencodecs-0.1.7 → opencodecs-0.1.9}/CHANGES.rst

@@ -10,6 +10,81 @@ Versions follow the same ``YYYY.M.D`` cadence as upstream when we
 publish; the entries below cluster work by date rather than by
 release because most of it has shipped continuously to ``main``.
 
+0.1.9 (2026-06-02)
+------------------
+
+**Lossless SDR base layer on encode (opt-in)**
+
+``opencodecs.codecs._jpeg.encode`` gained a ``lossless=False`` kwarg
+that switches libjpeg-turbo into predictive lossless mode
+(``TJPARAM_LOSSLESS=1``, PSV=1, forced 4:4:4 chroma). Output is
+bit-exact through the libjpeg-turbo decoder, at the cost of ~3-5×
+larger files vs ``level=95`` baseline DCT on natural-image content.
+
+``opencodecs.uhdr.encode_native(lossless=True)`` routes the SDR base
+layer through that lossless path while keeping the gain map lossy
+(there's no perceptual benefit to making a band-limited gain map
+lossless, and it would balloon the file).
+
+Empirical caveats — verified on macOS 15 with an HDR-capable
+display:
+
+* macOS Preview, Chrome 116+, and any viewer that parses the MPF /
+  XMP gain-map block directly **HDR-render the output normally**.
+* libuhdr's reference ``uhdr_decode`` (and therefore
+  ``opencodecs.uhdr.decode``) **rejects** the file. It enforces a
+  strict ``JCS_YCbCr`` / ``JCS_GRAYSCALE`` colorspace check that
+  lossless-mode JPEG (which writes ``JCS_RGB``) fails.
+* Apple's ``CGImageSource`` ``Headroom`` property and
+  ``kCGImageAuxiliaryDataTypeISOGainMap`` aux-data accessors miss
+  the HDR signal (same root cause), even though Preview's actual
+  render path composites the gain map correctly.
+* ``opencodecs.uhdr.decode_native`` reads it cleanly — it uses our
+  own gain-application kernel without libuhdr's colorspace gate.
+
+Use only when exact SDR-base-pixel preservation is a hard
+requirement (archival, scientific imaging) and every consumer in
+your pipeline is either Preview / Chrome / ``decode_native``. The
+``v0.1.8`` note that called lossless "not a conforming Ultra-HDR
+file" was too strong — it's non-conforming to libuhdr's reference
+decoder and Apple's narrow ImageIO API, but visual HDR consumers
+accept it just fine.
+
+0.1.8 (2026-06-02)
+------------------
+
+**DCT-domain decode-time scale on JPEG + decode_native**
+
+``opencodecs.codecs._jpeg.decode`` now exposes libjpeg-turbo's
+``tj3SetScalingFactor`` knob via a new ``scale=`` kwarg (plus
+explicit ``scale_num`` / ``scale_denom`` for advanced callers). The
+decoder skips the inverse-DCT work for high-frequency coefficients
+when the caller requests a downsampled output, so a 1/8 decode runs
+~2× faster than a full decode and produces a 64× smaller raster.
+
+Supported factors are libjpeg-turbo's full set of 16 ratios N/8 for
+N ∈ {1, 2, …, 16} — i.e. anywhere between 1/8 and 2/1. The new
+``opencodecs.codecs._jpeg.supported_scaling_factors()`` returns them
+as ``(num, denom)`` pairs. ``scale=`` accepts:
+
+* an integer N (interpreted as ``1/N``)
+* a float (snapped to the closest supported ratio)
+* a tuple ``(num, denom)`` verbatim
+
+``opencodecs.uhdr.decode_native(..., scale=...)`` threads the same
+knob through both the SDR base and the gain-map JPEG decodes. The
+gain-application kernel runs on the smaller rasters, so the whole
+pipeline scales — a 2k² Ultra-HDR decode at ``scale=8`` returns a
+``(250, 250, 3)`` fp16 raster in ~25 ms vs ~53 ms for the full
+decode. Useful for thumbnail / preview pipelines that want real
+HDR pixels off cloud-stored Ultra-HDR without paying the megapixel
+JPEG decode cost. Lossless source not required — the JPEG file is
+unchanged on disk; the savings come from skipping IDCT work.
+
+(libuhdr lossless support is unchanged: ISO 21496-1's SDR base layer
+is required to be baseline DCT JPEG, so lossless-mode JPEG would
+not be a conforming Ultra-HDR file.)
+
 0.1.7 (2026-06-02)
 ------------------
 

{opencodecs-0.1.7/src/opencodecs.egg-info → opencodecs-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencodecs
-Version: 0.1.7
+Version: 0.1.9
 Summary: Streaming, network-aware image codecs for scientific imaging (prototype: JPEG XL)
 Author: Kevin Cutler
 License: BSD-3-Clause

{opencodecs-0.1.7 → opencodecs-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opencodecs"
-version = "0.1.7"
+version = "0.1.9"
 description = "Streaming, network-aware image codecs for scientific imaging (prototype: JPEG XL)"
 readme = "README.md"
 requires-python = ">=3.10"

{opencodecs-0.1.7 → opencodecs-0.1.9}/src/opencodecs/__init__.py

@@ -191,4 +191,4 @@ __all__ = [
     "CziWriter", "CziPyramidWriter",
 ]
 
-__version__ = "0.1.7"
+__version__ = "0.1.9"