createMdlShaderInput#
Fully qualified name: usdex::rtx::createMdlShaderInput
- pxr::UsdShadeInput usdex::rtx::createMdlShaderInput(
- pxr::UsdShadeMaterial &material,
- const pxr::TfToken &name,
- const pxr::VtValue &value,
- const pxr::SdfValueTypeName &typeName,
- std::optional<const usdex::core::ColorSpace> colorSpace = std::nullopt,
Create an MDL shader input.
If the shader input already exists and is a different type, defined in the current edit target layer -> it will be removed and recreated.
If the shader input already exists and has a connected source -> the source will be disconnected before being set.
Note
When creating texture asset inputs (diffuse, normal, roughness, etc.) it is important to set the colorSpace parameter so that the textures are sampled correctly. Typically, diffuse is “auto”, which resolves to “sRGB”. Normal, roughness, and other textures should be “raw”.
- Parameters:
material – The UsdShadeMaterial prim that contains the MDL shader
name – Name of the input to be created
value – The value assigned to the input
typeName – The value type of the input
colorSpace – If set, the newly created input’s colorSpace attribute
- Returns:
The newly created UsdShadeInput input. Returns an Invalid UsdShadeInput on error.