Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# UsdMaterial

To create and edit native USD materials and shaders, you can use the UsdMaterial node. This enables you to create shaders that contain images. However, currently it is not possible to create a native USD material network and connect materials together so this node may only be useful for simple workflows or for debugging purposes.

See more about material workflows in Materials in USD Scenes.

# Inputs

Connection Type | Connection Name | Function
input | in | The incoming scene graph data that the node will operate on or modify.

# Controls

Control (UI) | Default Value | Function
--- | --- | ---
action | create | Choose whether to create a new Material prim or edit an existing one (use edit shader for shaders, or edit interface for Materials).
materialPrimPath | materials/material | In create mode, the path of where to create the Material prim. In edit interface mode, the path to an existing Material prim. In edit shader mode, the path to an existing Shader prim.
primSpec | define | Determines what specifier of Prim to create, from define, class or over.
materialOutput | surface | The name of the material output that will be connected to the shader output.
shaderNode | N/A | Determines the source type and shader node identifier. This list will dynamically call any shaders within the shader registry.
primSpecHierarchy | enabled | Determines whether to create all ancestor prims with the prim spec provided in the primSpec parameter. If unchecked (default), all but the leaf Prim will use the `over` prim spec to avoid overriding spec in lower order layers.
blockUpstreamAttributes | enabled | Determines whether to block incoming Attributes in a potential incoming Prim in the stage.
(The parameters in the inputs section below will dynamically populate based on the shaderNode chosen.)