Developer Guide
The Developer Guide contains an overview for building and installing MaterialX C++ and Python, along with detailed documentation for the MaterialX C++ API.
Example Code
The MaterialX Unit Tests are a validation suite for the MaterialX C++ libraries, and can provide a useful guide for coding patterns in MaterialX C++.
The Python Code Examples folder contains a collection of standalone Python scripts that build upon the MaterialX Python API.
Example MaterialX Files
The Example Materials folder of the MaterialX distribution provides examples of uniform, procedural, and textured materials based on a variety of shading models:
- Standard Surface, a shading model developed by Autodesk.
- UsdPreviewSurface, a shading model developed by Pixar.
- glTF PBR, a shading model maintained by Khronos.
- OpenPBR Surface, a shading model maintained by the Academy Software Foundation.
See the BxDF Libraries folder for the MaterialX graph definitions of each of these shading models.
The MaterialX Teapot and Lion, contributed by NVIDIA to the ASWF Digital Production Example Library, are production-quality example assets with materials built entirely from MaterialX nodes.
Additional libraries of MaterialX content are maintained across the community:
- The GPUOpen MaterialX Library, a searchable library of MaterialX examples maintained by AMD under a Creative Commons license.
- The SimReady Materials library, an open collection of USD materials maintained by NVIDIA, authored with MaterialX and OpenPBR Surface.
- Poly Haven, an open library of texture and material assets, supporting downloads in the MaterialX format.
- ambientCG, a public domain library of materials, supporting downloads in the MaterialX format based on OpenPBR Surface.
- Physically Based, a database of reference materials, supporting downloads in the MaterialX format.
Discussion Forum
The Academy Software Foundation Slack is the central discussion forum for the MaterialX project, with a dedicated #materialx channel that is open to the entire community. This venue is appropriate for general questions, feature requests, and discussion of the MaterialX project as a whole.
MaterialX Logo Images
A number of different high-resolution versions of the MaterialX Logo are available for inclusion in application visuals and promotional materials for products using or compatible with MaterialX:
- MaterialXLogo2K.png: Logo with mask, 2048x1580 RGBA, 8-bit per channel, sRGB colorspace (699KB)
- MaterialXLogo2KBlack.png: Logo over black, 2048x1580 RGB, 8-bit per channel, sRGB colorspace (512KB)
- MaterialXLogo2KWhite.png: Logo over white, 2048x1580 RGB, 8-bit per channel, sRGB colorspace (531KB)
