v3.3.2

Patch release that fixes several bugs and build issues:

• A recent change to CMake had the unintended consequence of
  installing headers and libraries from libdeflate when doing an
  internal build. This is now fixed.
• Fix custom namespaces
• Add thread control to exrmetrics tool
• Reintroduce single cache for successive scanline reads
• Allow empty filename when providing a custom stream
• Handle non-seekable stream in python module's InputFile object

This release fixes:

• OSS-fuzz 372524117 Null-dereference WRITE in Imf_3_4::ScanLineProcess::run_fill

v3.3.1

Patch release that addresses several build and performance issues:

• Fix a performance regression 3.3.0 in huf/piz compression
• Replace FetchContent_Populate with FetchContent_MakeAvailable
• Build wheels for python 3.12
• Fix a problem with python wheel sdist that caused local build to fail
• Compile source files in parallel under MSVC

v3.3.0

Minor release several significant changes:

• The C++ API now uses the OpenEXRCore library underneath.

  • This is a transparent change to the existing API, although the ABI (i.e. structure / class layout) has changed
  • Existing reading of pixel data should be more efficient due to fewer memory allocations / frees during the process of reading. Additionally, some more specialisation of unpacking routines may result in faster unpack times
  • All compression routines are implemented by the C Core layer underneath and no longer duplicated
  • Initial support for "stateless" reading of scanlines has been proposed, allowing multiple threads to read scanlines into different frame buffer objects at the same time. While well tested at the Core level, the C++ api should be considered experimental for this release
  • Thread dispatch for reading different file types has been made more homogeneous, so is simpler and more consistent

• New API for accessing compression types

  In anticipation of future support for new compression types, there is now a convenience API for mapping between compression type names and the associated enum:

  getCompressionDescriptionFromId(Compression, std::string&)
  getCompressionIdFromName(const std::string&, Compression&)
  getCompressionNameFromId(Compression, std::string&)
  getCompressionNamesString(const std::string&, std::string&)
  getCompressionNumScanlines(Compression)
  isValidCompression(int)
  

• New bin tools:

  • exrmetrics - Read an OpenEXR image from infile, write an identical copy to outfile reporting time taken to read/write and file sizes. Useful for benchmarking performance in space and time.

  • exrmanifest - Read exr files and print the contents of the embedded manifest. The manifest provides a mapping between integer object identifiers and human-readible strings. See OpenEXR Deep IDs Specification for more details.

• New python bindings.

  This version introduces a new python API, the File object, which provides full support for reading and writing all types of .exr image files, including scanline, tiled, deep, mult-part, multi-view, and multi-resolution images with pixel types of unsigned 32-bit integers and 16- and 32-bit floats. It provides access to pixel data through numpy arrays, as either one array per channel or with R, G, B, and A interleaved into a single array RGBA array.

  Previous releases of the openexr python module supported only scanline files. The previous API remains in place for now for backwards compatibility.

  See src/wrappers/python/README.md for a synopsis.

v3.2.4

Patch release that fixes handling of dwa compression in OpenEXRCore library.

Other miscellaneous changes:

• Add CMake find_dependency for libdeflate, to fix a vcpkg build error
• Remove the unused CMake option OPENEXR_INSTALL_EXAMPLES
• Fix some other compiler warnings.

v3.1.13

Patch release that fixes handling of dwa compression in OpenEXRCore library.

v3.2.3

Patch release with various build/bug/documentation fixes:

• Fix bswap on NetBSD
• Fix issue with decompressing fp32 dwa files
• Support cmake config for libdeflate
• updated security policy
• miscelleneous website improvements

This release also addresses:

OSS-fuzz 66676 Null-dereference in Imf_3_3::realloc_deepdata
OSS-fuzz 66612 Null-dereference in Imf_3_3::realloc_deepdata

This release also formally adopts the process of publishing openexr python wheels to pypi.org.

This release also introduces the process of signing release artifacts via sigstore.

v3.2.2

Patch release that addresses CVE-2023-5841.

Note that this bug is present in the C++ API (since v3.1.0), although
it is in a routine that is predominantly used for development and
testing. It is not likely to appear in production code.

v3.1.12

Patch release that addresses CVE-2023-5841.

Note that this bug is present in the C++ API (since v3.1.0), although
it is in a routine that is predominantly used for development and
testing. It is not likely to appear in production code.

v2.5.10

Patch release that fixes a build failure on macOS prior to 10.6 (fallback for missing dispatch header).

v3.2.1

Patch release with miscellaneous build fixes:

• Fix for linking statically against an external libdeflate
• Fix a compile error with OPENEXR_VERSION_HEX
• Fix various compiler warnings
• Pkg-config generation is now on by default for all systems, including Windows

See CHANGES.md for details.