Help! MaterialBindingAPI Issues with hd_render

[BlindObiJuanPC]

Hello! I think I have MoonRay™ mostly built and working on Rocky Linux 9.5 but I can't seem to render the example sphere using hd_render. I get several warnings that appear to be blocking me and I get a blank image as output when the process is finished.

Here are the warnings I've been getting:

Warning (secondary thread): in BindingsAtPrim at line 707 of /opt/MoonRay/build-deps/USD-prefix/src/USD/pxr/usd/usdShade/materialBindingAPI.cpp -- Found material bindings on prim at path (/sphere) but MaterialBindingAPI is not applied on the prim
Warning: in BindingsAtPrim at line 707 of /opt/MoonRay/build-deps/USD-prefix/src/USD/pxr/usd/usdShade/materialBindingAPI.cpp -- Found material bindings on prim at path (/sphere) but MaterialBindingAPI is not applied on the prim
Warning: in UsdImagingBuildHdMaterialNetworkFromTerminal at line 483 of /opt/MoonRay/build-deps/USD-prefix/src/USD/pxr/usdImaging/usdImaging/materialParamUtils.cpp -- Invalid info:id BaseMaterial node: /checkerboard/baseMtl

After some digging I was able to render an output image using this environment variable: USD_SHADE_MATERIAL_BINDING_API_CHECK=strict

However I'm guessing the materials are still not working properly going purely off of the assumption that /checkerboard/baseMtl would create a checkerboard pattern and not a flat gray surface??? (I wasn't able to find an image of what a successful render of sphere.usd is supposed to look like if one exists somewhere😅)

I feel like I must have missed something somewhere, but I can't seem to figure out what it is😅. Any help would be much appreciated!!!

[jlanz]

Hi, it looks like there are a couple of issues here:

1. Our sphere.usd scene file is a bit out of date and missing the MaterialBindingAPI schema on the sphere geometry.

   Try modifying the sphere definition to add it as follows:

   def Sphere "sphere" (
       prepend apiSchemas = ["MaterialBindingAPI"]
   )
   {
       rel material:binding = </checkerboard>
   }
   

