This page provides information on the V-Ray GeomDisplacedMesh node, which controls displacement on meshes.


Displacement mapping is a technique for adding detail to your scene geometry without having to model it first. The concept is very similar to bump mapping. However, bump mapping is a shading effect that only changes the appearance of a surface, while displacement mapping actually modifies the surface.

 There are two ways to add displacement to an object with V-Ray Displacement. One is through material assignment and the other - directly to the geometry. For detailed information, visit the Displacement Tutorial page.


UI Paths



||mat Network|| > V-Ray > Geometry > Displacement

||Select object|| > V-Ray Shelf > Displacement Properties

||shop Network|| > V-Ray Material node > V-Ray > Geometry > Displacement




Main options when Displacement is created in the mat Network.

Main options when Displacement is created in the obj Network



Displacement Override – This option is available only when displacement is added as Displacement Property to an object. When enabled, it allows displacement override to the whole object with the properties specified in the same tab.

Texture – Specifies a displacement texture

Type – Specifies the mode in which the displacement will be rendered.

Normal – Takes the original surface geometry and subdivides its triangles into smaller sub-triangles which are then displaced. It can be applied for arbitrary displacement maps with any kind of mapping.
2D – Bases the displacement on a texture map that is known in advance. The displaced surface is rendered as a warped height-field based on that texture map. The actual raytracing of the displaced surface is done in texture space, and the result is mapped back into 3D space. The advantage of this method is that it preserves all the details in the displacement map. However, it requires that the object have valid texture coordinates. You cannot use this method for 3D procedural textures or other textures that use object or world coordinates. The displacement map can take any values.
Vector – If using a displacement texture that is not grayscale, V-Ray will convert it to grayscale before rendering the displaced geometry. This mode allows V-Ray to use the Red, Green, and Blue channels of the displacement texture to displace the geometry in the U and V directions in addition to the direction of the face normal.
Vector (Absolute) – A vector-type displacement mode in which the texture is interpreted as 0.5-based tangent space displacement map.
Vector (Object) – Only meaningful when a VRayPtex texture is used for displacement, where the texture values represent 0-based displacement in object space. If mesh information is stored in the Ptex file, V-Ray can also displace correctly mesh deformations.

Flip Green / Blue Channels – When enabled, the Green and Blue channels of the supplied texture map will be swapped. 

Generate – Specifies how the resulting triangles of the displacement algorithm will be inserted into the rayserver.

On the Fly – Dynamic
Pre-Tesselated – Static

Amount –The amount of displacement for white areas of the displacement map. If Use Global Settings is enabled, this value is multiplied by the global displacement Amount option.  A value of 0.0 means the object will appear unchanged. Higher values produce a greater displacement effect. This can also be negative, in which case the displacement will push geometry inside the object.

Shift –Specifies a constant which will be added to the displacement map values, effectively shifting the displaced surface up and down along the normals. This can be either positive or negative. For more information, see the Displacement Shift example below.

Keep Continuity – When enabled, V-Ray will try to produce a connected surface. Use it when you get splits (usually around sharp edges) in the displaced geometry. For more information, see the Keep Continuity example below.

Water LevelGeometry below this displacement level threshold will be clipped away. This can be used for clip mapping a displacement map value below which geometry will be clipped. For more information, see the Clip Mapping example below.

Cache Normals – When enabled, V-Ray generates and saves information about the normal of each newly generated vertex. This requires additional memory but speeds up the shading calculations during rendering. Please see the Displacement Tab to improve output result.

This option is always On when rendering on the GPU. This is not recommended with low displacement settings.



Use Bounds – When enabled, allows the user to set the minimum and maximum values for the displacement texture. For more information, see the Texture Boundaries example below.

Min/Max Bound – These two options allow you to specify custom boundaries for the displaced geometry when Use Bounds is enabled. By default is limited to values between 0 and 1.



Use Global Settings – When enabled, the global Displacement quality settings from the V-Ray Renderer will be used.

View Dependent – Determines if view-dependent tessellation is used.  When enabled, Edge Length determines the maximum length of a subtriangle edge, in pixels. A value of 1.0 means that the longest edge of each subtriangle will be about one pixel long when projected on the screen. When  View-dependent  is off, Edge length  is the maximum subtriangle edge length in world units.

Edge Length – The maximum length of a subtriangle edge after subdivision. This affects the degree of subdivision before displacement, which in turn affects the quality of the displacement itself. Each triangle of the original mesh is subdivided into a number of subtriangles. More subtriangles mean more detail in the displacement, slower rendering times and more memory usage. Less subtriangles mean less detail, faster rendering and less memory used. Units used for this parameter depend on the View Dependent parameter. For more information, see the Edge Length example below.

