CHANGELOG.md

Version History

Changes in v2.3.0:

• Significantly improved image quality of the RT filter in high quality mode for HDR denoising with prefiltering, i.e., the following combinations of input features and parameters: - HDR color + albedo + normal + cleanAux - albedo - normal In these cases a much more complex filter is used, which results in lower performance than before (about 2x). To revert to the previous performance behavior, please switch to the balanced quality mode.
• Added fast quality mode (OIDN_QUALITY_FAST) for even higher performance (about 1.5-2x) interactive/real-time previews and lower default memory usage at the cost of somewhat lower image quality. Currently this is implemented for the RT filter except prefiltering (albedo, normal). In other cases denoising implicitly falls back to balanced mode.
• Added Intel Arrow Lake, Lunar Lake, and Battlemage GPU support
• Execute Async functions asynchronously on CPU devices as well
• Load/initialize device modules lazily (improves stability)
• Added oidnIsCPUDeviceSupported, oidnIsSYCLDeviceSupported, oidnIsCUDADeviceSupported, oidnIsHIPDeviceSupported, and oidnIsMetalDeviceSupported API functions for checking whether a physical device of a particular type is supported
• Release the CUDA primary context when destroying the device object if using the CUDA driver API
• Added OIDN_LIBRARY_NAME CMake option for setting the base name of the Open Image Denoise library files
• Fixed device creation error with oidnNewDevice when the default device of the specified type (e.g. CUDA) is not supported but there are other supported non-default devices of that type in the system
• Fixed CMake error when building with Metal support using non-Apple Clang
• Fixed iOS build errors
• Added support for building with ROCm 6.x
• oidnNewCUDADevice and oidnNewHIPDevice no longer accept negative device IDs. If the goal is to use the current device, its actual ID needs to be passed.
• Upgraded to oneTBB 2021.12.0 in the official binaries
• Training:
  • Improved training performance on CUDA and MPS devices, added --compile option
  • Added --quality option (high, balanced, fast) for selecting the size of the model to train, changed the default from balanced to high
  • Added new models to the --model option (unet_small, unet_large, unet_xl)
  • Added support for training with prefiltered auxiliary features by passing --aux_results to preprocess.py and train.py
  • Added experimental support for depth (z)

Changes in v2.2.2:

• Fully fixed GPU memory leak when releasing SYCL, CUDA and HIP device objects
• Fixed CUDA context error in some cases when using the CUDA driver API
• Fixed crash on systems with an unsupported AMD Vega integrated GPU and old driver

Changes in v2.2.1:

• Fixed memory leak when releasing SYCL, CUDA and HIP device objects
• Fixed memory leak when initializing Metal filters

Changes in v2.2.0:

• Improved denoising quality (better fine detail reconstruction)
• Added Intel Meteor Lake GPU support (in Intel® Core™ Ultra Processors)
• Added Metal device for Apple silicon GPUs (requires macOS Ventura or newer)
• Added ARM64 (AArch64) CPU support on Windows and Linux (in addition to macOS)
• Improved CPU performance
• Significantly reduced overhead of committing filter changes
• Switched to the CUDA driver API by default, added the OIDN_DEVICE_CUDA_API CMake option for manually selecting between the driver and runtime APIs
• Fixed crash when releasing a buffer after releasing the device

Changes in v2.1.0:

• Added support for denoising 1-channel (e.g. alpha) and 2-channel images
• Added support for arbitrary combinations of input image data types (e.g. OIDN_FORMAT_FLOAT3 for color but OIDN_FORMAT_HALF3 for albedo)
• Improved performance for most dedicated GPU architectures
• Re-added OIDN_STATIC_LIB CMake option which enables building as a static (CPU support only) or a hybrid static/shared (GPU support as well) library
• Added release() method to C++ API objects (DeviceRef, BufferRef, FilterRef)
• Fixed possible crash when releasing GPU devices, buffers or filters
• Fixed possible crash at process exit for some SYCL runtime versions
• Fixed image quality inconsistency on Intel integrated GPUs, but at the cost of some performance loss
• Fixed future Windows driver compatibility for Intel integrated GPUs
• Fixed rare output corruption on AMD RDNA2 GPUs
• Fixed device detection on Windows when the path to the library has non-ANSI characters
• Added support for Intel® oneAPI DPC++/C++ Compiler 2024.0 and compatible open source compiler versions
• Upgraded to oneTBB 2021.10.0 in the official binaries
• Improved detection of old oneTBB versions

Changes in v2.0.1:

