- Add "-ra" render args argument to allow for non-default render delegate to be passed in. (#21)

- Rerun examples to apply some recent render fixes.

Author: kwokcb

README.md

@@ -21,10 +21,10 @@ Some initial utilities are provided with more coming on-line as the site / requi
   attempt to produce valid USD shading network (See Support Utilities)
   - Input geometry (USD file)
   - Input camera (USD file)
-  - Skydome like (A latlong HDR file)
+  - Skydome light (A latlong HDR file)
   - Perform USD validation
   - Export just the materials to a USD file.
-  - Render the corresponding USD file. This uses `usdrecord` currently.
+  - Render the corresponding USD file. This uses `usdrecord` currently. Render arguments can be passed in to specify the render delegate to use for instance. The default is GL. 
   - Misc options for output for test
     suite compatibility:
     - Use material name for file name

documents/MaterialX_USD_Presentation_March_6_2025.pdf

@@ -126,10 +126,10 @@ <h2><a class="anchor" id="autotoc_md1"></a>
 <li>Preprocess the MaterialX file to attempt to produce valid USD shading network (See Support Utilities)</li>
 <li>Input geometry (USD file)</li>
 <li>Input camera (USD file)</li>
-<li>Skydome like (A latlong HDR file)</li>
+<li>Skydome light (A latlong HDR file)</li>
 <li>Perform USD validation</li>
 <li>Export just the materials to a USD file.</li>
-<li>Render the corresponding USD file. This uses <code>usdrecord</code> currently.</li>
+<li>Render the corresponding USD file. This uses <code>usdrecord</code> currently. Render arguments can be passed in to specify the render delegate to use for instance. The default is GL.</li>
 <li>Misc options for output for test suite compatibility:<ul>
 <li>Use material name for file name</li>
 <li>Create in subfolder with name being the input MaterialX name</li>

documents/html/index.html

@@ -125,10 +125,10 @@ <h3>Available Components</h3>
 attempt to produce valid USD shading network (See Support Utilities)</li>
 <li>Input geometry (USD file)</li>
 <li>Input camera (USD file)</li>
-<li>Skydome like (A latlong HDR file)</li>
+<li>Skydome light (A latlong HDR file)</li>
 <li>Perform USD validation</li>
 <li>Export just the materials to a USD file.</li>
-<li>Render the corresponding USD file. This uses <code>usdrecord</code> currently.</li>
+<li>Render the corresponding USD file. This uses <code>usdrecord</code> currently. Render arguments can be passed in to specify the render delegate to use for instance. The default is GL. </li>
 <li>Misc options for output for test
   suite compatibility:<ul>
 <li>Use material name for file name</li>

documents/html/mtlx2usd_8py_source.html

@@ -77,6 +77,7 @@ def main():
     parser.add_argument("-sf", "--subfolder", action="store_true", help="Save output to subfolder named <input materialx file> w/o extension.")
     parser.add_argument("-pp", "--preprocess", action="store_true", help="Attempt to pre-process the MaterialX file.")
     parser.add_argument("-ip", "--imagepaths", default="", help="Comma separated list of search paths for image path resolving. ")
+    parser.add_argument("-ra", "--renderargs", default="", help="Additional render arguments.")
 
     # Parse arguments
     args = parser.parse_args()
@@ -263,6 +264,9 @@ def main():
                     if camera_prim:
                         render_command += f' --camera "{camera_prim.GetName()}"'
                     logger.info(f"> Rendering using command: {render_command}")
+                    if args.renderargs:
+                        render_command += f' {args.renderargs}'
+                        print('>'*20, render_command)
                     sys.stdout.flush() 
                     os.system(f"{render_command} > nul 2>&1" if os.name == "nt" else f"{render_command} > /dev/null 2>&1")
                     #os.system(render_command)