Table of Contents

This page provides information on V-Ray Decal for Rhino.


V-Ray Decal provides an easy way to project one material on top of another regardless of the target UV set. The projected material is placed in an adjustable V-Ray Decal projection box that controls its size, placement and projection limits in the Viewport. Multiple V-Ray Decals can be stacked on top of each other and their overlapping is controlled by the parameters in each V-Ray Decal object. The V-Ray Decal’s effect is visible at render time only.

The material is projected only on the surfaces within the projection box.



UI Paths


||Asset Editor|| > Geometries (right-click) > Decal

||Asset Editor|| > Create Asset > Geometries > Decal


||V-Ray Objects Toolbar|| > Decal (left-click)

Rhino Menus Ribbon

||V-Ray|| > Objects > Decal




Creating V-Ray Decal

Select the Decal button from the V-Ray toolbar or form the V-Ray menu > V-Ray objects > Decal and create the Decal projection box on top of the surface you wish to project on.

After creating the Decal projection box, go to the parameters section in the Asset Editor and assign a material that will be projected on the surface.

You can adjust the size of the projection window from the decal parameters section.

 First creation point is the lower left corner of the image. Second creation point is the upper right image corner. The line next to the arrow points to the top of the decal texture.


This image shows how the orientation arrow works with the Decal projection box. The line marked in red has different positions corresponding with the Decal orientation. 




Decal – Enables or disables the V-Ray Decal.

Material – Specifies the Decal material. The input slot () of the Material has a context menu available when you right-click on it. You can also drag-and-drop materials into the slot.

Mask – A texture that controls the transparency of the projected material. Switch it on and off using the checkbox.

Z Order – Sets the order of the selected Decal in case multiple overlapping Decals are present.





Example: Material Preview

Width – Defines the width of the projection box.

Length – Defines the length of the projection box.

Auto Resize – Resizes the V-Ray Decal to match the aspect ratio of the first eligible Bitmap texture (image file) in the assigned material, decal mask or external file, depending on one of the selected options. Note that procedural textures are not included.

Fit to Mask – Matches the aspect ratio of the Decal mask texture.
Fit to Material – Matches the aspect ratio of the first eligible Bitmap texture (image file) in the assigned material. (See the list of eligible Bitmap's priority below.)
Fit to Bitmap – Matches the aspect ratio of an external image file.

When the option "Fit to Material" is selected for each material, the first eligible Bitmap will be selected from top to bottom from the eligible Bitmap's priority listed below:

Eligible Bitmap's priority

Generic material (BRDFVRayMtl):

Diffuse Color
Reflection Color
Refraction Color
Bump Map
Coat Color
Translucency SSS Color

Emissive (BRDFLight):


Car Paint 2 (BRDFCarPaint2):

Base Color
Base Reflection
Base Bump Map

Subsurface Scattering (BRDFSSS2Complex):

Overall Color
Diffuse Color
Sub-Surface Color
Scatter Color
Specular Color

Depth – Defines the Depth of the projection box.

Projection Offset (%) – Specifies the offset of the Decal projection in percentages. Positive values move the projection towards the target while negative ones move it away. This parameter can take values below 0 and above 100.

Bend Angle – Specifies the bend angle of the Decal projection pane in degrees. Its shape can curve between a flat surface at 0 degrees and an enclosed cylinder at 360. Note that increasing Decal width when its bend angle is 360 degrees may alter the Decal width when its bend angle is 360 degrees may alter the Decal widget's center.



Example: Bend Angle






Normal Angle – Limits the Decal effect based on the angle between the target surface and the projection direction.

Fade Out – Enables fade out angle.

Fade Out Angle – Specifies the minimum value of the fade out angle, e.g. if set to 44, the minimum fade out angle value is 44 and the maximum fade out angle value is up to 180. By default it equals the Normal Angle value.

Backside Projection – Enables projection on the back face. Note that if the result from the Decal is not immediately visible, further adjusting of the Normal Angle parameter is needed.


Decal Bump Only – When enabled the Decal material's bump effect overrides any bump effect of the surfaces it is projected onto.

Surface Bump – Controls what amount of bump effect from the surface material is blended with the Decal projection bump effect.



Example: Decal Bump Only






DisplacementEnables a displacement effect applied through the V-Ray Decal. It adds detail to the surfaces affected by the Decal projection by modifying their topology based on a texture map. The Decal displacement quality is predefined, so displacement amount higher than the default one can lead to unwanted effect. Adjustments to the quality are only manually set by applying V-Ray Displacement on the object(s) affected by the Decal projection. The Decal displacement effect then individually adopts the quality parameters of each object's Decal. This allows a single Decal to project varying displacement effects on multiple objects.

Map – Controls the surface detail produced by the displacement effect via a texture map. If no texture is used, the displacement effects each surface under the decal projection.

Amount Multiplier – Multiplies the displacement effect. Higher values produce a greater displacement effect. Negative values currently inverted the displacement map.

Blend Displacement – Blends the Decal Displacement effect with any displacement from objects affected by the Decal projection. Keeping this option disabled forces Decal displacement to override any other displacement effects.

The V-Ray Decal Displacement is not shown when a 2D Displacement is applied to an object. The Normal (3D) Displacement can not be mixed with 2D Displacement.





Decal in Rhino Properties Panel

The  button opens the Geometries property panel of the selected Decal in the V-Ray Asset Editor.

Make Unique – Makes the selected instance of a Decal unique. It creates a new Decal item in the Asset Editor that is linked only to the selected object.

Select Instances – Selects all objects that have an instance of the same Decal in the viewport.

Exclusion Mode – Selects the exclusion mode type.

Include – The Decal affects only a predefined selection of objects.
Exclude –  The Decal affects all geometry in its range excluding a predefined selection of objects.

Pick Objects – Selects objects that are affected by the Decal based on its Exclusion mode. To reset the list of affected objects press the Pick Objects button again.

Select Objects – Selects the objects affected by the Decal based on its Exclusion mode





  • Decals are rendered only on surfaces with normals facing the projecting direction of the decal.

Was this helpful?