materialxMaterials: An HTML repository from kwokcb

MaterialX Materials

Introduction

Welcome to MaterialX Materials.

This site hosts a set of libraries and command line utilities to query remote databases for MaterialX materials.

Visit the Home Page

Related utilities and libraries can be found at the:

MaterialXLab home page

The current utilities support:

PhysicallyBased database Material descriptions can be downloaded with additional utilities to create materials using either: Autodesk Standard Surface, OpenPBR, or glTF PBR shading model shaders.

AMD GPUOpen database MaterialX packages can be downloaded (as zip files). Images and MaterialX documents can be extracted for any of the posted materials in the database.

Each currently has Python implementations.

Usage Examples

An interactive page:

for extracting PhysicallyBased uses a Javascript implementation found here

A command line utility is available here. This uses Node.js to allow access to fetch materials from the GPU Open site(which is not available via a web page).

Below are screenshots of materials fetched from from PhysicallyBased and GPU Open (left and right images respectively). Note that the material zip from GPU Open is directly read in.

Dependencies

The Python utilities require:

The MaterialX 1.39 or greater package for PhysicallyBased OpenPBR shader creation
The requests package.
The pillow package for image handling for GPUOpen package handling

The GPUOpen Javascript logic requires:

node-fetch if fetch is not available in the version of Node.js used.
yargs for the command line utility

Building

The GitHub repository can be cloned.

The Python package can be built using:

pip install .

This will pull down the dependent Python packages as needed.

The GPUOpen Javascript utility requires Node.js to be installed. From the package folder (javascript\JsGPUOpenLoaderPackage) the following should be run:

npm install     # Install dependent packages
npm run build   # Setup runtime area

Usage

Python Commands

Query all materials fom PhysicallyBased and convert them to all support shading models. Save the material list and corresponding MaterialX files in the default output location. The build will include this information Python package under the data folder.
```
python physicallyBasedMaterialXCmd.py
```
or
```
python -m materialxMaterials physbased
```
Query all materials fom GPUOpen. Extract out a few material packages (zip). Save the material lists, material names and unzipped packages (MaterialX and images) in the default output location. The build will include this information Python package under the data folder.
```
python GPUOpenLoaderCmd.py --materialNames=1 --saveMaterials=1 
```
or
```
python -m materialxMaterials gpuopen --materialNames=1 --saveMaterials=1
```

GPU Open Node.js Utility

The utility can be run from the javascript\JsGPUOpenLoaderPackage folder as follows:

npm start -- [<arguments>]

or:

node gpuOpenFetch.js [<arguments>]

with the appropriate arguments. It supports the same options as the Python utility -- namely material information, and package (zip) downloads. For the following 2 lines are equivalent to download a material called "Moss Green Solid Granite".

node gpuOpenFetch.js  -n "Moss Green Solid Granite"
npm start -- -n "Moss Green Solid Granite"

Library

A Jupyter notebook demonstrates the direct usage of the Python library. The output of the notebook can be found here. The notebook can found in the Github repository under the examples folder.