opencodecs 0.1.13__tar.gz → 0.2.0__tar.gz

opencodecs-0.2.0/3rdparty/VENDOR.toml

@@ -0,0 +1,216 @@
+# Provenance for the source vendored under 3rdparty/.
+#
+# Why this file exists: vendored code drifts silently. Nothing tells you
+# upstream fixed something. That is not hypothetical here, it is how
+# PLIO shipped a decoder that died with SIGBUS on malformed input, long
+# after upstream cfitsio had added the bounds checks that prevent it.
+#
+# ci/check_vendor_drift.py reads this to answer two different questions:
+#
+#   1. Have WE changed the file since vendoring it? (offline, from
+#      local_sha256; a test enforces this so an accidental edit to a
+#      vendored file cannot pass unnoticed.)
+#   2. Has UPSTREAM changed it since? (online: re-fetch at the pinned
+#      ref, and look for newer releases.)
+#
+# `modified = true` means we deliberately diverge from upstream, and the
+# note says why. Those are the files where a blind upstream update would
+# lose something.
+
+schema = 1
+
+# ---------------------------------------------------------------------
+# Our own code. Listed so the "is every vendored file accounted for?"
+# check can pass, and so nobody mistakes it for somebody else's work.
+# ---------------------------------------------------------------------
+
+[[component]]
+name = "oc_eer"
+upstream = "none"
+note = "Written for opencodecs. Clean-room EER decoder; no upstream."
+
+[[component]]
+name = "oc_tifflzw"
+upstream = "none"
+note = "Written for opencodecs. TIFF 6.0 LZW encoder; no upstream."
+
+[[component]]
+name = "oc_giflzw"
+upstream = "none"
+note = "Written for opencodecs. GIF LZW; no upstream."
+
+# ---------------------------------------------------------------------
+# Third-party source with a live upstream.
+# ---------------------------------------------------------------------
+
+[[component]]
+name = "bcdec"
+repo = "iOrange/bcdec"
+ref = "80859ed3b7afb1c527a2a99d70c61457bea72d0c"
+license = "MIT OR Unlicense"
+note = """Single-header BCn decoder. bcdec publishes no tags, so the ref \
+is a commit: that is what makes `check` able to say anything, since a \
+moving branch gives it nothing fixed to compare against. This commit is \
+v0.985, "fixed potential unaligned reads" -- taken because the previous \
+pin predated it and the fix is a real portability one, replacing \
+multi-byte casts with byte-wise readers."""
+  [[component.file]]
+  local = "3rdparty/bcdec/bcdec.h"
+  upstream = "bcdec.h"
+  modified = true
+  note = """Upstream at the pinned commit, plus one six-line comment on \
+the BC4/BC5 signed path and trailing whitespace stripped. Verified by \
+reconstruction: our file with that comment removed and trailing \
+whitespace normalized is byte-identical to upstream."""
+
+[[component]]
+name = "bitshuffle"
+repo = "kiyo-masui/bitshuffle"
+ref = "0.5.2"
+license = "MIT"
+note = """The two core files track upstream master rather than the 0.5.2 \
+tag, because 0.5.2 predates Masui's rewritten NEON bit transpose \
+(neonmovemask_bulk) and the MSVC may_alias typedef. Those are upstream \
+work, not ours and not a third party's; an earlier reading of this file \
+said otherwise and was wrong. The other five files are pristine 0.5.2."""
+  [[component.file]]
+  local = "3rdparty/bitshuffle/bitshuffle_core.c"
+  upstream = "src/bitshuffle_core.c"
+  ref = "526440a16baf"
+  modified = true
+  note = """Upstream master at 526440a16baf plus exactly three \
+(uint8_t) narrowing casts, at the two bit-transpose stores and the \
+uint64 branch of bshuf_write_uint64_BE. They silence MSVC C4244; the \
+truncation is intended in all three, the value is masked to a byte \
+already. Re-derived from upstream in 2026-09 so this delta is three \
+lines that can be read, rather than a file nobody could account for. \
+Worth sending upstream."""
+  [[component.file]]
+  local = "3rdparty/bitshuffle/bitshuffle_core.h"
+  upstream = "src/bitshuffle_core.h"
+  ref = "526440a16baf"
+  modified = true
+  note = """Upstream master, except the BSHUF_VERSION macros, which \
+upstream left at 0.4.0 on master; ours say 0.5.2 to match the released \
+version the rest of this directory tracks."""
+  [[component.file]]
+  local = "3rdparty/bitshuffle/iochain.c"
+  upstream = "src/iochain.c"
+  [[component.file]]
+  local = "3rdparty/bitshuffle/iochain.h"
+  upstream = "src/iochain.h"
+  [[component.file]]
+  local = "3rdparty/bitshuffle/bitshuffle.c"
+  upstream = "src/bitshuffle.c"
+  [[component.file]]
+  local = "3rdparty/bitshuffle/bitshuffle.h"
+  upstream = "src/bitshuffle.h"
+  [[component.file]]
+  local = "3rdparty/bitshuffle/bitshuffle_internals.h"
+  upstream = "src/bitshuffle_internals.h"
+
+[[component]]
+name = "cfitsio"
+repo = "HEASARC/cfitsio"
+ref = "cfitsio-4.7.0"
+license = "NASA permissive"
+note = """The component that motivated this file. pliocomp.c was behind \
+upstream by the commit that added its srclen bounds checks, and the \
+stale copy crashed. Re-check on every cfitsio release."""
+  [[component.file]]
+  local = "3rdparty/cfitsio/pliocomp.c"
+  upstream = "pliocomp.c"
+  [[component.file]]
+  local = "3rdparty/cfitsio/fits_hcompress.c"
+  upstream = "fits_hcompress.c"
+  [[component.file]]
+  local = "3rdparty/cfitsio/fits_hdecompress.c"
+  upstream = "fits_hdecompress.c"
+  ref = "cfitsio-4.6.4"
+  modified = true
+  note = """4.6.4, one release behind the rest of this directory. Checked: \
+4.6.4 -> 4.7.0 changed only comments describing the `na` parameter, so there \
+is no fix being missed. Bump with the next real change.
+
+One local patch, three lines: the file-scope `nextchar`, `buffer2` and \
+`bits_to_go` are marked thread-local. They are the bit reader's position, \
+not shared configuration, and cfitsio never intended two decodes to \
+overlap -- but the tiles of one compressed FITS HDU are independent \
+codestreams and we decode them on a thread pool, which corrupts that state \
+and returns status=414 on every tile after the first. Single-threaded \
+behavior is unchanged. Carry the patch forward on any update; the macro is \
+OC_THREAD_LOCAL, defined next to the min/max compatibility defines."""
+  [[component.file]]
+  local = "3rdparty/cfitsio/ricecomp.c"
+  upstream = "ricecomp.c"
+  modified = true
+  note = """Keeps the error-code return convention an earlier vendoring \
+introduced, because our binding depends on it, with upstream's \
+buffer-size guard applied on top. A blind update would break the \
+binding; port the fix, do not overwrite."""
+  # These three live in this directory but are opencodecs code, not
+  # cfitsio's. ours = true means the drift check tracks them for
+  # accidental edits but never compares them to upstream.
+  [[component.file]]
+  local = "3rdparty/cfitsio/fitsio2.h"
+  ours = true
+  note = """A 50-line stub standing in for the cfitsio internals the two \
+hcompress sources reference (LONGLONG, ffpmsg, FFLOCK), so they build \
+without dragging in the rest of the library."""
+  [[component.file]]
+  local = "3rdparty/cfitsio/fits_hdecompress_api.h"
+  ours = true
+  note = "Declares the decode entry points for our binding; cfitsio ships none."
+  [[component.file]]
+  local = "3rdparty/cfitsio/ricecomp.h"
+  ours = true
+  note = """Declares the Rice entry points and the negative error codes \
+ricecomp.c returns. Rewritten 2026-09: the drift audit found the \
+previous copy byte-identical to the one in imagecodecs, which is not \
+upstream cfitsio's file but a third project's, and this repository is \
+meant to carry none of it."""
+
+[[component]]
+name = "libspng"
+repo = "randy408/libspng"
+ref = "v0.7.4"
+license = "BSD-2-Clause"
+  [[component.file]]
+  local = "3rdparty/libspng/spng.c"
+  upstream = "spng/spng.c"
+  modified = true
+  note = """Carries three opencodecs changes: the grayscale-defilter \
+patch, the filter_sum_* family (one function per filter instead of a \
+switch inside the per-byte loop), and the matching filter_scanline_* \
+family. The last two are the same transformation applied to the two \
+halves of the encode filter path; both are branch hoisting, and both \
+produce byte-identical output to the code they replaced."""
+  [[component.file]]
+  local = "3rdparty/libspng/spng.h"
+  upstream = "spng/spng.h"
+
+[[component]]
+name = "qoi"
+repo = "phoboslab/qoi"
+ref = "4ab68bbd20618a663255625160c40875713f5485"
+license = "MIT"
+note = """Single header, frozen format. qoi publishes no tags, so the \
+ref is a commit rather than a version -- a moving branch would leave \
+`check` with nothing fixed to compare against."""
+  [[component.file]]
+  local = "3rdparty/qoi/qoi.h"
+  upstream = "qoi.h"
+  modified = true
+  note = """Identical to upstream at the pinned commit except for \
+trailing whitespace on line 583, where upstream has two tabs on an \
+otherwise empty line."""
+
+[[component]]
+name = "rgbe"
+upstream = "none"
+license = "no formal grant; see 3rdparty/rgbe/rgbe.txt"
+note = """No upstream to track. The Radiance format was frozen in 1991 \
+and every maintained implementation descends from Bruce Walter's 1995 \
+reference. This copy carries fixes from Mentey and Gohlke plus \
+opencodecs changes to the exponent conversion and resolution-line \
+parsing. See THIRD-PARTY.md; do not drop the credited fixes."""

