OpenImageIO 2.2.12.0

Release 2.2.12 (1 Mar 2021) -- compared to 2.2.11

• Bug fix: Improve parsing of XMP records in metadata: more correct handling
  of lists/sequences, better inference of types that look like int or float
  (rather than forcing unknown fields into strings), fixed bugs in parsing
  rational values. #2865
• Bug fix: Fix loading PSB files with cinf tags. #2877
• Build: Improvements to building or linking static libraries. #2854
• Build: Change default STOP_ON_WARNING to OFF for release branches
  (including this one) so that small change in compiler warnings after our
  release don't break anybody's builds. (Though we still stop on warnings
  for CI builds). #2861
• Build: More clear warnings about using OpenVDB 8+ when building for C++11,
  because OpenVDB 8 requires C++14 or higher. #2860
• Build: The pkgconfig OpenImageIO.pc was specifying the include path
  incorrectly. #2869
• Build: More gracefully handle building against a custom Imath/OpenEXR even
  when another exists in the system area. #2876
• Build: Minor fixes to build cleanly against the upcoming Imath 3.0. #2878
• Dev: hash.h: Make many of the hash functions constexpr. #2843
• Dev: Better unit tests to verify correctness and stability over time of
  the hash functions. #2853
• Dev: unordered_map_concurrent.h: New methods find_or_insert, nobin_mask().
  #2867
• CI: Speed up CI builds by not building OpenEXR example programes. #2857
• CI: Speed up CI by using GitHub 'cache' actions + ccache. #2859
• CI: Separate stages (setup, deps, build, test) into separate GHA "steps"
  for better logging and understanding of the timing and performance. #2862
• CI: Now actively testing libheif in Linux CI. #2866
• CI: Remove the last vestiges of Travis-CI, which we no longer use. #2871
• CI: For failed tests, add CMake cache and log part of the saved artifacts.
• PSA: Avoid libheif 1.10 on Mac, it is broken. Libheif 1.11 is fine.

OpenImageIO 2.2.11.1

• Fix build break against Qt 5.15.2 (deprecated enum). #2852

Emergency patch, because nearly simultaneously with this morning's release of 2.2.11.0, newly pushed ASWF Docker containers for VFX Platform 2021 seem to have updated to a slightly newer Qt that marked an old enum we used as deprecated.

OpenImageIO 2.2.11.0

Release 2.2.11 (1 Feb 2021) -- compared to 2.2.10

• Enabled AVIF decoding of heic files (requires libheif >= 1.7 and for it
  to have been built with an AV1 encoder/decoder). #2811 #2812 #2814 #2818
• oiiotool --help now prints the OCIO version (where it prints the config
  file and known color space). #2849
• Bug fix: ImageBufAlgo::ociolook() and ociofiletransform() internally
  reversed the order of their inverse and unpremult arguments, making it
  hard to select the inverse transformation. #2844
• Fix memory leak during decoding of some invalid Exif blocks. #2824
• Build: Fixed warnings when building against python 2.x. #2815
• Build: No longer directly link against python libraries when unnecessary.
  #2807
• Build: Better finding of OpenJpeg 2.4. #2829
• Build: On Windows, fix some linkage problems by changing the pybind11
  bindings to make a CMake "shared" library rather than "module". Sounds
  wrong, but seems to work. We will reverse if this causes problems. #2830
• Build: On Mac, libheif 1.10 is very broken. Don't use that version. #2847
• Build: Fix build break against changes coming in future libtiff, where it
  is changing from some libtiff-defined integer types to the equivalent
  stdint.h types. #2848
• Build: Some final touches to prepare for release of OpenColor 2.0. #2849
• Build: Fixes to support the libraw 202101 snapshot (their in-progress
  0.21.0). #2850
• CI: Got Windows CI fully working, bit by bit. #2796 #2805 #2821 #2826
  #2834 #2835 #2836 #2840
• Dev: Some internal rearrangement of span.h and string_view.h (that should
  not break source or ABI compatibility). std::size() and std::ssize()
  should work with OIIO::span and OIIO::string_view now. #2827
• Dev: ustring internals now have a way to ask for the list of ustrings
  whose hashses collided. #2786