Max Subdivisions – Controls the maximum number of subtriangles generated from any one triangle of the original mesh. The square of this value is used. For example, a value of 256 means that at most 256 x 256 = 65536 subtriangles will be generated for any given original triangle. It is recommended that this value not be increased a great deal over the default value of 256. If you need to use higher values, it is better to first tessellate the original mesh itself into smaller triangles before starting the displacement process.

Tight Bounds – When enabled, causes V-Ray to compute more precise bounding volumes for the displaced triangles, leading to slightly better rendering times.

In GPU mode where Cache Normals is always enabled, lowering the Edge length or increasing the Max. subdivs will help to achieve results more closely in line to CPU mode.



Render As Subdivision  When enabled, the object will be subdivided during rendering.

Preserve Map Borders – Specifies how to handle subdivisions of UV coordinates at UV seams. The possible values are:

Not Set – The default value when the value has not been set.
None – UVs are always subdivided regardless of whether they are on a UV seam or not
Internal – Only preserve UVs if they are on an internal UV seam;
All – Does not subdivide UVs on UV seams.

Classic Catmull-Clark – When this option is enabled, V-Ray will use the Classic Catmull-Clark method for subdividing the mesh instead of the hybrid one used by default. This option should be enabled only if the mesh is composed entirely of rectangular faces or it will not work.


2D Settings


Resolution – Determines the resolution of the displacement texture used by V-Ray. If the texture map is a bitmap, it would be best to match this resolution to the size of the bitmap. For procedural 2D maps, the resolution is determined by the desired quality and detail in the displacement. Note that V-Ray will also automatically generate a normals map based on the displacement map, to compensate for details not captured by the actual displaced surface.

Precision – Related to the curvature of the displaced surface; flat surfaces can do with a lower precision (for a perfectly flat plane you can use a value of 1), more curved surfaces require higher values. If the precision is not high enough you can get dark spots ("surface acne") on the displacement. Lower values compute faster.

Filter Texture – When enabled, the texture map will be filtered before the actual displacement takes place.

Filter Blur – Specifies the amount of blur that will be applied to the texture before the displacement takes place. 

Multi-Tile – Enables or disables support for tiled textures (UDIM/UVTILE) when generating 2d displacement.


Example: Displacement Shift


Note that the Displacement Shift parameter is an absolute value in world units. If you change the Displacement Amount, you will probably need to adjust the Displacement Shift too.



 Displacement Shift = -5.0

Displacement Shift  = 0.0

Displacement Shift  = 5.0




Example: Edge Length 

The image below was rendered with a Edges Map | VRayEdgesTex  in the Diffuse slot of the material, so you can see the original triangles of the mesh. Additionally, we turned on the Faceted option in the VRayMtl. Now, V-Ray will not only smooth the surface normals, but will also automatically apply a normals map that represents the normal of the perfect displaced surface, which will make the surface look a lot more detailed that it actually is.

View-dependent is turned on, and it refers to pixels in the original image, not the zoomed-in image you get with a blow-up rendering. This is why we were able to do a blow-up rendering to see the individual subtriangles better. Click the images for a larger view:


Edge Length 0.5

Edge Length 0.5 Close up view

Edge Length 1.0

Edge Length 1.0 Close up view

Edge Length 2.0

Edge Length 2.0 Close up view

Edge Length 5.0

Edge Length 5.0 Close up view

Edge Length 10.0

Edge Length 10.0 Close up view


Example: Keep Continuity


The Keep Continuity option is useful for objects with disjoint normals on neighboring triangles, usually because of different smoothing groups. In the middle image below you can see the edge splits produced by disjoint normals. Using the Keep Continuity option avoids this problem. This option will also help to produce a smoother result across material ID boundaries for objects with multiple materials.



No displacement

Keep Continuity = disabled


Keep Continuity  = enabled



Example: Clip Mapping

Note: The Water Level parameter is also absolute in world units. If you change the Displacement Amount and/or Displacement Shift, you will probably need to adjust the Water Level to get the same effect. For this example, the Displacement Amount parameter is set to 5.0 and the Displacement Shift parameter is set to 0.0.

Water Level = 0.0 (no clipping)

Water Level = 1.25


Water Level = 2.5


Water Level = 3.75





Example: Texture Boundaries

This example shows a plane mapped with a displacement map that has negative values. With the default boundaries for the displacement (from 0 to 1) we are unable to see the geometry displaced in the negative direction. However, once we set Displacement bounds to Explicit and set Min value and Max value to -1 and 1 respectively, we can see the displaced geometry in both the positive and negative direction.



Min value  = 0 ; Max value = 1

Min value  = -1 ; Max value = 1


Page Contents ×