Go to: Related nodes. Attributes.

Texture2d is the base node from which all the 2d texture nodes derive. Here you will find all the attributes that are common to all 2d textures.

In the table below, important attributes have their names shown in bold in the description column.

This node is abstract

This node is MP safe

Node nameParentsClassificationMFn typeCompatible function sets
texture2dshadingDependNode
rendernode

Related nodes

layeredTexture, envCube, envSphere, envSky, envBall, envChrome, bump3d, uvChooser, bump2d, ramp, file, cloth, water, stencil, checker, fractal, bulge, grid, mountain, texture3d, projection, cloud, granite, crater, leather, stucco, brownian, solidFractal, marble, wood, rock, snow, defaultTextureList, place2dTexture, place3dTexture

Attributes (29)

alphaGain, alphaIsLuminance, alphaOffset, colorGain, colorGainB, colorGainG, colorGainR, colorOffset, colorOffsetB, colorOffsetG, colorOffsetR, defaultColor, defaultColorB, defaultColorG, defaultColorR, filter, filterOffset, invert, outAlpha, outColor, outColorB, outColorG, outColorR, uCoord, uvCoord, uvFilterSize, uvFilterSizeX, uvFilterSizeY, vCoord

Long name (short name)TypeDefaultFlags
alphaGain (ag) float1.0outputinputconnectablestorablekeyable
Alpha Gain is a multiplier that affects the alpha (mask) channel. If this texture is being used as a bump map or a displacement map, you can adjust Alpha Gain to scale the amount of bumping.
alphaIsLuminance (ail) boolfalseoutputinputconnectablestorablekeyable
Alpha Is Luminance can be turned on to make the alpha (mask) output of this node depend on the luminance of the texture. This means that bright areas of the texture will be more opaque when compositing, and dark areas will be more transparent.

This attribute is not used in textures of type Cloth, Ramp, or Stencil.

alphaOffset (ao) float0.0outputinputconnectablestorablekeyable
Alpha Offset is a value that is added to the alpha (mask) channel. This can be used to uniformly increase the effect of the texture.
colorGain (cg) float31.0, 1.0, 1.0outputinputconnectablestorable
Use Color Gain to fine-tune the balance of a texture's Out Color.

Color Gain is applied as a multiplier to the texture's color. If Color Gain is white, it has no effect. Reducing the amount of red (for example) in Color Gain will scale down the amount of red in the final output color.

colorGainR (cgr) float0.0outputinputconnectablestorablekeyable
Color Gain Red Value
colorGainG (cgg) float0.0outputinputconnectablestorablekeyable
Color Gain Green Value
colorGainB (cgb) float0.0outputinputconnectablestorablekeyable
Color Gain Blue Value
colorOffset (co) float30.0, 0.0, 0.0outputinputconnectablestorable
Use Color Offset to brighten and adjust a texture's Out Color.

Unlike Color Gain (which is a multiplier), Color Offset is simply added to the texture's Out Color. Therefore if Color Offset is black, it has no effect. Increasing the amount of red (for example) in Color Offset will uniformly increase the amount of red in the final output color.

colorOffsetR (cor) float0.0outputinputconnectablestorablekeyable
Color Offset red value.
colorOffsetG (cog) float0.0outputinputconnectablestorablekeyable
Color Offset green value
colorOffsetB (cob) float0.0outputinputconnectablestorablekeyable
Color Offset blue value
defaultColor (dc) float30.5, 0.5, 0.5outputinputconnectablestorable
Default Color is the color of the texture in the areas that are not mapped. If the placement of this texture is not covering an entire surface, then Default Color will be used in the areas not covered.
defaultColorR (dcr) float0.0outputinputconnectablestorablekeyable
Default Color red value.
defaultColorG (dcg) float0.0outputinputconnectablestorablekeyable
Default Color green value.
defaultColorB (dcb) float0.0outputinputconnectablestorablekeyable
Default Color blue value.
filter (f) float1.0outputinputconnectablestorable
Filter affects the amount of filtering performed on a texture.

The amount of filtering the system does is calculated based on how much screen space the texture occupies in the final image. The Filter attribute is a multiplier on that value.

Values greater than 1.0 will cause the renderer to do more filtering. This will make the texture blurier. Increase the amount of filtering if there is aliasing (i.e. jagged staircase effects) in your final renderings, or if the texture appears to "pop" or "sizzle" over the course of several frames.

Values less than 1.0 will cause the renderer to do less filtering. This will make the texture appear sharper. Decrease the amount of filtering. if your textures are appearing too blurry in the final rendered images.

This attribute does not do anything if this is a Bulge, Cloth, Ramp, or Water texture.

See also the Filter Offset attribute (below).

filterOffset (fo) float0.0outputinputconnectablestorable
Filter Offset affects the amount of filtering performed on a texture.

Unlike the Filter attribute (which is a multiplier), Filter Offset is added to the system's calculated filtering values. This increases the amount of filtering uniformly.

This attribute can be used to "lock" the system's filtering values. To do this, set the Filter attribute to 0. Then the Filter Offset value will completely determine the amount of filtering.

This attribute does not do anything if this is a Bulge, Cloth, Ramp, or Water texture.

invert (i) boolfalseoutputinputconnectablestorablekeyable
Invert is used to reverse the color values of the texture. When Invert is turned on, white becomes black, black becomes white, red becomes cyan, yellow becomes blue, etc.

This is most often used when the texture is being applied as a bump map. Turning on Invert makes the bump appear to turn inside-out, with hills becoming valleys and vice-versa.

outAlpha (oa) float0.0outputconnectable
Out Alpha is the alpha (mask) value computed by texture. Connect this value to a bump node or a displacement node of a shader to use this texture as a bump or displacement map.
outColor (oc) float30.0, 0.0, 0.0outputconnectable
Out Color is the color computed by this texture. Connect this value to a Color attribute of a shader or another texture to texture map that color.
outColorR (ocr) float0.0outputconnectable
Out Color red value.
outColorG (ocg) float0.0outputconnectable
Out Color green value.
outColorB (ocb) float0.0outputconnectable
Out Color blue value.
uvCoord (uv) float20.0, 0.0outputinputconnectable
The UV coords of the current sample point
uCoord (u) float0.0outputinputconnectable
The u component of the current sample position
vCoord (v) float0.0outputinputconnectable
The v component of the current sample position
uvFilterSize (fs) float20.0, 0.0outputinputconnectablehidden
uvFilterSize is the approximate size of a circular screenspace filter kernel projected into the [0,1] square uv-space of the texture. These values give you an idea of how much filtering is required so that your texture will not alias in your final image.

So if you get values of (1,1.5) coming through the uvFilterSize attribute during shading, it means that the original circular screenspace filter has been projected to a roughly elliptical shape in your texture space, with major/minor axes of lengths 1 and 1.5, respectively.

uvFilterSizeX (fsx) float0.0outputinputconnectablehidden
The X size of the filter (sample)
uvFilterSizeY (fsy) float0.0outputinputconnectablehidden
The Y size of the filter (sample)