• Dev: New Filesystem::generic_filepath() returnss a filepath in generic
  format (not OS specific). #2819
• Dev: ArgParse::abort() lets the response to a command line argument signal
  that no further arguments should be parsed. #2820
• Dev: In oiioversion.h, added macros OIIO_VERSION_GREATER_EQUAL and
  OIIO_VERSION_LESS. #2831
• Dev: In platform.h, added macro OIIO_INLINE_CONSTEXPR, which is equivalent
  to inline constexpr for C++17, but just constexpr for C++ <= 14. #2832

OpenImageIO 2.2.10.1

Release 2.2.10.1 (7 Jan 2021) -- compared to 2.2.10.0

• Fix build break against OpenColorIO v2.0 RC1. #2817

OpenImageIO v2.2.10.0

Happy New Year!

I have tagged Release-2.2.10.0 and moved the "release" branch marker to this location. This is the latest supported stable release that is guaranteed to be API, ABI, and link backwards-compatible with prior 2.2.x releases.

The tag "v2.2.10.0" has also been added. In 2021, we will be transitioning to this more commonly used tag nomenclature. For the rest of the 2.2 releases, we will issue both old and new tag styles for each release, to give people time to transition any scripts that assume a particular release tag nomenclature. We will also change the release branch development points from RB-x.y to dev-x.y, which I think is more clear about its intent than our nonstandard "RB".

Release 2.2.10 (1 Jan 2021) -- compared to 2.2.9

• GIF: support for UTF-8 filenames on Windows. #2777
• OpenEXR: Fix rare crash during multithreaded output. #2781
• OpenEXR: Fix potential crash parsing OpenEXR header that contains Rational
  attributes with certain values. #2791
• Improved error reporting for IOFile failures to open the file. #2780
• Build: Fix webp compile break on 32 bit systems. #2783
• Build/Windows: Fix symbol definition conflict with pyconfig.h. #2800
• CI: Test the latest fmt, PugiXML, and pybind11 releases. #2778
• Docs: Add explanation of oiiotool -otex modifiers that were missing from
  the docs. #2790 Fix some duplicated text. #2785

OpenImageIO 2.2.9.0

Release 2.2.9 (1 Dec 2020) -- compared to 2.2.8

• TIFF: Fix reading files with "separate" planarconfig and rowsperstrip more
  than 1. #2757 (2.3.0.1/2.2.9)
• RAW: add "raw:user_flip" input configuration hint to control this option
  in the underlying libraw. #2769 (2.3.1.0)
• PNG: Read Exif data from PNG files. #2767
• BMP: Fix reading BMP images with bottom-to-top row order. #2776
• Work to ensure that OIIO will build correctly against the upcoming
  Imath 3.0 and OpenEXR 3.0.
• Make the OIIO CMake files work properly if OIIO is a subproject. Also
  various other CMake script refactoring. #2770

Release 2.2.8.0

Release 2.2.8 (1 Nov 2020) -- compared to 2.2.7

• Fix that ImageBuf images backed by ImageCache, could hold an outdated copy
  of the image if it was in the imagecache once, then changed on disk. #2696
• Fix stack overflow crash in IBA::colorconvert of unusually wide images.
  #2716
• Fix boost linkage problem on Windows. #2727
• Fix broken reads of 16 bit iff files. #2736
• Fix make_texture incorrectly setting tile sizes. #2737
• Fix incorrect ARM NEON code in simd.h. #2739
• Improve oiiotool --chappend and --siappend, allowing an optional modifier
  ":n=" to specify the number of images from the stack to be combined by
  having their channels or subimages appended. #2709
• WebP: add support for requesting compression "lossless". #2726
• Improve build system for finding Python, now if a specific version is not
  requested, default to whichever is found rather than always defaulting to
  Python 2.7. #2705 #2764
• Fix deprecation warnings when building with very new PugiXML versions.
  #2733
• Fix ImageCache bug: add_tile/get_tile not properly honoring when
  chend < chbegin it should get all channels. #2742
• Fix build break when strutil.h was included in Cuda 10.1 code. #2743
• Docs: Make readthedocs generate downloadable htm as well as pdf. #2746
• Improve oiiotool's guessing about the desired output format based on
  inputs (in the absence of -d to specify the format). #2717
