definePbrMaterial#

Fully qualified name: usdex::core::definePbrMaterial

pxr::UsdShadeMaterial usdex::core::definePbrMaterial(
pxr::UsdPrim prim,
const pxr::GfVec3f &color,
const float opacity = 1.0f,
const float roughness = 0.3f,
const float metallic = 0.0f,
)#

Defines an OpenPBR UsdShadeMaterial interface that drives both an OpenPBR MaterialX render context and the universal render context.

This is an overloaded member function, provided for convenience. It differs from the above function only in what arguments it accepts.

Parameters:
  • prim – Prim to define the material on. The prim’s type will be set to UsdShadeMaterial.

  • color – The base color of the Material

  • opacity – The Opacity Amount to set, 0.0-1.0 range where 1.0 = opaque and 0.0 = invisible

  • roughness – The Roughness Amount to set, 0.0-1.0 range where 1.0 = flat and 0.0 = glossy

  • metallic – The Metallic Amount to set, 0.0-1.0 range where 1.0 = max metallic and 0.0 = no metallic

Returns:

The newly defined UsdShadeMaterial. Returns an Invalid object on error.