UsdUVTexture
Overview
The UsdUVTexture map is part of the USD Preview Surface spec. It allows the mapping of an image texture onto geometry. Single texture files and UDIM tiles are both supported. If <UDIM> appears in the texture filename then it will be replaced with the appropriate UDIM tile based on the st coordinates. The st coordinates are typically provided by binding a UsdPrimvarReader_float2 map to the st parameter. Both exr and tx files are supported but tx files are preferred for performance reasons.
Attribute Reference
General attributes
bias
Rgb
default: [ 0, 0, 0 ]
Bias to be applied to all components of the texture. output = textureValue * scale + bias
fallback
Rgb
default: [ 0, 0, 0 ]
Fallback value used when texture can not be read.
file
String filename
default:
Filename of an EXR or TX format texture (must be mip-mapped and tiled with maketx). If filename contains '<UDIM>', udim index substitution is performed on filename.
output_mode
Int enum
0 = “rgb” (default)
1 = “r”
2 = “g”
3 = “b”
4 = “a”
Controls which channel(s) to output
scale
Rgb
default: [ 1, 1, 1 ]
Scale to be applied to all components of the texture. output = textureValue * scale + bias
sourceColorSpace
Int enum
0 = “raw”
1 = “sRGB”
3 = “auto” (default)
Flag indicating the color space in which the source texture is encoded. If set to auto, gamma correction will be applied if the images is not single channel.
st
Vec2f bindable
default: [ 1, 1 ]
Texture coordinate to use to fetch this texture.
udim_files
StringVector
default: {}
Explicit list of UDIM filenames corresponding to values in the "udim_values" list
udim_max_v
Int
default: 10
Maximum UDIM v value used (maximum UDIM row). Needed to for texture allocation.
udim_values
IntVector
default: {}
Explicit list of UDIM values corresponding to filename in the "udim_files" list
wrapS
Int enum
0 = “black”
1 = “clamp”
2 = “repeat”
3 = “mirror”
4 = “useMetadata” (default)
Wrap mode when reading this texture.
wrapT
Int enum
0 = “black”
1 = “clamp”
2 = “repeat”
3 = “mirror”
4 = “useMetadata” (default)
Wrap mode when reading this texture.