• JPEG output: add support for writing progressive JPEGS (set the
  attribute "jpeg:progressive" to 1). #2749
• WebP input improvements including: RGB images are kept as RGB instead of
  always adding alpha; more efficient by skipping alpha premultiplication
  when it's unnecessary; now can read animated WebP images as multi-subimage
  files. #2730
• Docs: ImageInput chapter now has an example of reading image data into
  separate per-channel buffers. #2756
• Fixes to build against recent changes in OpenColorIO v2 master. #2765

OpenImageIO 2.2.7.0

This is the latest monthly instalment of the current supported production release series. It is API and ABI compatible with prior 2.2 releases.

Release 2.2.7 (1 Oct 2020) -- compared to 2.2.6

• oiiotool new command: --pastemeta takes two images as arguments, and
  appends all the metadata (only) from the first image onto the second
  image's pixels and metadata, producing a combined image. #2708
• TIFF: Fix broken reads of multi-subimage non-spectral files (such as
  photometric YCbCr mode). #2692
• Python: When transferring blocks of pixels (e.g., ImageInput.read_image()
  or ImageOutput.write_scanline()), "half" pixels ended up mangled into
  uint16, but now they use the correct numpy.float16 type. #2694
• Python: The value passed to attribute(name, typedesc, value) can now be
  a tuple, list, numpy array, or scalar value. #2695
• IBA::contrast_remap() fixes bug that could crash for very large images
  #2704
• Warn about recommended minimum versions of some dependencies.
• Windows fix: correct OIIO_API declaration on aligned_malloc, aligned_free
  of platform.h. #2701
• Fix oiiotool crash when --resize was used with multi-subimage files. #2711
• Bug fix in Strutil::splits and splitsv: when input is the empty string,
  the split should return no pieces. #2712
• Support for libheif 1.9. #2724
• TIFF: Fix spec() and spec_dimensions() for MIPmapped TIFF files, they
  did not recognize being asked to return the specs for invalid subimage
  indices. #2723
• TIFF: add ability to output 1bpp TIFF files. #2722

OpenImageIO 2.1.20

Note that this is a bug-and-build fix release on the obsolete 2.1 release series.

Release 2.1.20 (1 Oct 2020) -- compared to 2.1.19

• Windows: make sure aligned_malloc and aligned_free are properly declared
  as OIIO_API. #2701
• Support for libheif 1.8 and 1.9. #2685 #2724
• Fix crash in IBA::contrast_remap for very large images. #2704
• Bug fix in Strutil::splits and splitsv: when input is the empty string,
  the split should return no pieces. #2712

OpenImageIO 2.2.6.1

Release 2.2 (1 Sept 2020) -- compared to 2.1

New minimum dependencies:

• pybind11 >= 2.4.2
• openjpeg >= 2.0 (if JPEG-2000 support is desired) #2555 (2.2.2)

New major features and public API changes:

• Improved IOProxy support:
  • ImageInput and ImageOutput now have direct API level support for IOProxy
    in their open() and create() calls, as well as a new set_ioproxy()
    method in these classes. #2434 (2.2.0)
  • ImageBuf can now specify a proxy upon construction for reading, and for
    writing via a set_write_ioproxy() method that applies to subsequent
    write call. #2477 (2.2.1).
  • DPX input now supports IOProxy. #2659 #2665 (2.2.5)
  • ImageCache (and ImageBuf backed by ImageCache) entries that use IOProxy
    are careful not to fully "close" their proxies when trying to reclaim
    space in the file cache (that would be bad, since the proxy can't be
    re-opened). #2666 (2.2.5)
• Improved support for multi-subimage files:
  • oiiotool: Nearly all operations now allow an optional :subimages=...
    modifier that restricts the operation to be performed on only a subset
    of named or indexed subimages. See docs for details. #2582
  • Python ImageBuf.write() variety added that takes an open
    ImageOutput. This is the key to writing a multi-subimage file (such
    as a multi-part OpenEXR) using the Python ImageBuf interface. #2640
    (2.2.4)
  • Fixes to --croptofull and -o with multi-subimages. #2684 (2.2.6)
