UsdPreviewSurface
Overview
The UsdPreviewSurface material is part of the USD Preview Surface spec.
From openusd.org:
The UsdPreviewSurface is meant to model a “modern” physically based surface that strikes a balance between expressiveness and reliable interchange between current day DCC’s and game engines and other real-time rendering clients.
Attribute Reference
General attributes
clearcoat
Float bindable
default: 0.0
Second specular lobe amount. The color is white.
clearcoatRoughness
Float bindable
default: 0.01
Roughness for the second specular lobe.
diffuseColor
Rgb bindable
default: [ 0.18, 0.18, 0.18 ]
When using metallic workflow this is interpreted as albedo.
displacement
Float bindable
default: 0.0
Displacement in the direction of the normal.
emissiveColor
Rgb bindable
default: [ 0, 0, 0 ]
Emissive component.
extra_aovs
Map
default: None
Bind this attribute to a 'ListMap' that contains references to ExtraAovMaps that specify additional outputs that can be assigned to a RenderOutput "light aov" result
invisible_refractive_cryptomatte
Bool
default: False
Indicates whether material should/should not appear in the refractive cryptomatte layers
ior
Float bindable
default: 1.5
Index of Refraction to be used for translucent objects and objects with specular components, including the clearcoat if clearcoat > 0.
label
String
default:
label used in material and light aovs
metallic
Float bindable
default: 0.0
Use 1 for metallic surfaces and 0 for non-metallic. If metallic is 1, then both F0 (reflectivity at 0 degree incidence) and edge F90 reflectivity will simply be the Albedo. If metallic is 0, then Albedo is ignored in the calculation of F0 and F90; F0 is derived from ior via ( (1-ior)/(1+ior) )^2 and F90 is white. In between, we interpolate.
normal
Vec3f bindable
default: [ 0, 0, 1 ]
Expects normal in tangent space [(-1,-1,-1), (1,1,1)]
occlusion
Float bindable
default: 1.0
Ignored by Moonray
opacity
Float bindable
default: 1.0
When opacity is 1.0 then the geometry is fully opaque, if it is smaller than 1.0 then the geometry is translucent, when it is 0 the geometry is transparent. Note that even a fully transparent object still receives lighting as, for example, perfectly clear glass still has a specular response.
opacityThreshold
Float bindable
default: 0.0
The opacityThreshold input is useful for creating geometric cut-outs based on the opacity input. A value of 0.0 indicates that no masking is applied to the opacity input, while a value greater than 0.0 indicates that rendering of the surface is limited to the areas where the opacity is greater or equal to that value.
priority
Int
default: 0
The material's place in an order of precedence for overlapping dielectrics. A value of 0 means the priority should be ignored. Materials with lower numbers (higher priority) "override" materials with higher numbers (lower priority). To enable automatic removal of self-overlapping geometry, a non-zero priority must be set on the geometry's material.
roughness
Float bindable
default: 0.5
Roughness for the specular lobe. The value ranges from 0 to 1, which goes from a perfectly specular surface at 0.0 to maximum roughness of the specular lobe.
specularColor
Rgb bindable
default: [ 0, 0, 0 ]
Specular color to be used. This is the color at 0 incidence. Edge color is assumed white. Transition between the two colors according to Schlick fresnel approximation.
useSpecularWorkflow
Int enum
0 = “Metalness workflow” (default)
1 = “Specular workflow”
This node can fundamentally operate in two modes : Specular workflow where you provide a texture/value to the 'specularColor' input. Or, Metallic workflow where you provide a texture/value to the 'metallic' input.