Texture
The texture node is used to sample an external texture image file to drive downstream parameters.
Parameters
| Parameter | Description |
|---|---|
| File | The input filename which can reference environment variables using the ${ENV} format as well as UDIM substitution for different coordinate spaces. Standard string modifiers can be used to set a frame time, ie. myTexture.%04d.exr on frame 10 would be resolved as myTexture.0010.exr. |
| Frame | The desired frame number to use if referenced in the filename. |
| Channels | What color channel to reference, regardless of multiple or single channels the result will always be a vector. |
| U/V Coordinate | What attribute/value should be used for the texture coordinate. |
UDIM Texture Atlases
Texture atlases can be referenced using filenames that are expanded during lookup via UDIM patterns. The substitutions will occur if the texture filename passed does not exist as a concrete file and contains one or more of the following substrings:
| Pattern | Numbering scheme | Example expansion if u=0.5, v=2.5 |
|---|---|---|
<UDIM> | 1001 + utile + vtile * 10 | 1021 |
<u> | utile | u0 |
<v> | vtile | v2 |
<U> | utile + 1 | u1 |
<V> | vtile + 1 | v3 |
<UVTILE> | equivalent to <U>_<V> | u1_v3 |
_u##v## | utile,vtile | _u00v02 |
%(UDIM)d | synonym for <UDIM> | 1021 |
Example:
A texture request at coordinates (1.4, 3.8) using the filename paint.<UDIM>.tif will attempt to retrieve the texture sample from a file named paint.1032.tif at coordinates (0.4, 0.8).