Doc:2.6/Manual/Modifiers/Deform/Displace

Displace Modifier

Mode: Any mode

Panel: Modifiers

Description

The Displace modifier displaces vertices in a mesh based on the intensity of a texture. Either procedural or image textures can be used. The displacement can be along a particular local axis, along the vertex normal, or the separate RGB components of the texture can be used to displace vertices in the local X, Y and Z directions simultaneously.

Options

Displace modifier

Texture

The name of the texture from which the displacement for each vertex is derived.

If this field is empty, the modifier defaults to 1.0 (white).

Vertex Group

The name of a vertex group which is used to control the influence of the modifier.

If VGroup is empty, the modifier affects all vertices equally.

Midlevel

The texture value which will be treated as no displacement by the modifier. Texture values below this value will result in negative displacement along the selected direction, while texture values above this value will result in positive displacement. This is achieved by the equation (displacement) = (texture value) - Midlevel.

Recall that color/luminosity values are typically between 0.0 and 1.0 in Blender, and not between 0 and 255.

Direction

The direction along which to displace the vertices.

Can be one of the following:

• X – displace along local X axis.
• Y – displace along local Y axis.
• Z – displace along local Z axis.
• RGB -> XYZ – displace along local XYZ axes individually using the RGB components of the texture.
• Normal – displace along vertex normal.

Texture Coordinates

The texture coordinate system to use when retrieving values from the texture for each vertex.

Can be one of the following:

• UV – take texture coordinates from face UV coordinates.

UV Layer

The UV coordinate layer from which to take texture coordinates.

If the object has no UV coordinates, it uses the Local coordinate system. If this field is blank, but there is an UV coordinate layer available (e.g. just after adding the first UV layer to the mesh), it will be overwritten with the currently active UV layer.

Note Since UV coordinates are specified per face, the UV texture coordinate system currently determines the UV coordinate for each vertex from the first face encountered which uses that vertex; any other faces using that vertex are ignored. This may lead to artifacts if the mesh has non-contiguous UV coordinates.

• Object – take the texture coordinates from another object’s coordinate system (specified by the Object field).

Object

The object from which to take texture coordinates. Moving the object will therefore alter the coordinates of the texture mapping. Take note that moving the original object will also result in a texture coordinate update. As such, if you need to maintain a displacement coordinate system while moving the object to which the displacement is set, you will also have to move the related object at the same rate and direction.

If this field is blank, the Local coordinate system is used.

• Global – take the texture coordinates from the global coordinate system.

• Local – take the texture coordinates from the object’s local coordinate system.

Strength

The strength of the displacement. After offsetting by the Midlevel value, the displacement will be multiplied by the Strength value to give the final vertex offset. This is achieved by the equation (vertex_offset) = (displacement) × Strength.

A negative strength can be used to invert the effect of the modifier.

See also

• Blender artists post: Displace modifier tutorial (September 2006)