openexr 3.3.0

[BrewTestBot]

Created by brew bump

---

Created with brew bump-formula-pr.

release notes

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.

[github-actions]

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. To keep this pull request open, add a help wanted or in progress label.

[carlocab]

  /tmp/ctl-20240930-89937-yvomao/CTL-ctl-1.5.3/OpenEXR_CTL/exrdpx/exrToDpx.cpp:172:19: error: call to 'clamp' is ambiguous
    172 |                 (unsigned int) (clamp (float (pixel.r), 0.0f, 1023.0f) + 0.5f);
        |                                 ^~~~~
  /Library/Developer/CommandLineTools/SDKs/MacOSX15.sdk/usr/include/c++/v1/__algorithm/clamp.h:35:1: note: candidate function [with _Tp = float]
     35 | clamp(_LIBCPP_LIFETIMEBOUND const _Tp& __v,
        | ^
  /opt/homebrew/include/Imath/ImathFun.h:77:1: note: candidate function [with T = float]
     77 | clamp (T a, T l, T h) IMATH_NOEXCEPT
        | ^
  /tmp/ctl-20240930-89937-yvomao/CTL-ctl-1.5.3/OpenEXR_CTL/exrdpx/exrToDpx.cpp:175:19: error: call to 'clamp' is ambiguous
    175 |                 (unsigned int) (clamp (float (pixel.g), 0.0f, 1023.0f) + 0.5f);
        |                                 ^~~~~
  /Library/Developer/CommandLineTools/SDKs/MacOSX15.sdk/usr/include/c++/v1/__algorithm/clamp.h:35:1: note: candidate function [with _Tp = float]
     35 | clamp(_LIBCPP_LIFETIMEBOUND const _Tp& __v,
        | ^
  /opt/homebrew/include/Imath/ImathFun.h:77:1: note: candidate function [with T = float]
     77 | clamp (T a, T l, T h) IMATH_NOEXCEPT
        | ^
  /tmp/ctl-20240930-89937-yvomao/CTL-ctl-1.5.3/OpenEXR_CTL/exrdpx/exrToDpx.cpp:178:19: error: call to 'clamp' is ambiguous
    178 |                 (unsigned int) (clamp (float (pixel.b), 0.0f, 1023.0f) + 0.5f);
        |                                 ^~~~~
  /Library/Developer/CommandLineTools/SDKs/MacOSX15.sdk/usr/include/c++/v1/__algorithm/clamp.h:35:1: note: candidate function [with _Tp = float]
     35 | clamp(_LIBCPP_LIFETIMEBOUND const _Tp& __v,
        | ^
  /opt/homebrew/include/Imath/ImathFun.h:77:1: note: candidate function [with T = float]
     77 | clamp (T a, T l, T h) IMATH_NOEXCEPT
        | ^
  3 errors generated.
  make[2]: *** [OpenEXR_CTL/exrdpx/CMakeFiles/exrdpx.dir/exrToDpx.cpp.o] Error 1

https://github.com/Homebrew/homebrew-core/actions/runs/11113893071/job/30879442929?pr=192399#step:3:375

[github-actions]

@carlocab has requested bottles to be published to this PR.