This page provides information about the Toon Override material in V-Ray for Revit.
Overview
The Toon Override material is related to the global Contour settings and some of the global options affect all Toon Override materials.
The Toon Override material is available only when the engine is set to CPU. It is currently not supported for GPU.
Toon materials from previous V-Ray versions will be automatically migrated to Toon Override materials.
UI Options
The Toon Override material settings are organized in Basic and Advanced modes. You can switch the mode from the toggle () button under the Preview Swatch.
From the Add Attribute button, you can select additional attributes that can add up to the appearance of the material. See the Attributes section below.
An Add Layer button is provided for some V-Ray materials. You can select an additional layer that can add up to the appearance of the material.
The context menu of the Color slot provides options to Copy and Paste, as well as to Reset the color.
A Reset option is provided in the context menu of each Number Slider. You can reset the slider value to the default one.
Contour
Base – Specifies the material on top of which the toon effect is applied.
Line Color – Specifies the color of the outlines. If a texture is selected, it overrides the color as long as the texture checkbox is enabled. See the Lines Color example below.
Opacity – Specifies how transparent or opaque the outlines are. A texture map can be used for this channel.
Normal Threshold – Determines when lines will be created for parts of the same object with varying surface normals (e.g. at the inside edges of a box). A value of 0.0 means that only 90 degrees or larger angles generate internal lines. Higher values mean that smoother transitions between face normals can also generate a line. Setting this value to 1.0 fills curved objects completely.
Overlap Threshold – Determines when outlines will be created for overlapping parts of the one and the same object . Lower values reduce the internal overlapping lines, while higher values produce more overlap lines. Setting this value to 1.0 fills curved objects completely.
Width – Specifies the width of the outlines. See the Line Width example below.
Inner Line Control – Enables a separate control for the inner edges. See the Inner Line Control example below.
Inner Line Color – Specifies the color of the inner lines. See the Lines Color example below.
Inner Width – Specifies the width of the inner lines.
Some of the global parameters have an effect on all materials with Contour attribute. These parameters are Width Type, Trace Bias, Hide Inner Lines, Visible in Reflections/Refractions, and Compensate EV.
Override Control
Can be Overridden – When enabled, the material can be overridden when you enable the Opaque override option in the Global Overrides tab of App.Man.
Attributes
The attributes from the following expandable menus are available for the Toon Override material.
Translucency
Back Material– Defines the material V-Ray uses for back side faces as defined by their normals.
Translucency – Determines if the front or the back side of the material is more visible in the rendering process. By default this value is 0.5, which means that both sides are equally visible. When this parameter is closer to zero, the material facing the camera is more visible, when it is closer to one, the back material is more visible. A texture can be used to control the variation of the effect.
Mult. by Front Diffuse – When enabled, the translucency is multiplied by the diffuse of the front material.
Bump
Mode/Map – Specifies the bump map type.
Bump Map – A height map should be used.
Bump Texture Channel – Some V-Ray textures have a special bump channel output that can be used here. It is most commonly used for Round Edges effect. Edges texture is used as a bump.
Normal Map – RGB normal map should be used with this option. Note that in most cases the normal map bitmap color space should be set to Linear to ensure correct results.
Amount – Multiplier for the bump/normal map.
Delta Scale – Specifies a scale for sampling the bitmap when using bump mapping. The exact value is calculated automatically by V-Ray, but can be called here.
Displacement
This is a legacy attribute that will be removed in the future. Consider using the geometry displacement modifier instead. It can be created as a geometry asset in the Outliner and can be applied to objects in the scene. Note that the displacement effect will no longer appear in the Preview Swatch.
Displacement – Enables or disables the displacement effect.
Mode/ Map – Specifies the mode in which the displacement is rendered.
2D Displacement – Bases the displacement on a texture map that is known in advanced. 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 details in the displacement map. However, it requires the object to have valid texture coordinates. You cannot use this method for 3d procedural textures or other textures that use object or world coordinates. The parameter can take any values.
Normal Displacement – Takes the original surface geometry and subdivides its triangles into smaller sub-triangles, which then are displaced.
Amount – The amount of displacement. A value of 0.0 means the object appears unchanged. Higher values produce a greater displacement effect. This parameter can also take a negative value, in which case the displacement pushes geometry inside the object.
Shift – Specifies a constant, which is added to the displacement map values, effectively shifting the displaced surface up and down along the normals. This can be either positive or negative.
Keep Continuity – When enabled, tries to produce a connected surface, without splits, when there are faces from different smoothing groups and/or material IDs. Note that using material IDs is not a very good way to combine displacement maps since V-Ray cannot always guarantee the surface continuity. Use other methods (vertex colors, masks etc.) to blend different displacement maps.
Resolution – This option is available when the Mode/Map is 2D Displacement. It determines the resolution of the displacement texture used by V-Ray. If the texture is a bitmap, it is recommended 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 also automatically generates a normal map based on the displacement map in order to compensate for details not captured by the actual displaced surface.
View Dependent – 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 is about one pixel long when projected on the screen. When disabled, Edge length is the maximum sub-triangle edge length in world units.
Edge Length – Determines the quality of the displacement. 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 RAM usage. Less subtriangles mean less detail, faster rendering and less RAM. The meaning of Edge length depends on the View dependent parameter. The slider's minimum range is set to 0.4. Using lower values is still possible by manually typing them in the input box but it may cause significant render delay.
Max Subdivs – Controls the maximum sub-triangles generated from any triangle of the original mesh when the displacement type is Subdivision. The value is in fact the square root of the maximum number of subtriangles. 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 not a good idea to keep this value very high. If you need to use higher values, it will be better to tessellate the original mesh itself into smaller triangles instead. The actual subdivisions for a triangle are rounded up to the nearest power of two (this makes it easier to avoid gaps because of different tessellation on neighboring triangles).
Water Level – Clips the surface geometry in places where the displacement map value is below the specified threshold. This can be used for clip mapping a displacement map value below which geometry will be clipped.
Level Height – Value below which the geometry is clipped.
Materials need to be applied to objects (groups/components) to have working displacement. If various materials are applied to different faces of an object, the displacement from the top-level (group/component) material will be used on all of them. Normal Displacement will take into account the texture size of each different face material, while 2D Displacement will ignore them.
Raytrace Properties
Visible to Camera – When enabled, makes objects using this material visible to the camera.
Visible to Reflections – When enabled, this option makes objects using this material visible for to Reflection rays.
Visible to Refractions – When enabled, this option makes objects using this material visible for the Refraction rays.
Cast Shadows – When disabled, all objects with this material applied do not cast shadows.
Override
Shadows – The material that is used when a shadow ray hits the surface.
Reflection – The material that is used when a reflection ray hits the surface.
Refraction– The material that is used when a refraction ray hits the surface.
GI – The material that is used when a GI ray hits the surface.
Environment – The texture that will be used instead of the scene environment maps.
Material ID
ID Number – Isolates objects as an R/G/B mask in the MultiMatte Materials render element.
ID Color – Allows you to specify a color to represent this material in the Material ID VFB render element.
Each material is assigned with an automatically generated ID Color.
Examples
Example: Line Width
This example shows the effect of the Width parameter. The Inner Line Control is disabled.
Width = 0
Width = 0.5
Width = 1
Width = 1.5
Width = 2
Example: Inner Line Control
This example shows the effect of the Inner Line Control parameter. The main lines are black and the Inner Lines are red. The Width of the main lines is set to 3, while that of the Inner Lines is set to the default 1.5.
Example: Line Color
This examples shows the effect of the Line Color and Inner Line Color parameters.
Line Color is red, Inner Lines are disabled.
Line Color is red, Inner Line Color is black
Line Color is green, Inner Line Color is blue