Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page provides information on the V-Ray VRayDecal SOP.

 


Overview

...

Section
Column
width55%

V-Ray Decal provides an easy way to project one material on top of another regardless of the target UV set. The projection is masked based on the mask texture specified under the V-Ray Decal settings. All scene geometry is affected by default, only if it intersects the bounding box of the V-Ray Decal. The bounding box is the same as the viewport preview gizmo for the decal.

The Decal Material and the Decal Mask are stored as attributes that can be previewed under the Geometry Spreadsheet → those are shop_materialpath and vray_decal_mask, respectively. You can instance/copy the Decal and change the shop_materialpath and vray_decal_mask on a per-instance basis.

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.

UI Text Box
typenote

The material is projected only on the surfaces within the gizmo.

UI Text Box
typetip

To only affect specific nodes, use the Affected objects settings under the V-Ray Decal.

 

 

UI path: ||obj Network|| > Geometry node > V-Ray > V-Ray Decal

 

Section
Column
width35%

Image Removed

Column
width65%
 
Column
width5%


Column
width40%

...


UI Button
titleDownload Example Files
urlhttps://drive.google.com/uc?export=download&id=1sDr3q6V_OVA1taddsfgFxghhYXNpgh1J
 


Workflow

...

  1. Create a V-Ray Decal inside a Geometry node in |obj| network.
  2. Create and specify a Material for the decal.
  3. Create and specify a Mask Texture for the decal.
  4. Add a Grid in |obj| network.
  5. Render → the decal material should be projected over the Grid geometry where it intersects it. The Mask should also be affecting the projection.

...


Parameters

...

Section
Column
width55%

Main

Z Order – Specifies a layering order when multiple V-Ray Decal gizmos are present. The decal with the larger Z Order value is set on top of the other ones. In case of equal Z Order values, the bounding boxes of the decals are taken into account for positioning.

Size – Size multiplier for the V-Ray Decal box.

Projection Offset (%) – Specifies the offset of the V-Ray Decal gizmo in percentages. This parameter can take values below 0 and above 100.

Normal Angle – Specifies the angle to which the decal is applied onto the surface below.

Enable Fading by Normal Angle – Enables the use of a fade out angle.

Fade Angle – Specifies the angle which creates a fadeout gradient starting from the Normal Angle. Values closer to the Normal Angle produce a sharper gradient. The maximum fade out angle is 180 and it can't take values less than the Normal Angle. See the Fade Angle example for more information.

Bend – Specifies the bend angle for the V-Ray Decal in degrees when placed on a curved surface.

Shading

Project on Back SideEnables the visibility of the projected image on the back side of the face. This option is useful for objects without an actual thickness where the back side of the polygons is exposed to the viewer.

Material – Specifies a material to project over the geometry in the scene.

No Material Color – Specifies the color of the decal when no material is assigned to it.

Mask Texture – Masks the projected material based on a texture. The material must be applied to the V-Ray Decal.

Resize for Mask Texture – Sets aspect ratio from mask file.

Bump

Use Only Decal Bump – When enabled, the original surface bump isn't taken into account.

Surface Bump Amount – Specifies the percentage of the surface bump that affects the V-Ray Decal.

Displacement

Displacement Texture – Specifies a texture to evaluate for the displacement. See the Decal Displacement example for more information.

Displacement Amount – Specifies the amount of displacement applied. A value of 0.0 means the object appears unchanged. Higher values produce a greater displacement effect. A negative value can also be entered, in which case the displacement pushes geometry inside the object. 

Displacement Shift – Specifies a constant which is added to the displacement map values, shifting the displaced surface up and down along the normals. This can either be a positive or negative value.

Use Only Decal Displacement – When enabled, the original surface displacement is not taken into account. See the Use Only Decal Displacement example for more information.

Affected Objects

Exclude Mode – Specifies the effect of the Exclude list.

Exclude – Objects in the Exclude list are not affected by the decal.
Include – Only objects in the list are affected by the decal.

Exclude – Specifies an include/exclude list that allows you to select which scene objects to be affected by the V-Ray Decal.

 
Column
width5%


Column
width40%

 

 

 



...


Example: Decal

 


The example shows the decal effect applied onto a motorcycle. 

Section
Before after
afterLabelon
beforeLabeloff
Panel
borderStylenone

Panel
borderStylenone

 


Anchor
FadeAngleEx
FadeAngleEx

 

...


Example: Fade Angle


The Normal Angle is set to 40 degrees. The first image shows the decal effect without a Fade Angle. The second render has Fade Angle enabled and set to 120 degrees. Note how the effect is enclosed between the Normal and Fade Angles.

Section
Column
width25%

 


Column
width50%
Before after
afterLabelon
beforeLabeloff
Panel
borderStylenone

Panel
borderStylenone

 
Column
width25%

 



Anchor
DecalDisplEx
DecalDisplEx

 

...


Example: Decal Displacement


This example shows the effect of decal displacement.

Section
Column
width25%

 


Column
width50%
Before after
afterLabelon
beforeLabeloff
Panel
borderStylenone

Panel
borderStylenone

Column
width25%

 

...



Anchor
UseDisplEx
UseDisplEx
 

...


Example: Use Only Decal Displacement


This example shows the effect of decal displacement. Use Only Decal Displacement is turned on in the second image.

Section
Column
width25%

 


Column
width50%
Before after
afterLabelon
beforeLabeloff
Panel
borderStylenone

Panel
borderStylenone

Column
width25%

 

...



Notes

...

Fancy Bullets
typecircle
  • Use the Resize for Mask Texture button to resize the decal so that it fits the aspect ratio of the image.
  • All transforms applied to the V-Ray Decal in the node chain (e.g. with a Transform SOP) are considered on export.
  • V-Ray Decal can also be applied on geometry in the SOP level, by merging it inside the node chain. Please check the example scene above.
  • V-Ray Decal can be instanced/copied to points.