Skip to main content

Nodes > Functions > Sample > Texture 2D Sample

Texture 2D Sample

Returns the pixel value of a Texture object at the given coordinates.

Inputs

NameTypeDescription
Texturetex2DTexture object to sample
UV CoordsfloatCoordinates to sample the texture at. Range is 0-1, but values outside this range may work depending on the texture wrap mode
LODfloatWhich LOD level to sample from. Only works if Mipmaps are enabled in the texture parameters in the material inspector
Mip BiasfloatOffsets the auto-selected mip level. Positive samples coarser (blurrier) mips, negative sharper. Active only in Bias LOD mode.
dPdxfloatUV derivative across screen X for explicit-gradient (textureGrad) mip selection. Defaults to dFdx of the UVs when unconnected.
dPdyfloatUV derivative across screen Y for explicit-gradient (textureGrad) mip selection. Defaults to dFdy of the UVs when unconnected.

Outputs

NameTypeDescription
ColorfloatSampled color value

Properties

NameTypeDescription
TypedropdownIf Normal Map is selected, the values will be remapped from [0 -> 1] to [-1 -> 1], which is more suitable for normal map textures
Depth SpacedropdownWhen Depth Map is enabled on the incoming Texture 2d Object Parameter node, this selects the space and value range of the sampled depth value
CoordsdropdownChoose what source to use for the UV Coordinates. If "UV Coord 0" or "UV1 Coord 1" are selected, the respective surface UV set will be used. If "Custom" is selected, the UV Coords input will be exposed and used instead
LOD ModedropdownIf set to "Auto", LOD will be handled automatically. If set to "Custom", the LOD input will be exposed and used instead. If set to "Bias", exposes the Mip Bias port to shift the auto-selected mip level by a given amount.
Use GradientboolSelect the mip from explicit dPdx/dPdy gradients instead of automatic screen-space derivatives; reveals the gradient inputs and overrides LOD Mode.