+
+
+
+
+
+
+
+
+
+ Figure: From left to right: "Aluminum", "Sapphire", "Whiteboard", and "Tire" examples
+
+
+
+Translation and baking are useful to just convert shading models. Below is a snapshot of a few materials which were downloaded from +the Physical Based Site which is maintained by Anton Palmqvist. The materials were converted from MaterialX with the preview using the ThreeJS editor:
+
+ Figure: From left to right: "Aluminum", "Sapphire", "Whiteboard", and "Tire" examples
+
+
+
+![](\"./images/ThreeJS_editor_baked_marble.png\")
"
]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "Translation and baking are useful to just convert shading models. Below is a snapshot of a few materials which were downloaded from\n",
+ " the [Physical Based Site](https://physicallybased.info/) which is maintained by Anton Palmqvist. The materials were converted from MaterialX with the preview using the ThreeJS editor:\n",
+ "\n",
+ " ![](\"./images/PhysicallyBasedExamples.png\")
\n",
+ " Figure: From left to right: \"Aluminum\", \"Sapphire\", \"Whiteboard\", and \"Tire\" examples"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "## Convenience Functions and Command Line Tools\n",
+ "\n",
+ "The following are convenience functions and command line tools which are provided as part of this package.\n",
+ "\n",
+ "- The file `mtlx2gltf.py`` contains a command line tool that uses a utility function `mtlx2gltf` to convert from MaterialX to glTF.\n",
+ "Various command line options are mapped to conversion options (`MTLX2GLTFOptions`).\n",
+ "```bash\n",
+ "usage: mtlx2gltf.py [-h] [--gltfFileName GLTFFILENAME] [--gltfGeomFileName GLTFGEOMFILENAME] [--primsPerMaterial PRIMSPERMATERIAL]\n",
+ " [--packageBinary PACKAGEBINARY] [--translateShaders TRANSLATESHADERS] [--bakeTextures BAKETEXTURES]\n",
+ " [--bakeResolution BAKERESOLUTION]\n",
+ " mtlxFileName\n",
+ "\n",
+ "Utility to convert a MaterialX file to a glTF file\n",
+ "\n",
+ "positional arguments:\n",
+ " mtlxFileName Path containing MaterialX file to convert.\n",
+ "\n",
+ "options:\n",
+ " -h, --help show this help message and exit\n",
+ " --gltfFileName GLTFFILENAME\n",
+ " Name of MaterialX output file. If not specified the glTF name with \"_tomtlx.mtlx\" suffix will be used\n",
+ " --gltfGeomFileName GLTFGEOMFILENAME\n",
+ " Name of MaterialX output file. If not specified the glTF name with \"_tomtlx.mtlx\" suffix will be used\n",
+ " --primsPerMaterial PRIMSPERMATERIAL\n",
+ " Create a new primitive per material and assign the material. Default is False\n",
+ " --packageBinary PACKAGEBINARY\n",
+ " Create a biary packaged GLB file. Default is False\n",
+ " --translateShaders TRANSLATESHADERS\n",
+ " Translate shaders to glTF. Default is False\n",
+ " --bakeTextures BAKETEXTURES\n",
+ " Bake pattern graphs as textures. Default is False\n",
+ " --bakeResolution BAKERESOLUTION\n",
+ " Bake image resolution. Default is 256\n",
+ "``` \n",
+ "- The file gltf2mtlx.py contains a command line tool that uses a utility function to convert from glTF to MaterialX.\n",
+ "Various command line options are mapped to conversion options (`GLTF2MTLXOptions`).\n",
+ "```bash\n",
+ "usage: gltf2mtlx.py [-h] [--mtlxFileName MTLXFILENAME] [--createAssignments CREATEASSIGNMENTS] gltfFileName\n",
+ "\n",
+ "Utility to convert a glTF file to MaterialX file\n",
+ "\n",
+ "positional arguments:\n",
+ " gltfFileName Path containing glTF file to convert.\n",
+ "\n",
+ "options:\n",
+ " -h, --help show this help message and exit\n",
+ " --mtlxFileName MTLXFILENAME\n",
+ " Name of MaterialX output file. If not specified the glTF name with \"_tomtlx.mtlx\" suffix will be used\n",
+ " --createAssignments CREATEASSIGNMENTS\n",
+ " Create material assignments. Default is True\n",
+ "```\n",
+ "### Image and Geometry Pathing\n",
+ "\n",
+ "glTF does not allow for any pathing specifieds on resources such as image and geometry uris. As such the proper pathing\n",
+ "must be set before packaging to glb files. This is handled during the packaing process which uses the `pygltflib` Python package.\n",
+ "\n",
+ "By default `mtlx2gltf`adds search paths (mx.FileSearchPath) to attempt to find the absoluate location of the uri resources, sets the uri and hen performs binary packing. Thus it is possible for instance to specify embedding geometry which is not in the same folder as the root glTF file.\n",
+ "\n",
+ "The examples at the beginning of this document show an example Adobe Substance 3D material which was exported and mapped to a MaterialX material. Then it was converted to glTF with different geometry paths.\n"
+ ]
}
],
"metadata": {
diff --git a/docs/examples.py b/docs/examples.py
index 51263f8..3e5dca5 100644
--- a/docs/examples.py
+++ b/docs/examples.py
@@ -1,17 +1,21 @@
# %% [markdown]
-# ### Using The Core Library
-#
-# This notebook provides a set of sample code which demonstrates the
-# workflow to convert between glTF and MaterialX.
+#
#
-# The sample input file is the "BoomBox with Axes" file from the glTF sample repository found [here](https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0/BoomBoxWithAxes/glTF) is used to demonstrate glTF to MaterialX conversion.
+# ### Using The Core Library
#
-# The resulting MaterialX file after conversion is used to demonstrate conversion to glTF.
+# This notebook provides a set of sample code which demonstrates the workflow to convert between glTF and MaterialX.
#
-#
+# The sample input file is the "BoomBox with Axes" file from the glTF sample repository found [here](https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0/BoomBoxWithAxes/glTF) is used to demonstrate glTF to MaterialX conversion. The resulting MaterialX file after conversion is used to demonstrate conversion to glTF.
#
-# 
+# %% [markdown]
+# Translation and baking are useful to just convert shading models. Below is a snapshot of a few materials which were downloaded from
+# the [Physical Based Site](https://physicallybased.info/) which is maintained by Anton Palmqvist. The materials were converted from MaterialX with the preview using the ThreeJS editor:
+#
+#
+# Figure: From left to right: "Aluminum", "Sapphire", "Whiteboard", and "Tire" examples
+
+# %% [markdown]
+# ## Convenience Functions and Command Line Tools
+#
+# The following are convenience functions and command line tools which are provided as part of this package.
+#
+# - The file `mtlx2gltf.py`` contains a command line tool that uses a utility function `mtlx2gltf` to convert from MaterialX to glTF.
+# Various command line options are mapped to conversion options (`MTLX2GLTFOptions`).
+# ```bash
+# usage: mtlx2gltf.py [-h] [--gltfFileName GLTFFILENAME] [--gltfGeomFileName GLTFGEOMFILENAME] [--primsPerMaterial PRIMSPERMATERIAL]
+# [--packageBinary PACKAGEBINARY] [--translateShaders TRANSLATESHADERS] [--bakeTextures BAKETEXTURES]
+# [--bakeResolution BAKERESOLUTION]
+# mtlxFileName
+#
+# Utility to convert a MaterialX file to a glTF file
+#
+# positional arguments:
+# mtlxFileName Path containing MaterialX file to convert.
+#
+# options:
+# -h, --help show this help message and exit
+# --gltfFileName GLTFFILENAME
+# Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+# --gltfGeomFileName GLTFGEOMFILENAME
+# Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+# --primsPerMaterial PRIMSPERMATERIAL
+# Create a new primitive per material and assign the material. Default is False
+# --packageBinary PACKAGEBINARY
+# Create a biary packaged GLB file. Default is False
+# --translateShaders TRANSLATESHADERS
+# Translate shaders to glTF. Default is False
+# --bakeTextures BAKETEXTURES
+# Bake pattern graphs as textures. Default is False
+# --bakeResolution BAKERESOLUTION
+# Bake image resolution. Default is 256
+# ```
+# - The file gltf2mtlx.py contains a command line tool that uses a utility function to convert from glTF to MaterialX.
+# Various command line options are mapped to conversion options (`GLTF2MTLXOptions`).
+# ```bash
+# usage: gltf2mtlx.py [-h] [--mtlxFileName MTLXFILENAME] [--createAssignments CREATEASSIGNMENTS] gltfFileName
+#
+# Utility to convert a glTF file to MaterialX file
+#
+# positional arguments:
+# gltfFileName Path containing glTF file to convert.
+#
+# options:
+# -h, --help show this help message and exit
+# --mtlxFileName MTLXFILENAME
+# Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+# --createAssignments CREATEASSIGNMENTS
+# Create material assignments. Default is True
+# ```
+# ### Image and Geometry Pathing
+#
+# glTF does not allow for any pathing specifieds on resources such as image and geometry uris. As such the proper pathing
+# must be set before packaging to glb files. This is handled during the packaing process which uses the `pygltflib` Python package.
+#
+# By default `mtlx2gltf`adds search paths (mx.FileSearchPath) to attempt to find the absoluate location of the uri resources, sets the uri and hen performs binary packing. Thus it is possible for instance to specify embedding geometry which is not in the same folder as the root glTF file.
+#
+# The examples at the beginning of this document show an example Adobe Substance 3D material which was exported and mapped to a MaterialX material. Then it was converted to glTF with different geometry paths.
+#
+
diff --git a/docs/gallery.html b/docs/gallery.html
index 759e2e4..b8582e3 100644
--- a/docs/gallery.html
+++ b/docs/gallery.html
@@ -354,7 +354,7 @@
-
+
-
-
+
diff --git a/docs/examples.ipynb b/docs/examples.ipynb
index 77a7a41..8d2e03e 100644
--- a/docs/examples.ipynb
+++ b/docs/examples.ipynb
@@ -4,18 +4,23 @@
"cell_type": "markdown",
"metadata": {},
"source": [
- "### Using The Core Library\n",
+ "\n",
"\n",
- "This notebook provides a set of sample code which demonstrates the \n",
- "workflow to convert between glTF and MaterialX.\n",
+ "### Using The Core Library\n",
"\n",
- "The sample input file is the \"BoomBox with Axes\" file from the glTF sample repository found [here](https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0/BoomBoxWithAxes/glTF) is used to demonstrate glTF to MaterialX conversion.\n",
+ "This notebook provides a set of sample code which demonstrates the workflow to convert between glTF and MaterialX.\n",
"\n",
- "The resulting MaterialX file after conversion is used to demonstrate conversion to glTF.\n",
+ "The sample input file is the \"BoomBox with Axes\" file from the glTF sample repository found [here](https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0/BoomBoxWithAxes/glTF) is used to demonstrate glTF to MaterialX conversion. The resulting MaterialX file after conversion is used to demonstrate conversion to glTF.\n",
"\n",
- "\n",
+ "| | |\n",
+ "| :--: | :--: |\n",
+ "|
+
+
+
+
+
+
Convenience Functions and Command Line Tools¶
The following are convenience functions and command line tools which are provided as part of this package.
+-
+
- The file
mtlx2gltf.py`` contains a command line tool that uses a utility functionmtlx2gltfto convert from MaterialX to glTF. Various command line options are mapped to conversion options (MTLX2GLTFOptions`).
+
usage: mtlx2gltf.py [-h] [--gltfFileName GLTFFILENAME] [--gltfGeomFileName GLTFGEOMFILENAME] [--primsPerMaterial PRIMSPERMATERIAL]
+ [--packageBinary PACKAGEBINARY] [--translateShaders TRANSLATESHADERS] [--bakeTextures BAKETEXTURES]
+ [--bakeResolution BAKERESOLUTION]
+ mtlxFileName
+
+Utility to convert a MaterialX file to a glTF file
+
+positional arguments:
+ mtlxFileName Path containing MaterialX file to convert.
+
+options:
+ -h, --help show this help message and exit
+ --gltfFileName GLTFFILENAME
+ Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+ --gltfGeomFileName GLTFGEOMFILENAME
+ Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+ --primsPerMaterial PRIMSPERMATERIAL
+ Create a new primitive per material and assign the material. Default is False
+ --packageBinary PACKAGEBINARY
+ Create a biary packaged GLB file. Default is False
+ --translateShaders TRANSLATESHADERS
+ Translate shaders to glTF. Default is False
+ --bakeTextures BAKETEXTURES
+ Bake pattern graphs as textures. Default is False
+ --bakeResolution BAKERESOLUTION
+ Bake image resolution. Default is 256
+-
+
- The file gltf2mtlx.py contains a command line tool that uses a utility function to convert from glTF to MaterialX.
+Various command line options are mapped to conversion options (
GLTF2MTLXOptions).
+
usage: gltf2mtlx.py [-h] [--mtlxFileName MTLXFILENAME] [--createAssignments CREATEASSIGNMENTS] gltfFileName
+
+Utility to convert a glTF file to MaterialX file
+
+positional arguments:
+ gltfFileName Path containing glTF file to convert.
+
+options:
+ -h, --help show this help message and exit
+ --mtlxFileName MTLXFILENAME
+ Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+ --createAssignments CREATEASSIGNMENTS
+ Create material assignments. Default is True
+Image and Geometry Pathing¶
glTF does not allow for any pathing specifieds on resources such as image and geometry uris. As such the proper pathing
+must be set before packaging to glb files. This is handled during the packaing process which uses the pygltflib Python package.
By default mtlx2gltfadds search paths (mx.FileSearchPath) to attempt to find the absoluate location of the uri resources, sets the uri and hen performs binary packing. Thus it is possible for instance to specify embedding geometry which is not in the same folder as the root glTF file.
The examples at the beginning of this document show an example Adobe Substance 3D material which was exported and mapped to a MaterialX material. Then it was converted to glTF with different geometry paths.
+"
]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "Translation and baking are useful to just convert shading models. Below is a snapshot of a few materials which were downloaded from\n",
+ " the [Physical Based Site](https://physicallybased.info/) which is maintained by Anton Palmqvist. The materials were converted from MaterialX with the preview using the ThreeJS editor:\n",
+ "\n",
+ " \n",
+ " Figure: From left to right: \"Aluminum\", \"Sapphire\", \"Whiteboard\", and \"Tire\" examples"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "## Convenience Functions and Command Line Tools\n",
+ "\n",
+ "The following are convenience functions and command line tools which are provided as part of this package.\n",
+ "\n",
+ "- The file `mtlx2gltf.py`` contains a command line tool that uses a utility function `mtlx2gltf` to convert from MaterialX to glTF.\n",
+ "Various command line options are mapped to conversion options (`MTLX2GLTFOptions`).\n",
+ "```bash\n",
+ "usage: mtlx2gltf.py [-h] [--gltfFileName GLTFFILENAME] [--gltfGeomFileName GLTFGEOMFILENAME] [--primsPerMaterial PRIMSPERMATERIAL]\n",
+ " [--packageBinary PACKAGEBINARY] [--translateShaders TRANSLATESHADERS] [--bakeTextures BAKETEXTURES]\n",
+ " [--bakeResolution BAKERESOLUTION]\n",
+ " mtlxFileName\n",
+ "\n",
+ "Utility to convert a MaterialX file to a glTF file\n",
+ "\n",
+ "positional arguments:\n",
+ " mtlxFileName Path containing MaterialX file to convert.\n",
+ "\n",
+ "options:\n",
+ " -h, --help show this help message and exit\n",
+ " --gltfFileName GLTFFILENAME\n",
+ " Name of MaterialX output file. If not specified the glTF name with \"_tomtlx.mtlx\" suffix will be used\n",
+ " --gltfGeomFileName GLTFGEOMFILENAME\n",
+ " Name of MaterialX output file. If not specified the glTF name with \"_tomtlx.mtlx\" suffix will be used\n",
+ " --primsPerMaterial PRIMSPERMATERIAL\n",
+ " Create a new primitive per material and assign the material. Default is False\n",
+ " --packageBinary PACKAGEBINARY\n",
+ " Create a biary packaged GLB file. Default is False\n",
+ " --translateShaders TRANSLATESHADERS\n",
+ " Translate shaders to glTF. Default is False\n",
+ " --bakeTextures BAKETEXTURES\n",
+ " Bake pattern graphs as textures. Default is False\n",
+ " --bakeResolution BAKERESOLUTION\n",
+ " Bake image resolution. Default is 256\n",
+ "``` \n",
+ "- The file gltf2mtlx.py contains a command line tool that uses a utility function to convert from glTF to MaterialX.\n",
+ "Various command line options are mapped to conversion options (`GLTF2MTLXOptions`).\n",
+ "```bash\n",
+ "usage: gltf2mtlx.py [-h] [--mtlxFileName MTLXFILENAME] [--createAssignments CREATEASSIGNMENTS] gltfFileName\n",
+ "\n",
+ "Utility to convert a glTF file to MaterialX file\n",
+ "\n",
+ "positional arguments:\n",
+ " gltfFileName Path containing glTF file to convert.\n",
+ "\n",
+ "options:\n",
+ " -h, --help show this help message and exit\n",
+ " --mtlxFileName MTLXFILENAME\n",
+ " Name of MaterialX output file. If not specified the glTF name with \"_tomtlx.mtlx\" suffix will be used\n",
+ " --createAssignments CREATEASSIGNMENTS\n",
+ " Create material assignments. Default is True\n",
+ "```\n",
+ "### Image and Geometry Pathing\n",
+ "\n",
+ "glTF does not allow for any pathing specifieds on resources such as image and geometry uris. As such the proper pathing\n",
+ "must be set before packaging to glb files. This is handled during the packaing process which uses the `pygltflib` Python package.\n",
+ "\n",
+ "By default `mtlx2gltf`adds search paths (mx.FileSearchPath) to attempt to find the absoluate location of the uri resources, sets the uri and hen performs binary packing. Thus it is possible for instance to specify embedding geometry which is not in the same folder as the root glTF file.\n",
+ "\n",
+ "The examples at the beginning of this document show an example Adobe Substance 3D material which was exported and mapped to a MaterialX material. Then it was converted to glTF with different geometry paths.\n"
+ ]
}
],
"metadata": {
diff --git a/docs/examples.py b/docs/examples.py
index 51263f8..3e5dca5 100644
--- a/docs/examples.py
+++ b/docs/examples.py
@@ -1,17 +1,21 @@
# %% [markdown]
-# ### Using The Core Library
-#
-# This notebook provides a set of sample code which demonstrates the
-# workflow to convert between glTF and MaterialX.
+#
#
-# The sample input file is the "BoomBox with Axes" file from the glTF sample repository found [here](https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0/BoomBoxWithAxes/glTF) is used to demonstrate glTF to MaterialX conversion.
+# ### Using The Core Library
#
-# The resulting MaterialX file after conversion is used to demonstrate conversion to glTF.
+# This notebook provides a set of sample code which demonstrates the workflow to convert between glTF and MaterialX.
#
-#
+# The sample input file is the "BoomBox with Axes" file from the glTF sample repository found [here](https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0/BoomBoxWithAxes/glTF) is used to demonstrate glTF to MaterialX conversion. The resulting MaterialX file after conversion is used to demonstrate conversion to glTF.
#
-#
+# %% [markdown]
+# Translation and baking are useful to just convert shading models. Below is a snapshot of a few materials which were downloaded from
+# the [Physical Based Site](https://physicallybased.info/) which is maintained by Anton Palmqvist. The materials were converted from MaterialX with the preview using the ThreeJS editor:
+#
+#
+# Figure: From left to right: "Aluminum", "Sapphire", "Whiteboard", and "Tire" examples
+
+# %% [markdown]
+# ## Convenience Functions and Command Line Tools
+#
+# The following are convenience functions and command line tools which are provided as part of this package.
+#
+# - The file `mtlx2gltf.py`` contains a command line tool that uses a utility function `mtlx2gltf` to convert from MaterialX to glTF.
+# Various command line options are mapped to conversion options (`MTLX2GLTFOptions`).
+# ```bash
+# usage: mtlx2gltf.py [-h] [--gltfFileName GLTFFILENAME] [--gltfGeomFileName GLTFGEOMFILENAME] [--primsPerMaterial PRIMSPERMATERIAL]
+# [--packageBinary PACKAGEBINARY] [--translateShaders TRANSLATESHADERS] [--bakeTextures BAKETEXTURES]
+# [--bakeResolution BAKERESOLUTION]
+# mtlxFileName
+#
+# Utility to convert a MaterialX file to a glTF file
+#
+# positional arguments:
+# mtlxFileName Path containing MaterialX file to convert.
+#
+# options:
+# -h, --help show this help message and exit
+# --gltfFileName GLTFFILENAME
+# Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+# --gltfGeomFileName GLTFGEOMFILENAME
+# Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+# --primsPerMaterial PRIMSPERMATERIAL
+# Create a new primitive per material and assign the material. Default is False
+# --packageBinary PACKAGEBINARY
+# Create a biary packaged GLB file. Default is False
+# --translateShaders TRANSLATESHADERS
+# Translate shaders to glTF. Default is False
+# --bakeTextures BAKETEXTURES
+# Bake pattern graphs as textures. Default is False
+# --bakeResolution BAKERESOLUTION
+# Bake image resolution. Default is 256
+# ```
+# - The file gltf2mtlx.py contains a command line tool that uses a utility function to convert from glTF to MaterialX.
+# Various command line options are mapped to conversion options (`GLTF2MTLXOptions`).
+# ```bash
+# usage: gltf2mtlx.py [-h] [--mtlxFileName MTLXFILENAME] [--createAssignments CREATEASSIGNMENTS] gltfFileName
+#
+# Utility to convert a glTF file to MaterialX file
+#
+# positional arguments:
+# gltfFileName Path containing glTF file to convert.
+#
+# options:
+# -h, --help show this help message and exit
+# --mtlxFileName MTLXFILENAME
+# Name of MaterialX output file. If not specified the glTF name with "_tomtlx.mtlx" suffix will be used
+# --createAssignments CREATEASSIGNMENTS
+# Create material assignments. Default is True
+# ```
+# ### Image and Geometry Pathing
+#
+# glTF does not allow for any pathing specifieds on resources such as image and geometry uris. As such the proper pathing
+# must be set before packaging to glb files. This is handled during the packaing process which uses the `pygltflib` Python package.
+#
+# By default `mtlx2gltf`adds search paths (mx.FileSearchPath) to attempt to find the absoluate location of the uri resources, sets the uri and hen performs binary packing. Thus it is possible for instance to specify embedding geometry which is not in the same folder as the root glTF file.
+#
+# The examples at the beginning of this document show an example Adobe Substance 3D material which was exported and mapped to a MaterialX material. Then it was converted to glTF with different geometry paths.
+#
+
diff --git a/docs/gallery.html b/docs/gallery.html
index 759e2e4..b8582e3 100644
--- a/docs/gallery.html
+++ b/docs/gallery.html
@@ -354,7 +354,7 @@
-
+
-
-<script type="module" src="https://unpkg.com/@google/model-viewer/dist/model-viewer.js"></script>
+<model-viewer style='background-color:rgba(0, 0, 0, 1.0); width: 48em; height: 48em' id='viewer1' ar interaction-prompt='none' camera-controls touch-action='pan-y' src='./docs/data/BoomBoxWithAxes_primMaterials.glb' shadow-intensity='0.3' alt='BoomBox With Axes Per Prim Material' poster='./docs/data/BoomBoxWithAxes_primMaterials.png'></model-viewer>
The following shows is a set of progressive examples to convert from a glTF file to MaterialX and then to a new glTF file for "shader ball" preview of extracted materials.
Note that the sample data is included as part of the package for convenience.
-The sample input file is the "BoomBox with Axes" file from the glTF sample repository found here.
+The sample input file is the "BoomBox with Axes" file from the glTF sample repository found here.
This is converted from glTF to a MaterialX document which can be previewed / modified using an integration which supports MaterialX. Here the file is loaded into the "MaterialX Graph Editor" which comes with MaterialX releases.
+This is converted from glTF to a MaterialX document which can be previewed / modified using an integration which supports MaterialX. Here the file is loaded into the "MaterialX Graph Editor" which comes with MaterialX releases.
The converted materials are then used to create a new glTF file using sample "shaderball" data with each material found assigned to different instances of the "shaderball"
Interactive Example
-A Jupyter notebook which performs the same steps is available here. This or any other notebook can be used if the user wishes to test the package in an interactive environment.
A Jupyter notebook which performs the same steps is available here.
This or any other notebook can be used if the user wishes to test the package in an interactive environment.
Import the package
Translate Shader and Bake Textures
All materials are assumed to use glTF PBR surface shaders. Conversion to this shading model can be performed via MaterialX utilities, which includes texture baking.
-Please refer to the sample Jupyter notebook for an example of shader translation and baking using some convenience functions included with the package. Note that they do not need to be used as the core MaterialX distribution provides access to the APIs used in this package.
+Please refer to the sample Jupyter notebook for an example of shader translation and baking using some convenience functions included with the package. Note that they do not need to be used as the core MaterialX distribution provides access to the APIs used in this package.
Author
-
diff --git a/docs/html/namespacematerialxgltf_1_1gltf2_mtlx.html b/docs/html/namespacematerialxgltf_1_1gltf2_mtlx.html
index 4a5a2c7..853f5be 100644
--- a/docs/html/namespacematerialxgltf_1_1gltf2_mtlx.html
+++ b/docs/html/namespacematerialxgltf_1_1gltf2_mtlx.html
@@ -27,7 +27,7 @@
MaterialXglTF
- 0.0.1
+ 0.0.3
MaterialXglTF
- 0.0.1
+ 0.0.3
MaterialXglTF
- 0.0.1
+ 0.0.3
MaterialXglTF
- 0.0.1
+ 0.0.3
MaterialXglTF
- 0.0.1
+ 0.0.3
MaterialXglTF
- 0.0.1
+ 0.0.3