Skip to content

Latest commit

 

History

History
570 lines (539 loc) · 70 KB

CHANGES.md

File metadata and controls

570 lines (539 loc) · 70 KB
Raw

Release 3.1 (target: Sept 2025?) -- compared to 3.0

New minimum dependencies and compatibility changes:

⛰️ New features and public API changes:

  • New image file format support:
  • oiiotool new features and major improvements:
  • Command line utilities:
  • ImageBuf/ImageBufAlgo:
    • IBA: IBA::scale() #4541 (by Anton Dukhovnikov) (3.1.0.0/3.0.1.0)
  • ImageInput / ImageOutput:
  • ImageCache/TextureSystem:
  • New global attribute queries via OIIO::getattribute():
    • Added queries for available font families and styles #4523 (by peterhorvath111) (3.1.0.0/3.0.1.0)

🚀 Performance improvements:

  • perf: IBA::unsharp_mask() speed and memory optimization #4513 (by Vlad (Kuzmin) Erium) (3.1.0.0/3.0.1.0)
  • perf: Oiiotool --line --text --point --box speedups #4518 (3.1.0.0/3.0.1.0)
  • perf: Jpeg2000 valid_file implementation, much faster than trying to open #4548 (by Aras Pranckevičius) (3.1.0.0/3.0.1.0)
  • perf: Faster utf8<->utf16 conversion on Windows #4549 (by Aras Pranckevičius) (3.1.0.0/3.0.1.0)

🐛 Fixes and feature enhancements:

  • IBA: IBA:demosaic add white balancing #4499 (by Anton Dukhovnikov) (3.1.0.0/3.0.1.0)
  • IBA: IBA:demosaic add white balancing #4499 (by Anton Dukhovnikov) (3.1.0.0/3.0.1.0)
  • jpeg: Support reading Ultra HDR images #4484 (by Loïc Vital) (3.1.0.0/3.0.1.0)
  • exr: Allow an empty "name" metadata to be read #4528 #4536 (3.1.0.0/3.0.1.0)
  • exr: Avoid integer overflow for large deep exr slice strides #4542 (3.1.0.0/3.0.1.0)
  • jpeg: Support encoding/decoding arbitrary metadata as comments #4430 (by Lukas Stockner) (3.1.0.0/3.0.1.0)
  • raw: Fix channel layout #4516 (by Anton Dukhovnikov) (3.1.0.0/3.0.1.0)

🔧 Internals and developer goodies

🏗 Build/test/CI and platform ports:

  • CMake build system and scripts:
    • build: Add hardening options #4538 (3.1.0.0/3.0.1.0)
  • Dependency support:
    • deps: Support static OCIO self-builds #4517 (by zachlewis) (3.1.0.0/3.0.1.0)
    • deps: Add new ref output for libheif updates #4525 (3.1.0.0/3.0.1.0)
    • build: Add build recipe for PNG #4423 (by zachlewis) (3.1.0.0/3.0.1.0)
  • Testing and Continuous integration (CI) systems:
    • ci: Increased the macos timeout slightly to fix spurious failures #4526 (3.1.0.0/3.0.1.0)
    • ci: Don't rebuild docs in CI when only CMakeLists.txt changes #4539 (3.1.0.0/3.0.1.0)
    • ci: Fix broken CI for ASWF 2021 and 2022 containers #4543 (3.1.0.0/3.0.1.0)
  • Platform support:

📚 Notable documentation changes:

  • docs: Clarify 'copy_image' example #4522 (3.1.0.0/3.0.1.0)
  • docs: Update some old links to our new vanity URLs #4533 (3.1.0.0/3.0.1.0)
  • docs: Quickstart guide #4531 (3.1.0.0/3.0.1.0)
  • docs: First stab at an archiecture overview #4530 (3.1.0.0/3.0.1.0)

🏢 Project Administration

  • admin: Code review guidelines and tips #4532 (3.1.0.0/3.0.1.0)
  • admin: Document how to make signed release tags #4529 (3.1.0.0/3.0.1.0)

Release 3.0.1.0 (Dec 1, 2024) -- compared to 3.0.0.3

  • IBA: New IBA::scale() #4541 (by Anton Dukhovnikov) (3.0.1.0)
  • IBA: IBA:demosaic() add white balancing #4499 (by Anton Dukhovnikov) (3.0.1.0)
  • jpeg: Support reading Ultra HDR images #4484 (by Loïc Vital) (3.0.1.0)
  • jpeg: Support encoding/decoding arbitrary metadata as comments #4430 (by Lukas Stockner) (3.0.1.0)
  • api: OIIO::getattribute() queries for available font families and styles #4523 (by peterhorvath111) (3.0.1.0)
  • perf: IBA::unsharp_mask() speed and memory optimization #4513 (by Vlad (Kuzmin) Erium) (3.0.1.0)
  • perf: oiiotool --line, --text, --point, and --box speedups #4518 (3.0.1.0)
  • perf: Jpeg2000 valid_file implementation, much faster than trying to open #4548 (by Aras Pranckevičius) (3.0.1.0)
  • perf: Faster utf8<->utf16 conversion on Windows #4549 (by Aras Pranckevičius) (3.0.1.0)
  • fix(exr): Allow an empty "name" metadata to be read #4528 #4536 (3.0.1.0)
  • fix(exr): Avoid integer overflow for large deep exr slice strides #4542 (3.0.1.0)
  • fix(raw): Fix channel layout #4516 (by Anton Dukhovnikov) (3.0.1.0)
  • build: Support static OCIO self-builds #4517 (by zachlewis) (3.0.1.0)
  • build: Add build recipe for PNG #4423 (by zachlewis) (3.0.1.0)
  • build: Add hardening options #4538 (3.0.1.0)
  • ci: Increased the macos timeout slightly to fix spurious failures #4526 (3.0.1.0)
  • ci: Don't rebuild docs in CI when only CMakeLists.txt changes #4539 (3.0.1.0)
  • ci: Fix broken CI for ASWF 2021 and 2022 containers #4543 (3.0.1.0)
  • docs: Update some old links to our new vanity URLs #4533 (3.0.1.0)
  • docs: Quickstart guide #4531 (3.0.1.0)
  • docs: First stab at an architecture overview #4530 (3.0.1.0)
  • docs/admin: Code review guidelines and tips #4532 (3.0.1.0)
  • docs/admin: Document how to make signed release tags #4529 (3.0.1.0)

