definePreviewMaterial

Fully qualified name: usdex::core::definePreviewMaterial

pxr::UsdShadeMaterial usdex::core::definePreviewMaterial(

pxr::UsdPrim prim,

const pxr::GfVec3f &color,

const float opacity = 1.0f,

const float roughness = 0.5f,

const float metallic = 0.0f,

)

Defines a PBR UsdShadeMaterial driven by a UsdPreviewSurface shader network for 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 diffuse 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.