• Python bindings:
  • Python bindings have been added for missing ParamValue constructors.
    We previously exposed the PV constructors from just a plain int, float,
    or string, but there wasn't an easy way to construct from arbitrary
    data like there is in C++. Now there is. #2417 (2.2.0)
  • ParamValueList.attribute(), when being passed attributes containing
    multiple values, now can have those values passed as Python lists and
    numpy arrays (previously they had to be tuples). #2437 (2.1.11/2.2.0)
  • ImageBufAlgo.color_range_check() is now available to the Python
    bindings (was previously only C++). #2602 (2.2.3)
  • New variety of ImageBuf.write() that takes an open ImageOutput.
    This is the key to writing a multi-subimage file (such as a multi-part
    OpenEXR) using the Python ImageBuf interface. #2640 (2.2.4)
• ImageBuf:
  • Easier direct use of IOProxy with ImageBuf: constructor and reset()
    for file-reading ImageBuf now take an optional IProxy* parameter,
    and a new set_write_ioproxy() method can supply an IOProxy for
    subsequent write(). #2477 (2.2.1)
  • Add ImageBuf::setpixel() methods that use cspan instead of ptr/len.
    #2443 (2.1.10/2.2.0)
  • Add "missing" reset() varieties so that every IB constructor has a
    corresponding reset() with the same parameters and vice versa. #2460
• ImageBufAlgo:
  • New repremult() is like premult, but will not premult when alpha is
    zero. #2447 (2.2.0)
  • New max() and min() functions take the pixel-by-pixel maximum
    or minimum of two images. #2470 (2.2.1)
• ColorConfig: add OCIO "role" accessors. #2548
• Low-res I/O of images to terminals that support full color and Unicode
  characters. Just output to a file ending in ".term", and it will convert
  (on certain terminals) to an image displayed directly in the terminal.
  #2631 (2.2.4)
  Try:
  oiiotool myfile.exr -o out.term

Performance improvements:

• Greatly improved TextureSystem/ImageCache performance in highly threaded
  situations where access to the cache was a main bottlenecks. In renders of
  scenes with lots of texture access, with dozens of threads all contending
  for the cache, we are seeing some cases of 30-40% reduction in total
  render time. In scenes that are less texture-bottlenecked, or that don't
  use huge numbers of threads, the improvement is more modest. #2433 (2.2.0)

Fixes and feature enhancements:

• oiiotool:
  • Intelligible error messages (rather than crashes) if you attempt to
    create an image too big to fit in memory. #2414 (2.2.0)
  • --create and --proxy take an additional optional modifier:
    :type=name that specifies the type of buffer to be created (the
    default, as usual, is to create an internal float-based buffer). #2414
    (2.2.0)
  • -o optional argument :type=name is a new (and preferred) synonym
    for what used to be :datatype=. #2414 (2.2.0)
  • --autotrim now correctly trims to the union of the nonzero regions
    of all subimages, instead of incorrectly trimming all subimages to the
    nonzero region of the first subimage. #2497 (2.2.1.2)
  • --subimage now has an optional :delete=1 modifier that causes the
    operation to delete one named or indexed subimage (versus the default
    behavior of extracing one subimage and deleting the others). #2575
    (2.2.3)
  • The list of dependent libraries (part of oiiotool --help) now
    correctly reports the OpenEXR version. #2604 (2.2.3)
  • Fix: --eraseattrib did not correctly apply to all subimages when
    -a or :allsubimages=1 were used. #2632 (2.2.4)