Release 3.0 (v3.0.0.3 - Nov 8, 2024) -- compared to 2.5.16.0

  • v3.0.0.0-beta1 - Oct 15, 2024
  • v3.0.0.1-beta2 - Oct 29, 2024
  • v3.0.0.2-RC1 - Nov 4, 2024 (no code changes vs beta2)
  • v3.0.0.3 / official release - Nov 8, 2024 (no code changes vs RC1)

Executive Summary / Highlights:

  • Updated minimum toolchain: C++17/gcc9.3, Python 3.7, CMake 3.18.2, and raised min versions of most library dependencies.
  • New image format support: JPEG XL, R3D.
  • oiiotool new commands: --cryptomatte-colors, --demosaic, --buildinfo, --ocionamedtransform, --popbottom, --stackreverse, --stackclear, --stackextract; improved --for behavior for reverse direction.
  • Lots of long-deprecated API calls have been removed entirely. Please see the detailed deprecation list.
  • New ImageBufAlgo: perpixel_op(), demosaic(), ocionamedtransform().
  • ImageBuf now by default does not use ImageCache to mediate file images, unless you explicitly ask for it.
  • ImageCache & TextureSystem now use shared_ptr for creation, not raw pointers. And they have been de-virtualized, for easier future expansion flexibility without breaking ABI for any small change.
  • Improved and more consistent color space name nomenclature.
  • Build system now is capable of auto-downloading and building several of the most important dependencies if they are missing at build time.
  • Please note that the development branch in the GitHub repo is now named main instead of master.

Full details of all changes follow.