• Fixed performance issue for Intel integrated GPUs using recent Linux drivers
• Fixed crash on systems with both dedicated and integrated AMD GPUs
• Fixed importing D3D12_RESOURCE, D3D11_RESOURCE, D3D11_RESOURCE_KMT, D3D11_TEXTURE and D3D11_TEXTURE_KMT external memory types on CUDA and HIP devices
• Fixed the macOS deployment target of the official x86 binaries (lowered from 11.0 to 10.11)
• Minor improvements to verbose output

Changes in v2.0.0:

• Added SYCL device for Intel Xe architecture GPUs (Xe-LP, Xe-HPG and Xe-HPC)
• Added CUDA device for NVIDIA Volta, Turing, Ampere, Ada Lovelace and Hopper architecture GPUs
• Added HIP device for AMD RDNA2 (Navi 21 only) and RDNA3 (Navi 3x) architecture GPUs
• Added new buffer API functions for specifying the storage type (host, device or managed), copying data to/from the host, and importing external buffers from graphics APIs (e.g. Vulkan, Direct3D 12)
• Removed the oidnMapBuffer and oidnUnmapBuffer functions
• Added support for asynchronous execution (e.g. oidnExecuteFilterAsync, oidnSyncDevice functions)
• Added physical device API for querying the supported devices in the system
• Added functions for creating a device from a physical device ID, UUID, LUID or PCI address (e.g. oidnNewDeviceByID)
• Added SYCL, CUDA and HIP interoperability API functions (e.g. oidnNewSYCLDevice, oidnExecuteSYCLFilterAsync)
• Added type device parameter for querying the device type
• Added systemMemorySupported and managedMemorySupported device parameters for querying memory allocations supported by the device
• Added externalMemoryTypes device parameter for querying the supported external memory handle types
• Added quality filter parameter for setting the filtering quality mode (high or balanced quality)
• Minor API changes with backward compatibility:
  • Added oidn(Get|Set)(Device|Filter)(Bool|Int|Float) functions and deprecated oidn(Get|Set)(Device|Filter)(1b|1i|1f) functions
  • Added oidnUnsetFilter(Image|Data) functions and deprecated oidnRemoveFilter(Image|Data) functions
  • Renamed alignment and overlap filter parameters to tileAlignment and tileOverlap but the old names remain supported
• Removed OIDN_STATIC_LIB and OIDN_STATIC_RUNTIME CMake options due to technical limitations
• Fixed over-conservative buffer bounds checking for images with custom strides
• Upgraded to oneTBB 2021.9.0 in the official binaries

Changes in v1.4.3:

• Fixed hardcoded library paths in installed macOS binaries
• Disabled VTune profiling support of oneDNN kernels by default, can be enabled using CMake options if required (DNNL_ENABLE_JIT_PROFILING and DNNL_ENABLE_ITT_TASKS)
• Upgraded to oneTBB 2021.5.0 in the official binaries

Changes in v1.4.2:

• Added support for 16-bit half-precision floating-point images
• Added oidnGetBufferData and oidnGetBufferSize functions
• Fixed performance issue on x86 hybrid architecture CPUs (e.g. Alder Lake)
• Fixed build error when using OpenImageIO 2.3 or later
• Upgraded to oneTBB 2021.4.0 in the official binaries

Changes in v1.4.1:

• Fixed crash when in-place denoising images with certain unusual resolutions
• Fixed compile error when building for Apple Silicon using some unofficial builds of ISPC

Changes in v1.4.0:

• Improved fine detail preservation
• Added the cleanAux filter parameter for further improving quality when the auxiliary feature (albedo, normal) images are noise-free
• Added support for denoising auxiliary feature images, which can be used together with the new cleanAux parameter for improving quality when the auxiliary images are noisy (recommended for final frame denoising)
• Normals are expected to be in the [-1, 1] range (but still do not have to be normalized)
• Added the oidnUpdateFilterData function which must be called when the contents of an opaque data parameter bound to a filter (e.g. weights) has been changed after committing the filter
• Added the oidnRemoveFilterImage and oidnRemoveFilterData functions for removing previously set image and opaque data parameters of filters
• Reduced the overhead of oidnCommitFilter to zero in some cases (e.g. when changing already set image buffers/pointers or the inputScale parameter)
• Reduced filter memory consumption by about 35%
• Reduced total memory consumption significantly when using multiple filters that belong to the same device
• Reduced the default maximum memory consumption to 3000 MB
• Added the OIDN_FILTER_RT and OIDN_FILTER_RTLIGHTMAP CMake options for excluding the trained filter weights from the build to significantly decrease its size
• Fixed detection of static TBB builds on Windows
• Fixed compile error when using future glibc versions
• Added oidnBenchmark option for setting custom resolutions
• Upgraded to oneTBB 2021.2.0 in the official binaries

Changes in v1.3.0:

• Improved denoising quality
  • Improved sharpness of fine details / less blurriness
  • Fewer noisy artifacts