2. The install location of the moonrayShaderDiscovery and moonrayShaderParser plugins is currently plugin/usd when it should probably be plugin/pxr

   Can you tell us what your PXR_PLUGINPATH_NAME is?

   After looking into this, I've made a few changes that will go out in the next release.
   For now you can try applying the following changes at the top-level openmoonray dir:

   diff --git a/building/general_build.md b/building/general_build.md
   index e7ae59f..03804fb 100644
   --- a/building/general_build.md
   +++ b/building/general_build.md
   @@ -166,7 +166,7 @@ The other environment variables set up by *setup.sh* are:
    | **REZ_MOONRAY_ROOT  = *release*** | *tells moonray where to find shaders file for XPU mode (it will look for ${REZ_MOONRAY_ROOT}/shaders/GPUShaders.ptx* |
    | **ARRAS_SESSION_PATH = *release*/sessions** | *tells Arras where to find session files* |
    | **MOONRAY_CLASS_PATH = *release*/shader_json** | *tells Hydra Ndr plugins where to find shader descriptions (see above)* |
   -| **PXR_PLUGINPATH_NAME += *release*/plugin/usd** | *adds MoonRay Hydra plugins to Hydra plugin path* |
   +| **PXR_PLUGINPATH_NAME += *release*/plugin/pxr** | *adds MoonRay Hydra plugins to Hydra plugin path* |
   
    *setup.py* doesn't set up PYTHONPATH to include the Python modules that come with USD. It doesn't need to be set for MoonRay's purposes, but the *hd_render* command will log a series of warnings that they are not found. This isn't harmful, because *hd_render* doesn't invoke Python code.
   
   diff --git a/moonray/hydra/README.md b/moonray/hydra/README.md
   index 9fb1c46..25c7e2c 100644
   --- a/moonray/hydra/README.md
   +++ b/moonray/hydra/README.md
   @@ -21,8 +21,8 @@ export RDL2_DSO_PATH=${rel_root}/rdl2dso.proxy:${rel_rool}/rdl2dso
    export ARRAS_SESSION_PATH=${rel_root}/sessions/hdMoonray
    # adds the Arras runtime execComp to the path
    export PATH=${rel_root}/bin:${PATH}
   -# adds the pxr plugins to the plugin path
   -export PXR_PLUGINPATH_NAME=${rel_root}/plugin/usd:${PXR_PLUGINPATH_NAME}
   +# adds the pxr plugins to the plugin path
   +export PXR_PLUGINPATH_NAME=${rel_root}/plugin/pxr:${PXR_PLUGINPATH_NAME}
    ```
   
    When using the DWA USD build, you need to set PXR_PLUGIN_PATH in place of PXR_PLUGINPATH_NAME.
   Submodule moonray/hydra/moonray_sdr_plugins d359fcf..205229c:
     > Install to plugins/pxr (#19)
   diff --git a/package.py b/package.py
   index ee2b94e..23ec0a0 100644
   --- a/package.py
   +++ b/package.py
   @@ -110,7 +110,8 @@ def commands():
        prependenv('MOONRAY_CLASS_PATH', '{root}/coredata')
        prependenv('MOONRAY_DSO_PATH', '{root}/rdl2dso')
        prependenv('PATH', '{root}/bin')
   -    prependenv('PXR_PLUGIN_PATH', '{root}/plugin/pxr')
   +    prependenv('PXR_PLUGIN_PATH', '{root}/plugin/pxr') # for legacy DWA USD builds
   +    prependenv('PXR_PLUGINPATH_NAME', '{root}/plugin/pxr')
        prependenv('PYTHONPATH', '{root}/python/lib/$PYTHON_NAME')
        prependenv('RDL2_DSO_PATH', '{root}/rdl2dso')
   
   diff --git a/scripts/Rocky9/setupHoudini.sh b/scripts/Rocky9/setupHoudini.sh
   index 3124c3f..c5b0944 100644
   --- a/scripts/Rocky9/setupHoudini.sh
   +++ b/scripts/Rocky9/setupHoudini.sh
   @@ -9,5 +9,5 @@ export REL=${omr_install_dir}
    export RDL2_DSO_PATH=${omr_install_dir}/rdl2dso.proxy:${omr_install_dir}/rdl2dso
    export MOONRAY_CLASS_PATH=${omr_install_dir}/shader_json
    export ARRAS_SESSION_PATH=${omr_install_dir}/sessions
   -PXR_PLUGINPATH_NAME=${omr_install_dir}/plugin/pxr:${omr_install_dir}/plugin/usd/moonrayShaderDiscovery:${omr_install_dir}/plugin/usd/moonrayShaderParser
   +PXR_PLUGINPATH_NAME=${omr_install_dir}/plugin/pxr
    export HOUDINI_PATH=/opt/hfs20.0/houdini:${omr_install_dir}/houdini/:${omr_install_dir}/plugin/houdini
   diff --git a/scripts/macOS/setupHoudini.sh b/scripts/macOS/setupHoudini.sh
   index 2254b74..68ac25f 100644
   --- a/scripts/macOS/setupHoudini.sh
   +++ b/scripts/macOS/setupHoudini.sh
   @@ -9,6 +9,6 @@ export REL=${omr_install_dir}
    export RDL2_DSO_PATH=${omr_install_dir}/rdl2dso.proxy:${omr_install_dir}/rdl2dso
    export MOONRAY_CLASS_PATH=${omr_install_dir}/shader_json
    export ARRAS_SESSION_PATH=${omr_install_dir}/sessions
   -PXR_PLUGINPATH_NAME=${omr_install_dir}/plugin/pxr:${omr_install_dir}/plugin/usd/moonrayShaderDiscovery:${omr_install_dir}/plugin/usd/moonrayShaderParser
   +PXR_PLUGINPATH_NAME=${omr_install_dir}/plugin/pxr
    #export HOUDINI_DSO_ERROR=5
    export HOUDINI_PATH=/Applications/Houdini/Houdini20.0.751/Frameworks/Houdini.framework/Versions/Current/Resources/houdini:${omr_install_dir}/houdini/:${omr_install_dir}/plugin/houdini
   diff --git a/scripts/setup.sh b/scripts/setup.sh
   index bf7deb6..999594d 100644
   --- a/scripts/setup.sh
   +++ b/scripts/setup.sh
   @@ -37,8 +37,8 @@ export ARRAS_SESSION_PATH=${omr_root}/sessions
    export MOONRAY_CLASS_PATH=${omr_root}/shader_json
   
    # add Hydra plugins to path
   -export PXR_PLUGINPATH_NAME=${omr_root}/plugin/usd:${omr_root}/plugin/pxr:${PXR_PLUGINPATH_NAME}
   -export PXR_PLUGIN_PATH=${omr_root}/plugin/usd:${omr_root}/plugin/pxr:${PXR_PLUGIN_PATH}
   +export PXR_PLUGINPATH_NAME=${omr_root}/plugin/pxr:${PXR_PLUGINPATH_NAME}
   +export PXR_PLUGIN_PATH=${omr_root}/plugin/pxr:${PXR_PLUGIN_PATH} # for legacy DWA USD builds
   
    # create shader descriptions if they don't exist
    if [ ! -d "${omr_root}/shader_json" ]
   diff --git a/testdata/sphere.usd b/testdata/sphere.usd
   index a2f11e8..56b4985 100644
   --- a/testdata/sphere.usd
   +++ b/testdata/sphere.usd
   @@ -16,7 +16,9 @@ def DistantLight "d_light"
        bool normalize = true
    }
   
   -def Sphere "sphere"
   +def Sphere "sphere" (
   +    prepend apiSchemas = ["MaterialBindingAPI"]
   +)
    {
        rel material:binding = </checkerboard>
    }
   @@ -40,4 +42,4 @@ def Material "checkerboard"
                    int inputs:num_v_tiles = 24
                    color3f outputs:out
            }
   -}
   \ No newline at end of file
   +}

   ... and these additional changes at the moonray/hydra/moonray_sdr_plugins repo:

   diff --git a/moonrayShaderDiscovery/CMakeLists.txt b/moonrayShaderDiscovery/CMakeLists.txt
   index ab376eb..b262d79 100644
   --- a/moonrayShaderDiscovery/CMakeLists.txt
   +++ b/moonrayShaderDiscovery/CMakeLists.txt
   @@ -69,6 +69,6 @@ install(TARGETS ${component}
    )
   
    install(FILES ${plugInfoFile}
   -        DESTINATION plugin/usd/moonrayShaderDiscovery
   +        DESTINATION plugin/pxr/moonrayShaderDiscovery
    )
   
   diff --git a/moonrayShaderParser/CMakeLists.txt b/moonrayShaderParser/CMakeLists.txt
   index 55022c1..a5a2365 100644
   --- a/moonrayShaderParser/CMakeLists.txt
   +++ b/moonrayShaderParser/CMakeLists.txt
   @@ -69,7 +69,7 @@ install(TARGETS ${component}
   
    )
    install(FILES ${plugInfoFile}
   -        DESTINATION plugin/usd/moonrayShaderParser
   +        DESTINATION plugin/pxr/moonrayShaderParser
    )

[BlindObiJuanPC]

It's working for me now thanks! I really appreciate the help!

[jlanz]

The sphere render should look like this: