MaterialX Versions Save

Added

• Added support for environment light intensity in generated GLSL shaders.

Changed

• Removed an extra suffix from element names in texture baking.

Fixed

• Moved environment prefilter functions to their referencing GLSL files, addressing shader compilation errors in USD.
• Enabled color and unit transforms on root nodes in shader generation, addressing missing color transforms in USD.
• Updated document caches to store elements in declaration order, addressing compiler-dependent behavior in nodedef lookups.
• Switched to framework linkage for OpenGL libraries on MacOS, addressing build issues in downstream projects.
• Switched to legacy OpenGL libraries for Python wheels on Linux, addressing missing OpenGL functionality in Python wheels.
• Added a missing vertex data prefix in Vulkan GLSL shader generation.

Added

• Added an initial NPR (non-photorealistic rendering) data library to MaterialX, supporting the View Direction, Facing Ratio, and Gooch Shading nodes.
• Added new nodes to the standard data library, including Reflect, Refract, Safe Power, Create Matrix, and Round.
• Added support for the generation of pre-filtered environment maps in MaterialX GLSL and MSL.
• Added support for geometry drag & drop, frame capture, UI ranges and enumerated values in the MaterialX Web Viewer.
• Added floating popups for hovered pins in the MaterialX Graph Editor.
• Added UI ranges to the 'useSpecularWorkflow' and 'normal' inputs of the UsdPreviewSurface shading model.
• Added versioning rules for the MaterialX API and data libraries to the developer guide.
• Added initial C++ fuzz tests and coverage tests to GitHub Actions CI.
• Added GCC 13, Clang 15, and Python 3.12 builds to GitHub Actions CI.

Changed

• Enabled the new OSL closures by default in shader generation, with the MATERIALX_OSL_LEGACY_CLOSURES flag used to request legacy closures.
• Updated the MaterialX Web Viewer to three.js r152.
• Switched to a more efficient representation of HDR images in the MaterialX Web Viewer.
• Improved the logic for connecting pins in the MaterialX Graph Editor.
• Improved the handling of filename inputs in OSL shader generation.
• Reduced the size of the MaterialX data libraries, improving the use of graph definitions and merging duplicate implementations.
• Raised the minimum CMake version to CMake 3.16.
• Updated the C++ unit test library to Catch 2.13.10.

Fixed

• Fixed the attenuation of coated emission in the Standard Surface shading model.
• Fixed the implementation of the overlay node in shader generation.
• Fixed an edge case for type pointer comparisons in shader generation.
• Fixed an edge case for transform nodes in GLSL and MSL shader generation.
• Fixed the implementation of mx_hsvtorgb in MDL shader generation.
• Fixed orphaned links when deleting nodes in the MaterialX Graph Editor.
• Fixed scroll wheel interactions across windows of the MaterialX Graph Editor.
• Fixed the generation of unused imgui.ini files in the MaterialX Graph Editor.
• Fixed a dependency on module import order in MaterialX Python.
• Fixed an off-by-one index check in Element::setChildIndex.
• Fixed a missing null check in Graph::propertyEditor.
• Fixed cases where absolute paths were stored in MaterialXConfig.cmake.

Added

• Added a broad set of new pattern nodes to MaterialX, including Circle, Hexagon, Cloverleaf, Line, Grid, Crosshatch, Checkerboard, Random Color, Random Float, Triangle Wave, Integer Floor, Integer Ceiling, and Distance.
• Added support for MaterialX builds on iOS.
• Added support for drag-and-drop import of MaterialX files in the Web Viewer.
• Added generation of MaterialX Python wheels in GitHub Actions, enabling the distribution of MaterialX Python packages through PyPI.
• Added support for the lin_displayp3 and srgb_displayp3 colorspaces in shader generation.
• Added support for the blackbody PBR node in shader generation.
• Added support for displacement in MDL generation.
• Added blend and up-axis controls to the triplanar projection node.
• Added version details to shared libraries on Windows.
• Added a MacOS 13 build to GitHub Actions.

Changed

• Raised the minimum C++ version for MaterialX builds to C++14.
• Upgraded the PyBind11 library to version 2.10.4, raising the minimum Python version to 3.6, and enabling support for Python versions 3.11 and beyond.
• Improved the performance and convergence of GGX importance sampling in GLSL generation, leveraging insights from the HPG 2023 paper by Jonathan Dupuy and Anis Benyoub.
• Improved property panel display in the MaterialX Graph Editor.
• Improved node spacing in the MaterialX Graph Editor.
• Improved the robustness of MaterialX unit tests with respect to the current working directory.
• Simplified the handling of default colors in GLSL generation, removing dynamic branches on texture size.
• Simplified the definitions of the default color transforms, implementing them as language-independent MaterialX graphs.
• Simplified the interface of ShaderGenerator::emitFunctionCall, marking its original interface as deprecated.
• Marked legacy interfaces for findRenderableElements and findRenderableMaterialNodes as deprecated, making their usage visible to clients as compiler warnings.
• Moved the MaterialX specification to public Markdown files in GitHub, enabling direct contributions from the community.

Fixed

• Fixed brightness artifacts in the triplanar projection node.
• Aligned default values for conductor_bsdf with the MaterialX specification.
• Fixed volume mixing in MDL generation.
• Fixed a bug to improve shader generation determinism.
• Fixed a bug to improve the consistency of auto layout in the MaterialX Graph Editor.
• Fixed a bug to enable multi-output connection edits in the MaterialX Graph Editor.
• Fixed a bug in dot node optimizations for shader generation.

Added

• Added the MaterialX Graph Editor, an example application for visualizing, creating, and editing MaterialX graphs.
• Added support for the Metal Shading Language in MaterialX shader generation and rendering.
• Added support for the generalized_schlick_edf node, enabling the expression of coated emissive surfaces.
• Added support for the adobergb and lin_adobergb color spaces in shader generation.
• Added uisoftmin and uisoftmax attributes to mix nodes and IOR inputs.
• Added support for authored bitangent vectors in GLSL, selected by the hwImplicitBitangents generator option.
• Added a tangent input to the glTF PBR shading model.
• Added a Clang Format step to GitHub Actions builds.
• Added support for Xcode 14.

Changed

• Included the standard data libraries in MaterialX Python packages.
• Improved the support library and node implementations for OSL generation.
• Updated MDL shader generation to support MDL 1.7.
• Improved the handling of functional graphs in MDL generation.
• Upgraded the NanoGUI version in the viewer to support Apple M1 builds.
• Upgraded the Catch library to version 2.13.9.

Fixed

• Fixed logic for tangent basis orthogonalization in generated GLSL.
• Fixed logic for metallic F90 and an opacity edge case in UsdPreviewSurface.
• Fixed parsing of inline source code variables in node implementations.

Added

• Added new Unified Noise, Color Correct, and Bump nodes, providing artistic interfaces over the standard procedural, adjustment, and geometric primitives.
• Added shader generation support for the MaterialX closures in OSL, selected by a new CMake build option.
• Added a shader translation graph from Autodesk Standard Surface to glTF PBR.
• Added support for the transmission_extra_roughness input in the Standard Surface shading model.
• Added support for the iridescence inputs in the glTF PBR shading model.
• Added support for the subsurface_bsdf node in MDL.
• Added an operationorder input to the 'place2d' node.
• Extended the mix node to support multi-channel interpolators.
• Extended the flattenSubgraphs method to handle a broader range of graph structures.

Changed

• Improved the alignment of the UsdPreviewSurface shading graph with reference implementations.
• Improved the accuracy of the thin-film BSDF implementation in GLSL.
• Improved code generation for the mix node of 'surfaceshader' type.
• Removed add and multiply nodes for 'surfaceshader', 'volumeshader', and 'displacementshader' types.
• Refactored and extended the Advanced Options panel in MaterialXView.

Fixed

• Fixed the implementation of the screen compositing node in GLSL, OSL, and MDL.
• Fixed parent/child precedence in the getGeometryBindings function.
• Fixed OpenGL errors when unbinding geometry in MaterialXView on MacOS.

Added

• Added a refraction approximation for transmissive surfaces in GLSL, selected by the hwTransmissionRenderMethod generator option.
• Added support for generalized Schlick transmission in GLSL and OSL.
• Added support for code generation from material nodes.
• Added a specialization of GlslShaderGenerator for Vulkan GLSL generation.
• Added the Chess Set example from the Karma: A Beautiful Game tutorial. Contributed to the MaterialX project by SideFX, original artwork by Moeen and Mujtaba Sayed.
• Added static and dynamic analysis tests to GitHub Actions builds.
• Added support for GCC 12, Clang 13, and Clang 14.

Changed

• Switched to relative shader includes within the MaterialX data libraries, enabling custom folder names in distributions.
• Improved and extended the sample Web Viewer.

Fixed

• Fixed math for normalizing normal and tangent vectors in GLSL.
• Fixed math for transforming a vector4 by a matrix in OSL.
• Fixed compatibility of OSL Worley noise with OSL 1.9.10.
• Fixed layering of thin-film effects in the Standard Surface shading model.
• Fixed input default values in the glTF PBR shading model.

Added

• Added JavaScript bindings for MaterialXCore, MaterialXFormat, and MaterialXGenGlsl.
• Added a sample Web Viewer, built and deployed through GitHub Actions.
• Added a MaterialX graph for the glTF PBR shading model.
• Added new 'worleynoise2d' and 'worleynoise3d' nodes, with implementations in GLSL, OSL, and MDL.
• Added new 'surface_unlit' node, with implementations in GLSL, OSL, and MDL.
• Added support for the glTF geometry format in MaterialXRender and MaterialXView.

Changed

• Moved the MaterialX project to the Academy Software Foundation GitHub.
• Removed hardcoded references to "libraries" in calls to GenContext::registerSourceCodeSearchPath. (See Developer Notes below for additional details.)
• Improved the accuracy of mx_ggx_dir_albedo_analytic and mx_fresnel_conductor in GLSL.
• Updated the PyBind11 library to version 2.9.0.

Fixed

• Aligned GLSL and MDL implementations of 'fractal3d' with OSL.
• Fixed MDL implementations of 'sheen_bsdf' and 'thin_film_bsdf'.
• Fixed an error in code generation from multi-output node graphs.

Developer Notes

• This release removes hardcoded references to "libraries" in calls to GenContext::registerSourceCodeSearchPath within the MaterialX codebase. Applications with their own custom code generators should make the same change, removing hardcoded references to "libraries" in calls to GenContext::registerSourceCodeSearchPath. See pull request 877 for coding details.

Added

• Added an inheritance structure for versions of Autodesk Standard Surface.
• Added versioning and customization support to MaterialX namespaces in C++.
• Added preprocessor definitions for the API version to MaterialXCore.
• Added color transform methods to the Image class.
• Added an initial ClangFormat file for the MaterialX codebase.
• Added initial support for FreeBSD.
• Added support for Xcode 13.

Changed

• Refactored BSDF handling in shader generation, allowing for more flexible and efficient vertical layering.
• Optimized GLSL implementations for GGX specular, moving common computations to tangent space.
• Refactored the TextureBaker API for clarity and flexibility.
• Merged the ViewHandler and viewer camera into a new Camera class in MaterialXRender.
• Updated CMake configuration generation logic, adding handling for shared library builds.
• Updated the PyBind11 library to version 2.7.1

Fixed

• Fixed a performance regression in MaterialXView for multi-UDIM assets.
• Fixed a bug that caused shader inputs to be skipped in createUIPropertyGroups.
• Fixed the value of transmission roughness in UsdPreviewSurface.
• Fixed Vulkan compatibility for generated GLSL code.

Added

• Added an initial shader translation graph from Autodesk Standard Surface to UsdPreviewSurface.
• Added example script translateshader.py with validation in GitHub Actions.
• Added support for filename templates in texture baking.
• Added graph definitions for the MaterialX Lama node set.
• Added UI properties to the interface of UsdPreviewSurface.
• Added an initial ESSL shader generator.
• Added support for GCC 11.

Changed

• Improved the accuracy of directional albedo computations for GGX specular and Imageworks sheen.
• Updated default color space names to follow ACES 1.2 conventions (e.g. g22_rec709), while maintaining compatibility with legacy names (e.g. gamma22).

Fixed

• Fixed the default value of the roughness input of UsdPreviewSurface.
• Fixed the assignment of channel names in EXR files written through OpenImageIO.

Added

• Added support for shared library builds on Windows.
• Added support for 16-bit unsigned integer images in MaterialXRender.
• Added support for compound nodegraphs with user interfaces in shader and UI generation.
• Added headers for newly proposed MaterialX closures in OSL.
• Added a shader translation command to the viewer, assigned to the 'T' hotkey.

Changed

• Improved the memory efficiency of texture baking operations.
• Improved the compatibility of generated MDL code with Omniverse.
• Refactored image resolution logic into new methods ImageHandler::getReferencedImages and MaterialX::getMaxDimensions.
• Moved the viewer hotkey for GLSL code generation from 'S' to 'G' for consistency with other languages.

Fixed

• Fixed the Color3.asTuple and Color4.asTuple methods in Python