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.

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.