Texture Mapping


2D Mapping This node manipulates the mapping of texture on geometries.
3D Mapping This node manipulates the mapping of texture on geometries.
Strip Mapper This node divides a texture into sections and maps only one of these sections on a geometry.

Texture Mapping describes the part of the Rasterization process that is responsible for figuring out which pixels in a texture are used at a specific point on a triangle's surface. The basis for this are the U/V coordinates assigned by the creator of a geometry. They map each vertex to a position in the texture, any interior point of a triangle can then be calculated using interpolation.

To achieve reasonable texture mapping effects on a geometry, it is essential that the geometry provides texture coordinates. All Ventuz Geometry nodes initially provide texture coordinates but imported geometries may be missing them.


Texture Mapping manipulates the U/V coordinate calculated by the Rasterization before it is used to look up a specific pixel. This can for example be used to translate, rotate or scale the way a texture is applied to the surface without changing the original coordinates (the geometry does not have to be updated at all).

2D Mapping

This node provides a special data structure which contains a transformation matrix and other parameters which affect the resulting texture mapping. The output property Mapping has to be bound to the Mapping property of the Texture node.


The properties AlignX and AlignY define the center for texture scaling and rotation. Via PositionX and PositionY the texture on a geometry can be moved along the X and Y axis. The property RotationZ rotates the texture on the Z axis. ScalingX and ScalingY scale the texture along the corresponding axes. ScalingFactorAll is a factor which is additionally multiplied on ScalingX and ScalingY to get the resulting scaling.


The properties in the Mapping category basically affect the way how the texture is projected on the geometry. The property MappingMode specifies the dimensions of the texture:

Disabled Unspecified texture format.
1D Declaring a 1D texture.
2D Declaring a 2D texture.
3D Declaring a cube texture.
4D Declaring a volume texture.

If the property MappingProjected is enabled, the texture coordinates of the geometry are transformed to achieve a an effect as is the texture was projected on the geometry from a certain point in 3D space. The property MappingType specifies how texture coordinates in a geometry vertex should be transformed:

SphereMap The original texture coordinates within the vertex are used for sphere mapping.
CameraSpaceReflectionVector The reflection vectors, transformed to camera space, are used as texture coordinates. A reflection vector is computed from the vertex position and normal vector.
CameraSpacePosition The vertex positions, transformed to camera space, are used as texture coordinates.
CameraSpaceNormal The vertex normals, transformed to camera space, are used as texture coordinates.
PassThru The original texture coordinates within the vertex are used.


The MappingU/V/W properties define how the texture content is addressed. Following modes are possible:

Clamp Texture coordinates outside the range [0.0, 1.0] are set to the texture color at 0.0 or 1.0, respectively.
Border Texture coordinates outside the range [0.0, 1.0] are set to the border color.
MirrorOnce Similar to Mirror and Clamp. Takes the absolute value of the texture coordinate (thus, mirroring around 0), and then clamps to the maximum value.
Mirror Similar to Wrap, except that the texture is flipped at every integer junction.
Wrap Tiles the texture at every integer junction. This causes the texture to be repeated on the object if needed; no mirroring is performed.

The BorderAlpha and BorderColor properties define the alpha and color value of a texture border if an appropriate MappingU/V/W mode is selected. The Base property in the Matrix category allows to manipulate the position, scaling and rotation of the texture via matrix in addition to the manipulation via properties. The Order property defines how this matrix is multiplied with base transformation matrix. In case of Override the manipulation via properties is discarded and only the matrix has an effect on the texture mapping.

3D Mapping

This node works the same as the 2D Mapping node but only makes sense if used with Cube or Volume Textures. In addition to the properties of the 2D Mapping node it allows to move the texture in Z direction and to rotate it on X and Y axis.

Strip Mapper

The Strip Mapper node is a specialized form of the Mapping 2D node to handle tiled images and textures. This node can e.g. be used to play back short image sequences that completely reside on one large image or texture.


The Strip Mapper creates such texture mapping that parts of a texture can be accessed in tiles. The tiles resolution is specified by the properties TilesX and TilesY. This gives the number of images per row and column. The Reduce property defines the number of parts of the texture not filled with any content. The Index is used to select a specific tile of the texture.

The properties in the categories Mapping and Matrix are described in the Mapping 2D node section.

See also: