Overview
The new material can be applied to all objects in the scene, or limited to specific objects chosen with the Prim Selection controls.
Where to find this node
- Effects Library:
Tools > USD > uReplace Material - Quick add: right-click in the Node Editor →
Add Tool > USD > uReplace Material
Inputs
- Scene Input (yellow) - a USD scene coming from a uLoader.
- Material Input (green) - the material, coming for example from a uMaterialX or a uShader, or picked from another USD scene with a uLoader.
- Image Input - an image from any Fusion node (video inputs, generated graphics), applied as a diffuse texture. When connected, it hides the File Name control and overrides the loaded image. Unlike File Name, which loads a single frame, it enables animated textures.
Setup
uLoader → uReplaceMaterial → uTransform
In the manual's example, the uReplaceMaterial receives a USD scene, replaces a material in it, then passes the scene to a uTransform.
Controls tab
- Prim Selection
- Pick opens the Scene Tree window to choose specific materials or objects in the USD scene.
- Invert Prim Selection
- inverts the selection to exclude the materials or objects in the Selected Prims list.
- Type
- type of the new material. Color (standard color material), Texture (file requester for a texture file) or MaterialX (file requester for a MaterialX file, or choice of a material from the file connected to the green Material input; this option closes all other controls).
- Diffuse
- color of the material (Color, Red, Green, Blue), or loading a texture.
- Emissive
- adds a global lighting effect, a layer of color over the existing texture, to simulate light emission (Color, Red, Green, Blue).
- Workflow Mode
- Metallic (shows the Metallic slider, which gives objects a reflective, metal-like look) or Specular (shows the Specular Color controls: the color of light reflected from a shiny surface).
- Roughness
- amount of light reflection and scattering on the surface, for a smoother or more textured look.
- Clearcoat
- adds a glossy layer on top of the surface, like a protective coating (car paint, polished metal).
- Clearcoat Roughness
- imperfection or smoothness of that glossy layer.
- Opacity
- reduces the material and object opacity, affecting the color and alpha values.
- Opacity Threshold
- adjusts where the opacity starts to appear.
- Matte
- the Is Matte checkbox occludes background objects or creates clean alpha cutouts.
The Settings tab is common to USD nodes.
Use cases
- Replace the material of only some objects in a USD scene, with Prim Selection.
- Apply a video or an animated Fusion graphic as a texture on a USD object, with the Image Input.