• ImageBuf / ImageBufAlgo:
  • Huge ImageBuf allocation failures (more than available RAM) now are
    caught and treated as an ImageBuf error, rather than crashing with an
    uncaught exception. #2414 (2.2.0)
  • ImageBuf constructors that are passed an ImageSpec (for creating an
    allocated writable IB or "wrapping" a user buffer) now check that the
    spec passed has enough information to know the size of the buffer
    (i.e., it will be recognized as an error if the width, height, depth,
    channels, or data type have not been set validly). #2460
  • Fix: ImageBuf::getchannel() did not honor its wrap parameter.
    #2465 (2.2.1/2.1.12)
  • Fix: IBA::reorient() and IBA::computePixelHashSHA1() did not honor
    their nthreads parameter. #2465 (2.2.1/2.1.12)
  • resample() has been modified to more closely match resize by using
    clamp wrap mode to avoid a black fade at the outer edge of the
    resampled area. #2481
  • Fix: ImageBuf::get_pixels() did not honor the stride parameters.
    #2487. (2.1.12/2.2.1)
  • Fix resize() to avoid a crash / stack overflow in certain cases of
    very big images and very large filter kernels. #2643 (2.2.4)
  • Minor improvements to ImageBuf error formatting. #2653 (2.2.5)
• ImageCache / TextureSystem / maketx:
  • New IC/TS attribute "trust_file_extensions", if nonzero, is a promise
    that all files can be counted on for their formats to match their
    extensions, which eliminates some redundant opens and format checks
    in the IC/TS and can reduce needless network/filesystem work. Use with
    caution! #2421 (2.2.0)
  • texture3d() fixed some cases where derivative results were not
    correctly copied to the outputs. #2475 (2.2.1)
  • maketx/IBA::make_texture: better error detection and messages when
    using "overscan" textures with formats that can't support it properly.
    (Punchline: only OpenEXR textures can do it.) #2521 (2.2.0)
  • Fix possible redundant tile reads in multithread situations (harmless,
    but makes for redundant I/O). #2557 (2.2.2)
• Python:
  • Fixed a bug that lost certain string arguments, especially when passing
    a TypeDesc as its string equivalent. #2587 (2.1.16/2.2.3)
  • Fixed broken bindings of ImageSpec.erase_attribute. #2654
    (2.1.19/2.2.6)
  • Fix missing ImageInput.read_image(). #2677 (2.1.19/2.2.6)
• Exif read: guard better against out of range offsets, fixes crashes when
  reading jpeg files with malformed exif blocks. #2429 (2.1.10/2.2.0)
• Fix: ImageSpec::erase_attribute() did not honor its searchtype
  parameter. #2465 (2.2.1/2.1.12)
• Fix: Some ColorProcessor::apply() methods were not using their chanstride
  parameters correctly. #2475 (2.1.12)
• Fix: iinfo return code now properly indicates failures for files that
  can't be opened. #2511 (2.2.2/2.1.13)
• DPX:
  • IOProxy reading is now supported. #2659 (2.2.5)
  • DPX: Add support for reading DPX files from IOProxy (such as from a
    memory buffer). #2659 #2665 (2.1.19/2.2.6)
• HDR files:
  • Improve performance when reading HDR files out of order (when combined
    with ImageCache, observed to speed up out-of-order HDR reading by 18x).
    #2662 (2.2.5)
• JPEG:
  • Fix resolution unit metadata that was not properly set in JPEG output.
    #2516 (2.2.2/2.1.13)
  • Fix loss of 'config' info upon close/reopen. #2549 (2.2.2)
• OpenEXR:
  • Add support for reading and writing float vector metadata. #2459 #2486
  • Fix bug in the channel sorting order when channels are "X" and
    "Y" (was reversing the order by confusing "Y" for "luminance"). #2595
    (2.1.16/2.2.3)
  • We no longer automatically rename the "worldToNDC" attribute to
    "worldtoscreen" and vice versa. #2609 (2.2.4)
• PNG:
  • Fix loss of 'config' info upon close/reopen. #2549 (2.2.2)
  • Add output configuration hint "png:filter" to control PNG filter
    options. #2650 (2.2.5)
  • Improved propagation of PNG write errors. #2655 (2.2.5)
  • Tell libpng to turn off sRGB profile check, which has a known problem of
    false positives. #2655 (2.2.5)
  • New output option "png:filter" allows control of the PNG filter
    options. #2650 (2.1.19/2.2.6)
• Raw images:
  • Support for new Canon .cr3 file, but only if you build against
    libraw >= 0.20.0 developer snapshot. #2484 (2.2.1) #2613 (2.2.4)
  • RAW input: set the "raw:flip" attribute if the underlying libraw did a
    reorientation. #2572 (2.1.15/2.2.3)...