New minimum dependencies and compatibility changes:

  • C++: Move to C++17 standard minimum (from 14), which also implies a minimum gcc 9.3 (raised from 6.3), clang 5 (though we don't test or support older than clang10), Intel icc 19+, Intel OneAPI C++ compiler 2022+. #4199 (2.6.2.0)
  • Python: 3.7 minimum (from 2.7). #4200 (2.6.2.0)
  • CMake: 3.18.2 minimum (from 3.15) #4472 (3.0.0)
  • Boost: Is no longer a dependency! #4191 (by Christopher Kulla) #4221 (by Christopher Kulla) #4222 #4233 (2.6.2.0)
  • ffmpeg: 4.0 minimum (from 3.0) #4352 (2.6.3.0)
  • Freetype: 2.10 minimum (from no previously stated minimum, but we had been testing as far back as 2.8) #4283 (2.6.2.0)
  • GIF: 5.0 minimum for giflib (from 4.0) #4349 (2.6.3.0)
  • libheif: 1.11 minimum (from 1.3) #4380 (2.6.3.0)
  • LibRaw: Raise minimum LibRaw to 0.20 (from 0.18) #4217 (2.6.2.0)
  • libtiff: 4.0 minimum (from 3.9) #4296 (2.6.2.0)
  • OpenColorIO: Make OpenColorIO a required dependency and raise the minimum to 2.2 (from 1.1). #4367 (2.6.3.0)
  • OpenEXR/Imath: minimum raised to 3.1 (from 2.4) #4223 (2.6.2.0)
  • OpenCV: 4.0 minimum (from 3.x) #4353 (2.6.3.0)
  • OpenVDB: Raise OpenVDB minimum to 9.0 #4218 (2.6.2.0)
  • PNG: 1.6.0 minimum for libPNG (from 1.5.13) #4355 (2.6.3.0)
  • Pybind11: 2.7 minimum #4297 (2.6.2.0)
  • Robin-map: 1.2.0 minimum #4287 (2.6.2.0)
  • WebP: 1.1 minimum (from 0.6.1) #4354 (2.6.3.0)

⛰️ New features and public API changes:

  • New image file format support:
    • JPEG XL: Initial JPEG XL support for image input/output #4055 (by Peter Kovář) #4252 (by Vlad (Kuzmin) Erium) (2.6.2.0) #4310 (by Vlad (Kuzmin) Erium) (2.6.3.0)
    • R3D: Add initial support to read R3D files. Note that this capability will only be enabled if OIIO is built with the R3D SDK installed and available to be found by the build system. #4216 (by Peter Kovář) (2.6.2.0)
  • oiiotool new features and major improvements:
    • --cryptomatte-colors takes the name of a cryptomatte set of channels, and produces a color-coded matte in which each ID gets a distinct color in the image. This can be useful for visualizing the matte, among other things. #4093 (2.6.0.2)
    • --demosaic takes 1-channel Bayer patterns and turn them into demosaiced 3-channel images #4366 (by Anton Dukhovnikov) (2.6.3.0) #4419 (by Anton Dukhovnikov) (2.6.6.0)
    • --buildinfo command prints build information, including version, compiler, and all library dependencies. #4124 (2.6.0.3) #4150 (2.6.0.3)
    • --ocionamedtransform: Implement support for OCIO NamedTransforms #4393 (by zachlewis) (2.6.3.0)
    • Several new stack manipulation commands: --popbottom discards the bottom element of the stack, --stackreverse reverses the order of the whole stack, --stackclear fully empties the stack, --stackextract <index> moves the indexed item from the stack (index 0 means the top) to the top. #4348 (2.6.3.0)
    • --for improvements: correct reverse iteration behavior if the step value is negative, or if there is no step value but the start value is greater than the end value. (#4348) (2.6.3.0)
    • Expression evaluation improvements: BOTTOM refers to the image on the bottom of the stack, IMG[expression] is now supported (previously only numeric literals were accepted as the index), check that label/variable names #4334 (2.6.3.0)
    • oiiotool now by default does immediate reads without relying on an ImageCache, unless the --cache option is used, which now both enables the use of an underlying IC as well as setting its size. This tends to improve performance. #3986 (2.6.0.1, 2.5.3.1)
    • Change command line embedding for oiiotool & maketx output, by default hiding the command line for security reasons. It can be re-enabled with --history. #4237 (2.6.2.0)
  • Command line utilities:
    • idiff: Allow users to specify a directory as the 2nd argument #4015 (by David Aguilar) (2.6.0.1)
    • iv: Implement Directory Argument Loading for iv #4010 (by Chaitanya Sharma) (2.6.0.1)
    • iv: Split off the current image in iv into a separate window #4017 (by Anton Dukhovnikov) (2.6.0.1)
    • iv: OCIO color managed display #4031 (by Anton Dukhovnikov) (2.6.0.2)
    • iv: Iv shows constant brown and GL error messages on start-up. #4451 (by David Adler) (2.6.6.0)
    • iv: Initialize variables before we use them. #4457 (by Bram Stolk) (2.6.6.0)
    • iv: Add iv data and display windows overlay feature #4443 (by Andy Chan) (2.6.6.0)
  • New global attribute queries via OIIO::getattribute():
    • "build:platform", "build:compiler", "build:dependencies" #4124 (2.6.0.3)
    • "build:simd" is the new preferred synonym for the old name "oiio:simd" #4124 (2.6.0.3)
  • ImageBuf/ImageBufAlgo:
    • ImageBuf now has span-based constructors for the variety where it "wraps" a user buffer. This is preferred over the constructor that takes a raw pointer (which is considered deprecated). #4401 (2.6.6.0)
    • New span-based versions of get_pixels, set_pixels, setpixel, getpixel, interppixel, interppixel_NDC, interppixel_bicubic, interppixel_bicubic_NDC. These are preferred over the old versions that took raw pointers. #4426 (2.6.6.0)
    • Start using optional keyword/value params for some ImageBufAlgo functions. #4149
    • Only back ImageBuf with ImageCache when passed an IC #3986 (2.6.0.1, 2.5.3.1)
    • Make ImageBuf::Iterator lazy in its making the image writable #4033 (2.6.0.2)
    • IBA::perpixel_op() is a new way to write IBA-like functions very simply, only supplying the very inner part of the loop that operates on one pixel. #4299 (2.6.3.0) #4409 (2.6.6.0)
    • IBA::demosaic() takes 1-channel Bayer patterns and turn them into demosaiced 3-channel images #4366 (by Anton Dukhovnikov) (2.6.3.0)
    • IBA::ocionamedtransform(): Implement support for OCIO NamedTransforms #4393 (by zachlewis) (2.6.3.0)
  • ImageInput / ImageOutput:
    • Add virtual heapsize() and footprint() to ImageInput and ImageOutput #4323 (by Basile Fraboni) (2.6.3.0)
  • ImageCache/TextureSystem:
    • Use shared_ptr for ImageCache and TextureSystem creation #4377 (2.6.3.0)
    • Overload decode_wrapmode to support ustringhash #4207 (by Chris Hellmuth) (2.6.1.0)
    • Add pvt::heapsize() and pvt::footprint() methods and image cache memory tracking #4322 (by Basile Fraboni) (2.6.3.0)
    • De-virtualize ImageCache and TextureSystem #4384 (2.6.3.0)
    • IC/TS have new get_imagespec(), imagespec(), and get_cache_dimensions() methods. #4442 (by Basile Fraboni) (2.6.6.0)
    • python: Implement ImageCache.get_imagespec() #3982 (2.6.0.0, 2.5.3.1-beta2)
    • TextureOpt has been refactored a bit: some fields have been reordered; it's actually called TextureOpt_v2 (TextureOpt is an alias) to allow better compatibility-preserving improvements in the future, and similarly, TextureOptBatched is an alias for TextureOptBatch_v1. The type names of some enums have been changed, but aliases should preserve compatibility in the vast majority of cases. #4485 #4490 (3.0.0.0)
  • API Deprecations: (please see the detailed deprecation list)
    • Various other minor deprecations of things that had been marked as deprecated for a while in fmath.h #4309 (2.6.2.0), typedesc.h #4311 (2.6.2.0), simd.h #4308 (2.6.2.0), assorted #4234 (2.6.2.0), texture.h #4339 (2.6.3.0), imageio.h #4312 (2.6.3.0), benchmark.h, bit.h, color.h, errorhandler.h #4335, parmalist.h, parallel.h, strutil.h, sysutil.h, thread.h, tiffutils.h, ustring.h, type_traits.h #4338 (2.6.3.0), imagebuf.h #4341 (2.6.3.0), imagebufalgo.h #4344 (2.6.3.0), dassert.h imagebufalgo.h imagecache.h imageio.h simd.h strutil.h ustring.h #4480 #4488 (3.0.0.0)
    • The deprecated headers array_view.h and missing_math.h have been removed. #4335 #4338 (2.6.3.0)
    • Make span::size() return size_t, not a signed type #4332 (2.6.3.0)
  • Build system dependency self-builders:
    The cmake-based build system has been enhanced to give a report of what dependencies it found, what was missing, what was found but was a version too old for our requirement. If the OpenImageIO_BUILD_MISSING_DEPS cmake variable is set to "all" (or a list of specific packages), the build system will attempt to build certain missing dependencies locally. Currently, this works for fmt, freetype, Imath, jpeg-turbo, libtiff, OpenColorIO, OpenEXR, pybind11, Robinmap, WebP, Zlib. Additional dependencies will learn to self-build over time. #4242 #4294 by Larry Gritz, #4392 by zachlewis (2.6.3.0) #4420 (by zachlewis) (2.6.6.0) #4422 (by zachlewis) (3.0.0.1) #4493 (by kaarrot) (3.0.0.1)
  • Environment variables
    • The environment variable OIIO_LIBRARY_PATH that contains the search paths for finding image file format plugins has been changed to be called OPENIMAGEIO_PLUGIN_PATH. This is more consistent: all the "public API" documented environment variables that are meant for users/sites to adjust are named starting with OPENIMAGEIO_, whereas the prefix OIIO_ is only used for environment variables that are "unofficial" (undocumented, temporary, or meant only for developers to use for debugging). #4330 (2.6.3.0)
    • Rename env variable OIIOTOOL_METADATA_HISTORY to OPENIMAGEIO_METADATA_HISTORY #4368 (2.6.3.0)

🚀 Performance improvements:

  • oiiotool: --mosaic improvements to type conversion avoid unnecessary copies and format conversions. #3979 (2.6.0.0, 2.5.3.1-beta2)
  • oiiotool: Use pointer, not static, for internal color config, slightly reducing oiiotool startup overhead when color configs are not needed. #4433 (2.6.6.0)
  • simd: Faster vint4 load/store with unsigned char conversion #4071 (by Aras Pranckevičius) (2.6.0.2)
  • perf/IBA: Improve perf of IBA::channels in-place operation #4088 (2.6.0.2)
  • perf: Overhaul of ColorConfig internals to solve perf issues #3995 (2.6.0.1)
  • perf/TS: Reduce TextureSystem memory by slimming down internal LevelInfo size #4337 (by Curtis Black) (2.6.3.0)
  • TS: Have maketx/IBA::make_texture only write full metadata to the first mip level. We presume that other than resolution and encoding-related information, other metadata should not be expected to differ between MIP levels of the same image. This saves file size and memory in the IC/TS. #4320 (2.6.3.0)
  • IC/TS: Store full metadata only at subimage 0, miplevel 0 for ptex files. #4376 (2.6.3.0)
  • perf: Additional timing logging for performance investigations #4506 (3.0.0.1)
  • ImageBuf: ImageBuf file read performance -- double reads, extra copies #4507 (3.0.0.1)

🐛 Fixes and feature enhancements:

  • errors: Print unretrieved global error messages upon application exit. This should help beginning developers see important error messages they have failed to retrieve. #4005 (2.6.0.1)
  • font rendering: Improvements to text rendering by ImageBufAlgo::render_text() and oiiotool --text:
    • Look up font in text render based on family and style name, in addition to font filename. #4509 (by peterhorvath111) (3.0.0.1)
    • Fix incorrect vertical alignment in render_text #4500 (by peterhorvath111) (3.0.0.1)
    • Windows newline shows invalid character in text render #4501 (by peterhorvath111) (3.0.0.1)
    • Improve internals of font search enumeration #4508 (by peterhorvath111) (3.0.0.1)
  • oiiotool: Overhaul and fix bugs in mixed-channel propagation #4127
  • oiiotool: Expression substitution now understands pseudo-metadata NONFINITE_COUNT that returns the number of nonfinite values in the image, thus allowing decision making about fixnan #4171
  • oiiotool: --autocc bugfix and color config inventory cleanup #4060 (2.6.0.1)
  • oiiotool: Improve over-blurring of certain oiiotool --fit situations #4108 (2.6.0.3)
  • oiiotool: -i:ch=... didn't fix up alpha and z channels #4373 (2.6.3.0)
  • iinfo: iinfo was not reading MIP levels correctly #4498 (3.0.0.1)
  • iv: Assume iv display gamma 2.2 #4118 (2.6.0.3)
  • dds: Always seek to the beginning of the ioproxy during open for DDS and PSD files #4048 (by Jesse Yurkovich) (2.6.0.1)
  • dds: DDS support more DXGI formats #4220 (by alexguirre) (2.6.2.0)
  • heic: Don't auto-transform camera-rotated images #4142 (2.6.0.3) #4184 (2.6.1.0)
  • heic: Correctly set imagespec size for heif images (by Gerrard Tai) (2.6.3.0)
  • iff: Refactor iffoutput.cpp for memory safety #4144 (2.6.0.3)
  • jpeg: New output hint "jpeg:iptc" can be used to instruct JPEG output to not output the IPTC data to the file's header. #4346 (2.6.3.0)
  • jpeg2000: Include the headers we need to discern version #4073 (2.6.0.2)
  • jxl: JPEG-XL improvements #4252 (by Vlad (Kuzmin) Erium) (2.6.2.0)
  • openexr: Handle edge case of exr attribute that interferes with our hints #4008 (2.6.0.1)
  • openexr: Add support for luminance-chroma OpenEXR images. #4070 (by jreichel-nvidia) (2.6.0.3)
  • openexr: Implement copy_image for OpenEXR #4004 (by Andy Chan) (2.6.1.0)
  • openexr: Fix out-of-bounds reads when using OpenEXR decreasingY lineOrder. #4215 (by Aaron Colwell) (2.6.2.0)
  • openexr: Add proxy support for EXR multipart output #4263 #4264 (by jreichel-nvidia) (2.6.2.0)
  • openexr: Modernize dwa compression level setting #4434 (3.0.0)
  • ffmpeg: Add proper detection of new FFmpeg versions #4394 (by Darby Johnston) (2.6.3.0)
  • ffmpeg: FFmpeg additional metadata #4396 (by Darby Johnston) (2.6.3.0)
  • png: New output compression mode names recognized: "none", "pngfast". Also some minor speedups to PNG writes. #3980 (2.6.0.0)
  • png: Write out proper tiff header version in png EXIF blobs #3984 (by Jesse Yurkovich) (2.6.0.0, 2.5.3.1)
  • png: A variety of minor optimizations to the PNG writer #3980
  • png: Improve png write with alpha is low #3985 (2.6.0.1)
  • png: Fix crash for writing large PNGs with alpha #4074 (2.6.0.2)
  • png: Correctly read PNGs with partial alpha #4315 (2.6.2.0)
  • png: Round dpi resolution to nearest 0.1 #4347 (2.6.3.0)
  • png: Bug in associateAlpha botched alpha=0 pixels #4386 (2.6.3.0)
  • pnm: Improvements to pnm plugin #4253 (by Vlad (Kuzmin) Erium) (2.6.2.0)
  • pnm: Initialize m_pfm_flip before use to avoid UB. #4446 (by Bram Stolk) (2.6.6.0)
  • psd: Always seek to the beginning of the ioproxy during open for DDS and PSD files #4048 (by Jesse Yurkovich) (2.6.0.1)
  • psd: Add support for 16- and 32-bit Photoshop file reads #4208 (by EmilDohne) (2.6.2.0)
  • psd: Various PSD files fail to load correctly #4302 (by Jesse Yurkovich) (2.6.2.0)
  • raw: LibRaw wavelet denoise options #4028 (by Vlad (Kuzmin) Erium) (2.6.0.1)
  • raw: Avoid buffer overrun for flip direction cases #4100 (2.6.0.3)
  • raw: Expose additional white balancing hints: "raw:user_black", "raw:use_auto_wb", "raw:grey_box", "dng:version", "dng:baseline_exposure", "dng:calibration_illuminant#", "dng:color_matrix#", "dng:camera_calibrationX". #4360 (by Anton Dukhovnikov) (2.6.3.0)
  • raw: Make the crop match in-camera JPEG #4397 (by Anton Dukhovnikov) (2.6.3.0)
  • raw: Check for nullptr in raw input plugin #4448 (by Anton Dukhovnikov) (2.6.6.0)
  • raw: Raw reader - exposing max_raw_memory_mb #4454 (by Ankit Sinha) (2.6.6.0)
  • tiff: Fix TIFF export with EXIF data and I/O proxy #4300 (by jreichel-nvidia) (2.6.3.0)
  • ImageBuf: Fix crash when mutable Iterator used with read-IB #3997 (2.6.0.1)
  • ImageBuf: Improve IB::nsubimages and other related fixes #4228 (2.6.2.0)
  • ImageBuf: Copy/paste error in the ImageBuf iterator copy constructor #4365 (by Anton Dukhovnikov) (2.6.3.0)
  • ImageBufAlgo: IBA::to_OpenCV fails for ImageCache-backed images #4013 (2.6.0.1)
  • ImageBufAlgo: Add missing version of warp #4390 (2.6.3.0)
  • ImageBufAlgo: IBA::transpose() didn't set output image's format to input #4391 (2.6.3.0)
  • ImageBufAlgo: Fix issue when computing perceptual diff #4061 (by Aura Munoz) (2.6.0.1)
  • ImageInput: Only check REST arguments if the file does not exist, avoiding problems for filenames that legitimately contain a ? character. #4085 (by AdamMainsTL) (2.6.0.2)
  • fix: Certain int->float type conversions in TypeDesc/ParamValueList #4132 (2.6.0.3)
  • color management: Automatically recognize some additional color space name synonyms: "srgb_texture", "lin_rec709" and "lin_ap1". Also add common permutation "srgb_tx" and "srgb texture" as additional aliases for "srgb". #4166
  • color management: Color management nomenclature improvements: "linear" is now just a legacy synonym for the preferred "lin_rec709", which is used widely where applicable. #4479 (3.0.0.0)
  • security: Don't use (DY)LD_LIBRARY_PATH as plugin search paths #4245 (by Brecht Van Lommel) (2.6.2.0)
  • fix: Fix crash when no default fonts are found #4249 (2.6.2.0)
  • TextureSystem: Fix missing initialization in TextureOptBatch #4226 (2.6.2.0)
  • iv: Avoid crash with OpenGL + multi-channel images #4087 (2.6.0.2)
  • iv: If OCIO env is not set or doesn't exist, have iv use built-in config #4285 (2.6.2.0)
  • iv: Iv should enable the ImageCache #4326 (by Jesse Yurkovich) (2.6.3.0)
  • ImageCache: Simplify tile cache clearing. #4292 (by Curtis Black) (2.6.2.0)

🔧 Internals and developer goodies

  • int: Prevent infinite loop in bit_range_convert #3996 (by Jesse Yurkovich) (2.6.0.1)
  • int: More switching fprintf/etc to new style print #4056 (2.6.0.1)
  • int: Various fixes for memory safety and reduce static analysis complaints #4128 (2.6.0.3)
  • int: Use OIIO functions for byte swapping to make Sonar happy #4174 (2.6.1.0)
  • int: More conversion to new string formatting #4189 (2.6.1.0) #4231 (2.6.2.0) #4247 (2.6.2.0) #4258 (2.6.2.0)
  • int: Added validity checks to PNG, JPEG, and EXR readers to try to catch implausible resolutions or channels that are likely to be corrupted or malicious images. #4452 (by Dharshan Vishwanatha) (2.6.6.0)
  • int: ImageInput: Initialize pixels of partial tile conversion buffer, avoiding possible floating point errors. #4462 (by Bram Stolk) (2.6.6.0)
  • bit.h: Move bitcast, byteswap, and rotl/rotr to new bit.h #4106 (2.6.0.3)
  • bit.h: OIIO::bitcast adjustments #4101 (2.6.0.3)
  • filesystem.h: Filesystem::unique_path wasn't using the unicode rectified string #4203 (2.6.1.0)
  • filesystem.h: IOProxy const method adjustments #4415 (2.6.6.0)
  • fmath.h: One more fast_exp fix #4275 (2.6.2.0)
  • fmt.h: Fix build break from recent fmt change #4227 (2.6.2.0)
  • hash.h: Mismatched pragma push/pop in hash.h #4182 (2.6.1.0)
  • imagebuf.h: Add ImageBuf::wrapmode_name(), inverse of wrapmode_from_string #4340 (2.6.3.0)
  • oiioversion.h: Coalesce redundant STRINGIZE macros -> OIIO_STRINGIZE #4121 (2.6.0.3)
  • platform.h: Belatedly change OIIO_CONSTEXPR14 to constexpr #4153 (2.6.0.3)
  • paramlist.h: Add ParamValueSpan::get_bool() #4303 (2.6.2.0)
  • platform.h: In platform.h, define OIIO_DEVICE macro #4290 (2.6.2.0)
  • simd.h: Fix leaking of Imath.h into public headers #4062 (2.6.0.2)
  • simd.h: Make all-architecture matrix44::inverse() #4076 (2.6.0.2)
  • simd.h: AVX-512 round function #4119 (by AngryLoki) (2.6.0.3)
  • simd.h: Simplify vbool16 casting #4105 (2.6.0.3)
  • simd.h: Address NEON issues #4143 (2.6.0.3)
  • simd.h: Gather_mask was wrong for no-simd fallback #4183 (2.6.1.0)
  • simd.h: For simd types, use default for ctrs and assignment where applicable #4187 (2.6.1.0)
  • simd.h: Fix longstanding probem with 16-wide bitcast for 8-wide HW #4268 (2.6.2.0)
  • span.h: Span and range checking enhancements #4125 (2.6.0.3)
  • span.h: Make span default ctr and assignment be = default #4198 (2.6.1.0)
  • span.h: Span utility improvements #4398 (2.6.3.0)
  • span.h: Fold span_util.h contents into span.h #4402 (2.6.6.0)
  • span.h: New utility functions span_within(), check_span(), and macro OIIO_ALLOCA_SPAN. #4426 (2.6.6.0)
  • string_view.h: Deprecate OIIO::string_view::c_str() #4511 (3.0.0.1)
  • strutil.h: Add Strutil::eval_as_bool() #4250 (2.6.2.0)
  • strutil.h: Add Strutil::string_is_identifier() #4333 (2.6.3.0)
  • strutil.h: Change Strutil::format to default to std::format conventions #4480 (3.0.0.0)
  • sysutil.h: Deprecate Sysutil::physical_concurrency() #4034 (2.6.0.1)
  • texture.h: Overload decode_wrapmode to support ustringhash #4207 (by Chris Hellmuth) (2.6.1.0)
  • typedesc.h: Allow TypeDesc to have all the right POD attributes #4162 (by Scott Wilson) (2.6.0.3)
  • typedesc.h: Add TypeDesc::Vector3i #4316 (2.6.2.0)
  • ustring.h: Make sure C++ knows ustring & ustringhash are trivially copyable #4110 (2.6.0.3)
  • ustring.h: Address ignored annotation nvcc warnings on explicitly-defaulted functions #4291 (by Chris Hellmuth) (2.6.2.0)
  • style: Update our formatting standard to clang-format 17.0 and C++17 #4096 (2.6.0.3)
  • int: Use spans to solve a number of memory safety issues #4148 (2.6.1.0)
  • cleanup: Convert more old errorf() to errorfmt() #4231 (2.6.2.0)
  • fix: Error retrieval safeguards for recycled objects #4239 (2.6.2.0)
  • fix: Improve error messages when a font is not found #4284 (2.6.2.0)
  • refactor: Oiiotool break out expression eval methods into separate file #4256 (2.6.2.0)
  • refactor: Move most of imageio_pvt.h.in to just a regular .h #4277 (2.6.2.0)
  • refactor: Simplify openexr includes #4304 (2.6.3.0)
  • fix: Catch potential OCIO exception that we were missing #4379 (2.6.3.0)
  • fix: Don't let fmtlib exceptions crash the app #4400 (2.6.3.0)
  • fix: Beef up some error messages #4369 (2.6.3.0)
  • cleanup: Remove code disabled as of 3.0 #4487 (3.0.0.0)
  • fix: Address fmt exceptions for left justification #4510 (3.0.0.1)

🏗 Build/test/CI and platform ports:

  • CMake build system and scripts:
    • Fix Cuda ustring.h warnings #3978 (2.6.0.0, 2.5.3.1)
    • Remove unnecessary headers from strutil.cpp causing build trouble #3976 (by Jesse Yurkovich) (2.6.0.0, 2.5.3.1)
    • Print build-time warnings for LGPL gotchas #3958 (by Danny Greenstein) (2.6.0.0, 2.5.3.1-beta2)
    • build: Make C++17 be the default C++ standard for building (C++14 is still the minimum for now and can be selected via CMAKE_CXX_STANDARD) #4022 (2.6.0.1)
    • build: Provide compile_commands.json for use by tools #4014 (by David Aguilar) (2.6.0.1)
    • build: Don't fail for 32 bit builds because of static_assert check #4006 (2.6.0.1)
    • build: Provide compile_commands.json for use by tools #4014 (by David Aguilar) (2.6.0.1)
    • build: Don't fail for 32 bit builds because of static_assert check #4006 (2.6.0.1)
    • build: Better cmake verbose behavior #4037 (2.6.0.1)
    • build: Fix include guard #4066 (2.6.0.2)
    • build: Add a way to cram in a custom extra library for iv #4086 (2.6.0.2)
    • build: Don't fail pybind11 search if python is disabled #4136 (2.6.0.3)
    • build: Cleanup - get rid of "site" files #4176 (2.6.1.0)
    • build: Fix buld_ninja.bash to make directories and download correctly #4192 (by Sergio Rojas) (2.6.1.0)
    • build: Need additional include #4194 (2.6.1.0)
    • build: Make an OpenImageIO_Util_static library and target #4190 (2.6.1.0)
    • build: Switch to target-based definitions #4193 (2.6.1.0) then mostly revert it #4273 (2.6.2.0).
    • build: iv build issues with glTexImage3D #4202 (by Vlad (Kuzmin) Erium) (2.6.1.0)
    • build: Restore internals of strhash to compile correctly on 32 bit architectures #4213 (2.6.1.0)
    • build: LibOpenImageIO_Util does need DL libs, we removed it incorrectly #4230 (2.6.2.0)
    • build: Fix missing target_link_options for libraries (by kaarrot) (2.6.2.0)
    • build: Disable clang18 warnings about deprecated unicode conversion #4246 (2.6.2.0)
    • build: More warning elimination for clang18 #4257 (2.6.2.0)
    • build: Add CMath target for the sake of static libtiff #4261 (2.6.2.0)
    • build: Add appropriate compiler defines and flags for SIMD with MSVC #4266 (by Jesse Yurkovich) (2.6.2.0)
    • build/windows: Fix warning on windows #4272 (2.6.2.0)
    • build/windows: Fix for setenv() on Windows #4381 (by Vlad (Kuzmin) Erium) (2.6.3.0)
    • build: Gcc-14 support, testing, CI #4270 (2.6.2.0)
    • build: New set_utils.cmake for various handy "set()" wrappers #4274 (2.6.2.0) #4281 (2.6.2.0)
    • build: Upgrade to more modern python3 finding #4288 (2.6.2.0)
    • build: Add missing includes to libutil CMake target. #4306 (by kaarrot) (2.6.2.0)
    • build: Avoid rebuilds due to processing of fmt headers #4313 (by Jesse Yurkovich) (2.6.2.0)
    • build: Rudimentary CUDA support infrastructure (experimental) #4293 (2.6.2.0)
    • build: A few cmake cleanups and minor code rearrangements #4359 (2.6.3.0)
    • build: Don't link libOpenImageIO against OpenCV #4363 (2.6.3.0)
    • build: Fixed the sign compare causing build failure #4240 (by Peter Kovář) (2.6.2.0)
    • build: Add a build option for profiling #4432 (2.6.6.0)
    • build: Don't change CMAKE_XXX_OUTPUT_DIRECTORY when built as subdir #4417 (by Luc Touraille) (3.0.0)
    • build: Add option for build profiling with clang -ftime-trace #4475 (3.0.0)
    • build: Reduce compile time by trimming template expansion in IBA. #4476 (3.0.0.0)
  • Dependency support:
    • deps/OpenVDB: Protect against mismatch of OpenVDB vs C++ #4023 (2.6.0.1)
    • deps/OpenVDB: Adjust OpenVDB version requirements vs C++17 #4030 (2.6.0.1)
    • deps: Ptex support for static library #4072 (by Dominik Wójt) (2.6.0.2)
    • deps: Account for header changes in fmt project trunk #4109 (2.6.0.3)
    • deps: Deal with changes in fmt's trunk #4114 (2.6.0.3)
    • deps: Remove Findfmt.cmake #4069 #4103 (by Dominik Wójt) (2.6.0.3)
    • deps: Correctly disable OpenVDB when it's incompatible #4120 (2.6.0.3)
    • deps: Fixes for DCMTK #4147 (2.6.0.3)
    • deps: Fix warning when Freetype is disabled #4177 (2.6.1.0)
    • deps: Remove boost from strutil.cpp #4181 (by Jesse Yurkovich) (2.6.1.0)
    • deps: FindOpenColorIO failed to properly set OpenColorIO_VERSION #4196 (2.6.1.0)
    • Use exported targets for libjpeg-turbo and bump min to 2.1 #3987 (2.6.0.1, 2.5.3.1-beta2)
    • deps: Support fmt 11.0 #4441 (2.6.6.0)
    • deps: Support and test against OCIO 2.4 #4459 #4467 (2.6.6.0)
    • deps: No need for OCIO search to use PREFER_CONFIG #4425 (2.6.6.0)
    • deps: Raise CMake minimum to 3.18.2 #4472 (3.0.0)
    • deps: Remove the enforced upper version limit for fmt #4497 (3.0.0.1)
    • deps: Search for libbz2 only if FFmpeg or FreeType is enabled. #4505 (by jreichel-nvidia) (3.0.0.1)
  • Testing and Continuous integration (CI) systems:
    • Tests for ABI compliance #3983, #3988 (2.6.0.0, 2.5.3.1)
    • tests: Imagebuf_test add benchmarks for iterator traversal #4007 (2.6.0.1)
    • tests: Add opencv regression test #4024 (2.6.0.1)
    • tests: Improve color management test in imagebufalgo_test #4063 (2.6.0.2)
    • tests: Add one more ref output for python-colorconfig test #4065 (2.6.0.2)
    • tests: Shuffle some tests between directories #4091 (2.6.0.2)
    • tests: Fix docs test, used wrong namespace #4090 (2.6.0.2)
    • tests/fixes: Fixes to reduce problems identified by static analysis #4113 (2.6.0.3)
    • tests: Add test for filter values and 'filter_list' query #4140 (2.6.0.3)
    • tests: Add new heif test output #4262 (2.6.2.0)
    • tests: Fix windows quoting for test #4271 (2.6.2.0)
    • tests: Remove unused test output ref from old dependency versions #4370 (2.6.3.0)
    • tests: Add switch to imageinout_test for enabling floating point exceptions. #4463 (by Bram Stolk) (3.0.0)
    • tests: Fixup after directory refactor of OpenImageIO-images #4473 (3.0.0)
    • ci: Some straggler repo renames in the workflows #4025 (2.6.0.1)
    • ci: CI tests on MacOS ARM, and fixes found consequently #4026 (2.6.0.1)
    • ci: Nomenclature change 'os' to 'runner' for clarity #4036 (2.6.0.1)
    • ci: Add tiff-misc reference for slightly changed error messages #4052 (2.6.0.1)
    • ci: Remove MacOS-11 test #4053 (2.6.0.1)
    • ci: Test against gcc-13 #4059 (2.6.0.1)
    • ci: Restrict Mac ARM running #4077 (2.6.0.2)
    • ci: Rename macro to avoid conflict during CI unity builds #4092 (2.6.0.2)
    • ci: Repair Sonar scanner analysis #4097 #4099 (2.6.0.2)
    • ci: Improve parallel builds by basing on number of cores #4115 (2.6.0.3)
    • ci: Update all github actions to their latest versions that's compatible #4129 (2.6.0.3)
    • ci: Bump 'latest' test to newer dep versions, document #4130 (2.6.0.3)
    • ci: Revert to fix scorecard analysis, try version 2.0.6 (2.6.0.3)
    • ci: Start using macos-14 ARM runners, bump latest OCIO #4134 (2.6.0.3)
    • ci: Switch away from deprecated GHA idiom set-output #4141 (2.6.0.3)
    • ci: Add vfx platform 2024 #4163 (2.6.0.3)
    • ci: Fix Windows CI, need to build newer openexr and adjust boost search #4167 (2.6.0.3)
    • ci: Adjust GHA upload-artifact action version #4179 (2.6.1.0)
    • ci: Allow triggering CI workflow from web #4178 (2.6.1.0)
    • ci: Make one of the Mac tests build for avx2 #4188 (2.6.1.0)
    • ci: Enable Windows 2022 CI tests #4195 (2.6.1.0)
    • ci: Update scrorecard workflow to fix breakage #4201 (2.6.1.0)
    • ci: Fix broken Windows CI by building our own libtiff #4214 (2.6.2.0)
    • ci: Typo in build_libtiff.bash #4280 (2.6.2.0)
    • ci: For Windows CI, build only release of vcpkg packages #4282 (2.6.2.0)
    • ci: New tets: oldest, hobbled, localbuilds #4295 (2.6.2.0)
    • ci: Fix GHA CI after they upgraded nodejs #4324 (2.6.3.0)
    • ci: Sanitizer new warnings about signed/unsigned offsets in openexr #4351 (2.6.3.0)
    • ci: Deal with CentOS 7 EOL and disappearance of yum mirrors #4325 (2.6.3.0)
    • ci: CI sanitizer test improvements #4374 (2.6.3.0)
    • ci: Add a workflow that builds docs #4413 (2.6.6.0)
    • ci: Streamline the old MacOS-12 CI test #4465 (2.6.6.0)
    • ci: Test against OpenEXR 3.3 and deal with its 4.0 bump #4466 (2.6.6.0)
    • ci: Make scrorecards workflow not fail constantly #4471
    • ci: Limit when automatic docs building ci happens #4496 (3.0.0.1)
    • ci: Retire deprecated macos12 runner, try beta macos15 #4514 (3.0.0.1)
  • Platform support:
    • win: Fix building failed from source on Windows #4235 (by Vic P) (2.6.2.0)

📚 Notable documentation changes:

  • docs: Convert code examples within the docs to tests that are built executed as part of the testsuite. #3977 #3994 (2.6.0.0, 2.5.3.1) #4039 (by Jeremy Retailleau) #4444 (by Ziad Khouri) #4456 (by pfranz) #4455 (by Ziad Khouri) #4460 (by Lydia Zheng) #4458 (by Danny Greenstein) (2.6.6.0) (3.0.0.0) #4468 (by pfranz) (3.0.0.1)
  • Spruce up the main README and add "Building_the_docs" #3991 (2.6.0.1, 2.5.3.1)
  • docs: Make an example of doc-to-test in the imagebufalgo chapter #4012 (2.6.0.1)
  • docs: Convert examples within the imagebufalgo chapter. #4016 (by Jeremy Retailleau) (2.6.0.1)
  • docs: Added tests for Simple Image input and updated rst #4019 (by Calvin) (2.6.0.1)
  • docs: Convert make_texture doc examples to tests #4027 (by Danny Greenstein) (2.6.0.1)
  • docs: Fix RTD configuration for v2 #4032 (2.6.0.1)
  • docs: Update INSTALL.md to reflect the latest versions we've tested against #4058 (2.6.0.1)
  • docs: Fix typo #4089 (2.6.0.1)
  • docs: Minor change to formatting and naming #4098 (2.6.0.2)
  • docs: Fix link to openexr test images #4080 (by Jesse Yurkovich) (2.6.0.2)
  • security: Document CVE-2023-42295 (2.6.0.1)
  • docs: Fix broken IBA color management documentation #4104 (2.6.0.3)
  • docs: Update SECURITY and RELEASING documentation #4138 (2.6.0.3)
  • docs: Fix tab that was missing from the rendering on rtd #4137 (2.6.0.3)
  • docs: Fix python example #4139 (2.6.0.3)
  • docs: Fix some typos and add missing oiiotool expression explanations #4169 (2.6.1.0)
  • docs: Update INSTALL.md for windows #4279 (by Mel Massadian) (2.6.2.0)
  • doc: Add missing documentation of ImageBuf locking methods #4267 (2.6.2.0)
  • doc: Fixes to formatting and sphinx warnings #4301 (2.6.2.0)
  • docs: Clarify that IBA::rotate params are pixel coordinates #4358 (2.6.3.0)
  • docs: Clarify TextureSystem::create use of imagecache when shared=true #4399 (2.6.3.0)
  • docs: Fix typo where apostrophe was used for possessive of 'it' #4383 (by Joseph Goldstone) (2.6.3.0)
  • docs/security: Document CVE-2024-40630 resolution (2.6.3.0)
  • docs: IBA::st_warp was missing from the documentation #4431 (2.6.6.0)
  • docs: Move some docs files around #4470 (2.6.6.0)
  • docs: Various minor fixes #4477 (3.0.0)
  • docs: Add documenting comments where missing in string_view and span #4478 (3.0.0)
  • docs: Fix typo in description of Strutil::parse_values #4512 (3.0.0.1)

🏢 Project Administration

  • admin: Repo rename -- fix all URL references #3998 #3999
  • admin: Alert slack "release-announcements" channel upon OIIO release #4002 #4046 #4047 #4079 (2.6.0.3)
  • admin: Relicense more code under Apache 2.0 #4038 #3905
  • admin: Account for duplicate emails in the .mailmap #4075 (2.6.0.2)
  • admin: Add a ROADMAP document #4161 (2.6.1.0)
  • docs: Better documentation of past CVE fixes in SECURITY.md #4238 (2.6.2.0)
  • admin: More CLA explanation and how-to links #4318 (2.6.2.0)
  • admin: Add deprecation updates to the RELEASING checklist #4345 (2.6.3.0)
  • admin: Document my git-cliff workflow for release notes #4319 (2.6.3.0)
  • admin: Change docs and comments references master -> main #4435 (2.6.6.0)
  • admin: Update OpenImageIO Roadmap #4469 (by Todica Ionut) (2.6.6.0)
  • admin: Update SECURITY.md for 3.0 beta #4486 (3.0.0.0)

For older release notes, see: