Contents

Image

A texture referencing a 2D image file.

Parameter Types

Parameter descriptions

File

The image file to use for the texture.

Default

The default value to use if the ​file​ reference fails to resolve.

Texture Coordinates

The 2D coordinate at which the data is read in order to map the texture onto a surface. The default is to use the current UV coordinates, in which U is the horizontal axis and V is the vertical axis.

Uaddressmode

The way that the node will handle U values outside of the range of 0-1.

Vaddressmode

The way that the node will handle V values outside of the range of 0-1.

Filter Type

The type of texture filtering the node will use.

Discussion

The Image node creates a material from an image file. This node samples data from a single image, and maps it onto an object. The address modes for the Image node tell it how to handle U and V values outside of the normal range of 0-1. Uaddressmode and Vaddressmode take one of four values to determine their behavior.

  • constant: Texture coordinates outside the normal range return the Default input.

  • clamp: Texture coordinates outside the normal range are clamped to the normal range. Any values greater than 1 will be set to 1, and any values less than 0 will be set to 0

  • periodic: Texture coordinates outside the normal range will “wrap around.” This behavior is effectively equivalent to applying modulo 1 to the coordinates.

  • mirror: Texture coordinates outside the normal range will be mirrored.

Below is an example of a simple node graph that uses the Image node to create a material from an image:

[Image]

Below, the resulting texture applies to a cube:

[Image]

See Also

Nodes