Ai Image

The 'Image' node is a color shader which performs texture mapping using a specified image file. You can control the position, size, and rotation of this frame on the surface. You can control how the texture is tiled within the frame using the Scale UV, Flip, Wrap and Swap attributes.

Image Name

The image filename. udim token functionality is supported. For efficiency reasons, UDIM substitution is not supported if image.filename is linked.

Filter

Texel interpolation method used to filter the rendered image file. Cubic is slower but smoother, closest is faster but looks blocky when magnified.

Mipmap Bias

Mip-Mapping Bias offsets the computed Mip-Map level from which the image is sampled. A negative value will force a larger Mip-Map level (clearer image); a positive value will force a smaller Mip-Map level (blurrier image).

^{_{An example of mipmap image storage. The first image on the left is shown with filtered copies reduced in size.}}


0	5

Multiply

Multiplies the image by a constant.


White	Blue

Offset

Uniformly darkens or lightens the texture.


0	0.75

Swrap

Controls how a texture repeats on a large surface. Choose between periodic, black, clamp, mirror and file. The default wrap mode is 'periodic'. The default wrap mode for tiles (UDIM, etc) is 'mirror'. See below.

Twrap

Controls how a texture repeats on a large surface. Choose between periodic, black, clamp, mirror and file. The default wrap mode is 'periodic'. The default wrap mode for tiles (UDIM, etc) is 'mirror'.


Periodic	Black	Clamp	Mirror

'File' wrap mode uses the wrap setting encoded in the file itself (only applies to OpenEXR files). This is useful to preserve information about how a texture should wrap without manual correction afterwors. In certain cases, 'file' mode can prevent edges. For that to work you will need to make the correct choice when you generate mipmaps with 'maketx'.

The example below shows an OpenEXR file used as a latlong skydome that has the file wrap modes set to 'periodic, clamp'. Generating mip maps with this mode prevents artifacts at the sphere poles. When you leave wrap modes with their default values (periodic, periodic) you can see a dot at the top of the sphere. However, if you set wrap modes to 'file' (and use a file that has the correct wrap modes in the metadata), the dot will no longer be visible.


OpenEXR file that has the file wrap modes set to 'periodic, clamp'	Wrap: Periodic (artifact visible at pole of sphere)	Wrap: File (artifact is gone)

Sscale

Scales the image.

Tscale

Scales the image.


Scale U: 1, Scale V: 1	Scale U: 2, Scale V: 2

Sflip

Flip (mirror) the image in the horizontal direction.


Disabled	Enabled

Tflip

Flip (mirror) the image in the vertical direction.


Disabled	Enabled

Single Channel

Read and outputs only the first channel of the image (which is usually R). You can force other channels by defining Start Channel.

Single Channel