• Slightly improved performance and lowered memory consumption
• Added directional (e.g. spherical harmonics) lightmap denoising to the RTLightmap filter
• Added inputScale filter parameter which generalizes the existing (and thus now deprecated) hdrScale parameter for non-HDR images
• Added native support for Apple Silicon and the BNNS library on macOS (currently requires rebuilding from source)
• Added OIDN_NEURAL_RUNTIME CMake option for setting the neural network runtime library
• Reduced the size of the library binary
• Fixed compile error on some older macOS versions
• Upgraded release builds to use oneTBB 2021.1.1
• Removed tbbmalloc dependency
• Appended the library version to the name of the directory containing the installed CMake files
• Training:
  • Faster training performance
  • Added mixed precision training (enabled by default)
  • Added efficient data-parallel training on multiple GPUs
  • Enabled preprocessing datasets multiple times with possibly different options
  • Minor bugfixes

Changes in v1.2.4:

• Added OIDN_API_NAMESPACE CMake option that allows to put all API functions inside a user-defined namespace
• Fixed bug when TBB_USE_GLIBCXX_VERSION is defined
• Fixed compile error when using an old compiler which does not support OpenMP SIMD
• Added compatibility with oneTBB 2021
• Export only necessary symbols on Linux and macOS

Changes in v1.2.3:

• Fixed incorrect detection of AVX-512 on macOS (sometimes causing a crash)
• Fixed inconsistent performance and costly initialization for AVX-512
• Fixed JIT'ed AVX-512 kernels not showing up correctly in VTune

Changes in v1.2.2:

• Fixed unhandled exception when canceling filter execution from the progress monitor callback function

Changes in v1.2.1:

• Fixed tiling artifacts when in-place denoising (using one of the input images as the output) high-resolution (> 1080p) images
• Fixed ghosting/color bleeding artifacts in black regions when using albedo/normal buffers
• Fixed error when building as a static library (OIDN_STATIC_LIB option)
• Fixed compile error for ISPC 1.13 and later
• Fixed minor TBB detection issues
• Fixed crash on pre-SSE4 CPUs when using some recent compilers (e.g. GCC 10)
• Link C/C++ runtime library dynamically on Windows too by default
• Renamed example apps (oidnDenoise, oidnTest)
• Added benchmark app (oidnBenchmark)
• Fixed random data augmentation seeding in training
• Fixed training warning with PyTorch 1.5 and later

Changes in v1.2.0:

• Added neural network training code
• Added support for specifying user-trained models at runtime
• Slightly improved denoising quality (e.g. less ringing artifacts, less blurriness in some cases)
• Improved denoising speed by about 7-38% (mostly depending on the compiler)
• Added OIDN_STATIC_RUNTIME CMake option (for Windows only)
• Added support for OpenImageIO to the example apps (disabled by default)
• Added check for minimum supported TBB version
• Find debug versions of TBB
• Added testing

Changes in v1.1.0:

• Added RTLightmap filter optimized for lightmaps
• Added hdrScale filter parameter for manually specifying the mapping of HDR color values to luminance levels

Changes in v1.0.0:

• Improved denoising quality
  • More details preserved
  • Less artifacts (e.g. noisy spots, color bleeding with albedo/normal)
• Added maxMemoryMB filter parameter for limiting the maximum memory consumption regardless of the image resolution, potentially at the cost of lower denoising speed. This is internally implemented by denoising the image in tiles
• Significantly reduced memory consumption (but slightly lower performance) for high resolutions (> 2K) by default: limited to about 6 GB
• Added alignment and overlap filter parameters that can be queried for manual tiled denoising
• Added verbose device parameter for setting the verbosity of the console output, and disabled all console output by default
• Fixed crash for zero-sized images

Changes in v0.9.0:

• Reduced memory consumption by about 38%
• Added support for progress monitor callback functions
• Enabled fully concurrent execution when using multiple devices
• Clamp LDR input and output colors to 1
• Fixed issue where some memory allocation errors were not reported

Changes in v0.8.2:

• Fixed wrong HDR output when the input contains infinities/NaNs
• Fixed wrong output when multiple filters were executed concurrently on separate devices with AVX-512 support. Currently the filter executions are serialized as a temporary workaround, and a full fix will be included in a future release.
• Added OIDN_STATIC_LIB CMake option for building as a static library (requires CMake 3.13.0 or later)
• Fixed CMake error when adding the library with add_subdirectory() to a project

Changes in v0.8.1:

• Fixed wrong path to TBB in the generated CMake configs
• Fixed wrong rpath in the binaries
• Fixed compile error on some macOS systems
• Fixed minor compile issues with Visual Studio
• Lowered the CPU requirement to SSE4.1
• Minor example update

Changes in v0.8.0:

• Initial beta release