opencodecs-0.2.0/3rdparty/bcdec/LICENSE

@@ -0,0 +1,52 @@
+This software is available under 2 licenses -- choose whichever you prefer.
+
+------------------------------------------------------------------------------
+ALTERNATIVE A - MIT License
+
+Copyright (c) 2022 Sergii Kudlai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+------------------------------------------------------------------------------
+ALTERNATIVE B - The Unlicense
+
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

opencodecs-0.2.0/3rdparty/bcdec/README.md

@@ -0,0 +1,46 @@
+# bcdec
+Small header-only C library to decompress any BC compressed image inspired by incredible stb libaries (<http://nothings.org/stb>)
+
+Written by Sergii *"iOrange"* Kudlai in 2022.
+
+This library provides functions to decompress blocks of BC compressed images.
+
+This library does not allocate memory and is trying to use as less stack as possible.
+
+The library was never optimized specifically for speed but for the overall size.
+It has zero external dependencies and is not using any runtime functions.
+
+### Supported BC formats:
+- BC1 (also known as DXT1) + it's "binary alpha" variant BC1A (DXT1A)
+- BC2 (also known as DXT3)
+- BC3 (also known as DXT5)
+- BC4 (also known as ATI1N)
+- BC5 (also known as ATI2N)
+- BC6H (HDR format)
+- BC7
+
+---
+
+BC1/BC2/BC3/BC7 are expected to decompress into 4\*4 RGBA blocks 8bit per component (32bit pixel)
+BC4/BC5 are expected to decompress into 4\*4 R/RG blocks 8bit per component (8bit and 16bit pixel)
+BC6H is expected to decompress into 4*4 RGB blocks of either 32bit float or 16bit "half" per
+component (96bit or 48bit pixel)
+
+---
+
+You will also find included test program that converts compressed DDS files into TGA/HDR.
+It is a good start to learn on how to use the **bcdec** library.
+It comes with some test images in the *test_images* folder and a batch script *test_bcdec.bat* to run over them.
+
+---
+
+Used HDRI image "Lythwood Room" from <https://polyhaven.com/a/lythwood_room> licensed under CC0 license.
+
+---
+
+### CREDITS:
+ - Aras Pranckevičius (@aras-p)
+     - BC1/BC3 decoders optimizations (up to 3x the speed)
+     - BC6H/BC7 bits pulling routines optimizations
+     - optimized BC6H by moving unquantize out of the loop
+     - Split BC6H decompression function into 'half' and 'float' variants

{opencodecs-0.1.13 → opencodecs-0.2.0}/3rdparty/bcdec/bcdec.h

@@ -1,12 +1,14 @@
-/* bcdec.h - v0.97
+/* bcdec.h - v0.985
    provides functions to decompress blocks of BC compressed images
    written by Sergii "iOrange" Kudlai in 2022
 
    This library does not allocate memory and is trying to use as less stack as possible
 
-   The library was never optimized specifically for speed but for the overall size
+   This library was never optimized specifically for speed but for the overall size
    it has zero external dependencies and is not using any runtime functions
 
+   This library was writtem by humans and will never contain any LLM-generated code
+
    Supported BC formats:
    BC1 (also known as DXT1) + it's "binary alpha" variant BC1A (DXT1A)
    BC2 (also known as DXT3)
@@ -41,6 +43,7 @@
 
    bugfixes:
       @linkmauve
+      @wkjarosz
 
    LICENSE: See end of file for license information.
 */
@@ -49,7 +52,7 @@
 #define BCDEC_HEADER_INCLUDED
 
 #define BCDEC_VERSION_MAJOR 0
-#define BCDEC_VERSION_MINOR 98
+#define BCDEC_VERSION_MINOR 985
 
 /* if BCDEC_STATIC causes problems, try defining BCDECDEF to 'inline' or 'static inline' */
 #ifndef BCDECDEF
@@ -119,6 +122,22 @@ BCDECDEF void bcdec_bc7(const void* compressedBlock, void* decompressedBlock, in
 
 #ifdef BCDEC_IMPLEMENTATION
 
+static unsigned short bcdec__getu16le(const void* s) {
+    unsigned short l = (unsigned short)((const unsigned char*)s)[0];
+    unsigned short h = (unsigned short)((const unsigned char*)s)[1];
+    return l | (h << 8);
+}
+static unsigned int bcdec__getu32le(const void* s) {
+    unsigned int l = bcdec__getu16le(s);
+    unsigned int h = bcdec__getu16le((const unsigned char*)s + 2);
+    return l | (h << 16);
+}
+static unsigned long long bcdec__getu64le(const void* s) {
+    unsigned long long l = bcdec__getu32le(s);
+    unsigned long long h = bcdec__getu32le((const unsigned char*)s + 4);
+    return l | (h << 32);
+}
+
 static void bcdec__color_block(const void* compressedBlock, void* decompressedBlock, int destinationPitch, int onlyOpaqueMode) {
     unsigned short c0, c1;
     unsigned int refColors[4]; /* 0xAABBGGRR */
@@ -127,8 +146,8 @@ static void bcdec__color_block(const void* compressedBlock, void* decompressedBl
     int i, j, idx;
     unsigned int r0, g0, b0, r1, g1, b1, r, g, b;
 
-    c0 = ((unsigned short*)compressedBlock)[0];
-    c1 = ((unsigned short*)compressedBlock)[1];
+    c0 = bcdec__getu16le(compressedBlock);
+    c1 = bcdec__getu16le((const unsigned char*)compressedBlock + 2);
 
     /* Unpack 565 ref colors */
     r0 = (c0 >> 11) & 0x1F;
@@ -173,7 +192,7 @@ static void bcdec__color_block(const void* compressedBlock, void* decompressedBl
         refColors[3] = 0x00000000;
     }
 
-    colorIndices = ((unsigned int*)compressedBlock)[1];
+    colorIndices = bcdec__getu32le((const unsigned char*)compressedBlock + 4);
 
     /* Fill out the decompressed color block */
     dstColors = (unsigned char*)decompressedBlock;
@@ -189,18 +208,22 @@ static void bcdec__color_block(const void* compressedBlock, void* decompressedBl
 }
 
 static void bcdec__sharp_alpha_block(const void* compressedBlock, void* decompressedBlock, int destinationPitch) {
-    unsigned short* alpha;
+    unsigned short alpha;
+    const unsigned char* alphaPtr;
     unsigned char* decompressed;
     int i, j;
 
-    alpha = (unsigned short*)compressedBlock;
+    alphaPtr = (const unsigned char*)compressedBlock;
     decompressed = (unsigned char*)decompressedBlock;
 
     for (i = 0; i < 4; ++i) {
+        alpha = bcdec__getu16le(alphaPtr);
+
         for (j = 0; j < 4; ++j) {
-            decompressed[j * 4] = ((alpha[i] >> (4 * j)) & 0x0F) * 17;
+            decompressed[j * 4] = ((alpha >> (4 * j)) & 0x0F) * 17;
         }
 
+        alphaPtr += 2;
         decompressed += destinationPitch;
     }
 }
@@ -211,7 +234,7 @@ static void bcdec__smooth_alpha_block(const void* compressedBlock, void* decompr
     int i, j;
     unsigned long long block, indices;
 
-    block = *(unsigned long long*)compressedBlock;
+    block = bcdec__getu64le(compressedBlock);
     decompressed = (unsigned char*)decompressedBlock;
 
     alpha[0] = block & 0xFF;
@@ -258,7 +281,7 @@ static void bcdec__bc4_block(const void* compressedBlock, void* decompressedBloc
     static int aWeights4[4] = { 13107, 26215, 39321, 52429 };
     static int aWeights6[6] = { 9363, 18724, 28086, 37450, 46812, 56173 };
 
-    block = *(unsigned long long*)compressedBlock;
+    block = bcdec__getu64le(compressedBlock);
 
     if (isSigned) {
         alpha[0] = (char)(block & 0xFF);
@@ -290,10 +313,16 @@ static void bcdec__bc4_block(const void* compressedBlock, void* decompressedBloc
 
     indices = block >> 16;
     if (isSigned) {
-        sblock = (char*)decompressedBlock;
+        /* Kept identical to upstream. This is the BC4/BC5 SNORM path,
+           values -127..127, and an earlier vendoring had a plain char
+           cast here. That turns out to be equivalent, because sblock is
+           signed char* so the value round-trips on both signed-char and
+           unsigned-char targets (verified with -funsigned-char), but
+           matching upstream byte for byte keeps future diffs honest. */
+        sblock = (signed char*)decompressedBlock;
         for (i = 0; i < 4; ++i) {
             for (j = 0; j < 4; ++j) {
-                sblock[j * pixelSize] = (char)alpha[indices & 0x07];
+                sblock[j * pixelSize] = (signed char)alpha[indices & 0x07];
                 indices >>= 3;
             }
             sblock += destinationPitch;
@@ -316,7 +345,7 @@ static void bcdec__bc4_block_float(const void* compressedBlock, void* decompress
     int i, j;
     unsigned long long block, indices;
 
-    block = *(unsigned long long*)compressedBlock;
+    block = bcdec__getu64le(compressedBlock);
     decompressed = (float*)decompressedBlock;
 
     if (isSigned) {
@@ -600,8 +629,8 @@ BCDECDEF void bcdec_bc6h_half(const void* compressedBlock, void* decompressedBlo
 
     decompressed = (unsigned short*)decompressedBlock;
 
-    bstream.low = ((unsigned long long*)compressedBlock)[0];
-    bstream.high = ((unsigned long long*)compressedBlock)[1];
+    bstream.low = bcdec__getu64le(compressedBlock);
+    bstream.high = bcdec__getu64le((const unsigned char*)compressedBlock + 8);
 
     r[0] = r[1] = r[2] = r[3] = 0;
     g[0] = g[1] = g[2] = g[3] = 0;
@@ -1237,8 +1266,8 @@ BCDECDEF void bcdec_bc7(const void* compressedBlock, void* decompressedBlock, in
 
     decompressed = (unsigned char*)decompressedBlock;
 
-    bstream.low = ((unsigned long long*)compressedBlock)[0];
-    bstream.high = ((unsigned long long*)compressedBlock)[1];
+    bstream.low = bcdec__getu64le(compressedBlock);
+    bstream.high = bcdec__getu64le((const unsigned char*)compressedBlock + 8);
 
     for (mode = 0; mode < 8 && (0 == bcdec__bitstream_read_bit(&bstream)); ++mode);
 

opencodecs-0.2.0/3rdparty/bitshuffle/LICENSE

@@ -0,0 +1,21 @@
+Bitshuffle - Filter for improving compression of typed binary data.
+
+Copyright (c) 2014 Kiyoshi Masui (kiyo@physics.ubc.ca)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.