© Square Enix © Goodbye Kansas


Table of Contents

This page provides information about the V-Ray Material Complex in V-Ray for Houdini. 


Overview


V-Ray Material Complex represents a network of connected V-Ray nodes that can be used for various purposes. It is basically a preset V-Ray Material Builder, that has its interface exposed for easier tweaking of the settings.

All assigned texture maps can be made visible in the Houdini viewport. The tabs of the V-Ray Material Complex have two options of displaying the parameters - in default mode, where the most common settings reside, and in advanced mode, where you can have finer control.



Surface



Diffuse

Color – The diffuse color of the material. Note: the actual diffuse color of the surface also depends on the reflection and refraction colors.

Roughness – Specifies the roughness of the diffuse part of the material. Used to simulate rough surfaces or surfaces covered with dust (for example, skin, or the surface of the Moon).

Opacity

Opacity – Assigns opacity to the material where 1.0 is completely opaque and 0.0 is completely transparent.

Self-Illumination

Multiplier – A multiplier for the self-illumination color of the material.

Color – The self-illumination color of the material.

Bump/Normal 

Type – Specifies whether a bump map or a normal map effect is added to the base material. 

Bump – Applies the map as a bump map.
Normal (Tangent) – Applies the map as a normal map in tangent space.
Normal (Object) – Applies the map as a normal map in object space.
Normal (Camera) – Applies the map as a normal map in screen/camera space.
Normal (World) – Applies the map as a normal map in world space.
From Bump – The map is applied as determined by map type itself.
Explicit Normal – Applies the map as an explicit normal.

Amount – Specifies the strength for the bump/normal effect.

Show Advanced OptionsWhen enabled, exposes some advanced options in this tab.




Diffuse

Model – Specifies the Roughness model.

Oren-Nayar  reflectivity model for diffuse reflection from rough surfaces that has been shown to accurately predict the appearance of a wide range of natural surfaces. We recommend using this roughness model.
Gamma-based  The roughness model used in previous versions of V-Ray. This is not the recommended option.

Opacity

Model – Controls how the opacity map works.

Normal – The opacity map is evaluated as normal: the surface lighting is computed and the ray is continued for the transparent effect. The opacity texture is filtered as normal.
Clip – The surface is shaded as either fully opaque or fully transparent depending on the value of the opacity map (i.e. without any randomness). This mode also disables the filtering of the opacity texture. This is the fastest mode, but it might increase flickering when rendering animations.
Stochastic – The surface is randomly shaded as either fully opaque or fully transparent so that on average it appears to be with the correct transparency. This mode reduces lighting calculations but might introduce some noise in areas where the opacity map has gray-scale values. The opacity texture is still filtered as normal.

Self-Illumination

Self_Illumination Affect GI – When enabled, the self-illumination color affects GI computations.

Bump/Normal

Bump Shadows – When enabled, offsets the surface shading point in addition to the normal.

Compute Bump For Shadows – When enabled, V-Ray computes bump mapping for shadow rays in case the material is transparent. When disabled, V-Ray skips the computation and uses the bump map for shadow rays (faster rendering).

Advanced Options

Show Advanced OptionsWhen enabled, exposes some advanced options in this tab.

Dive to Surface Node – Press this button to dive into the Complex Material network of nodes and select the Surface Node.

Dive to Bump Node – Press this button to dive into the Complex Material network of nodes and select the Bump Node.




Reflection



Reflection

Model – Determines the type of BRDF (the shape of the highlight and glossy reflections). This parameter has an effect only if the Reflection Color is different from black and Reflection Glossiness is different from 1.0. 

Phong – Phong highlight/reflections
Blinn – Blinn highlight/reflections
Ward – Ward highlight/reflections
MIcrofacet GTR (GGX) – GGX Microfacet highlight/reflections

GGX is the most modern and flexible BRDF (Bidirectional reflectance distribution function) type and is able to better represent a broad range of materials thanks to its ability to control the shape of the specular lobe.

There currently isn't any particular performance difference between models and there is little reason to choose any of the other types.

Historically, the Phong, Blinn, Ward and GGX are successive reflectance models developed over the years in computer graphics where each model aimed to improve on the limitations of the previous ones. For example, the specular highlights with the Phong model have a very narrow and bright center with no falloff, but it doesn't work well with anisotropic reflections. The Blinn model has broader highlight center with a tight falloff. The Ward model has an even broader center and falloff. The GGX model has a bright center and an even longer falloff (at default settings). In the past, each model's characteristics resembled more closely a certain type of material, for example Phong could be used for plastics, Ward for cloth and metals, and Blinn for other common surfaces. However with the introduction of the GGX model, all of these surfaces can be approximated well, thus reducing the need for using the other models.

It should be noted that no principled model is able to represent all possible materials entirely accurately, and where those models fail - for example when the material isn’t viewed frontally - only approaches such as that of V-Ray Chaos Scans are able to capture the correct material representation. 

GTR Tail Falloff – Controls the transition from highlighted areas to non-highlighted areas when the Model (BRDF Type) is set to GGX.

Color – Reflection color. Note that the reflection color dims the Diffuse Color.

Glossiness – Controls the sharpness of reflections. A value of 1.0 means perfect mirror-like reflection; lower values produce blurry or glossy reflections. Use the Reflection Subdivs parameter below to control the quality of glossy reflections.

Unlock Fresnel IOR – The IOR to use when calculating Fresnel reflections. Normally this is locked to the Refraction IOR parameter, but you can unlock it for finer control.

Use Fresnel – When enabled, makes the reflection strength dependent on the viewing angle of the surface. Some materials in nature (glass, etc.) reflect light in this manner. Note that the Fresnel effect depends on the index of refraction (IOR) as well.

Show Advanced OptionsWhen enabled, exposes some advanced options in this tab.




Reflection

Metalness – Controls the reflection model of the material from dielectric (metalness 0.0) to metallic (metalness 1.0). Note that intermediate values between 0.0 and 1.0 do not correspond to any physical material. This parameter can be used with PBR setups coming from other applications. The reflection color should typically be set to white for real world materials.

Glossy Fresnel – When enabled, uses glossy fresnel to interpolate glossy reflections and refractions. It takes the Fresnel equation into account for each "microfacet" of the glossy reflections, rather than just the angle between the viewing ray and the surface normal. The most apparent effect is less brightening of the grazing edges as the glossiness is decreased. With the regular Fresnel, objects with low glossiness may appear to be unnaturally bright and "glowing" at the edges. The Glossy Fresnel calculations make this effect more natural.

Anisotropy

Strength – Determines the shape of the highlight. A value of 0.0 means isotropic highlights. Negative and positive values simulate "brushed" surfaces.

Rotation – Determines the orientation of the anisotropic effect in a float value between 0 and 1 (where 0 is 0 degrees and 1 is 360 degrees).

Axis – Specifies a local object axis for the anisotropy effect.

Advanced Options

Show Advanced OptionsWhen enabled, exposes some advanced options in this tab.

Dive to Surface Node – Press this button to dive into the Complex Material network of nodes and select the Surface Node.




Transmission



Refraction

Color – Refraction color. Note that the actual refraction color depends on the Reflection Color as well.

Glossiness – Controls the sharpness of refractions. A value of 1.0 means perfect glass-like refraction; lower values produce blurry or glossy refractions.

IOR – Index of refraction for the material, which describes the way light bends when crossing the material surface. A value of 1.0 means the light does not change direction.

Absorption

Color – The attenuation of light as it passes through the material. This option helps simulate the fact that thick objects look less transparent than thin objects. Note that the effect of the absorption color depends on the absolute size of the objects and is therefore scene-dependent. This parameter can be mapped with a texture. It is recommended that you use a 3D texture for the purpose. 

Multiplier – The strength of the absorption effect. Smaller values reduce the effect, making the material more transparent. Larger values increase the effect, making the material more opaque.

Show Advanced Options – When enabled, exposes some advanced options in this tab.




Refraction

Dispersion Abbe. – Increases or decreases the dispersion effect. Lowering it widens the dispersion and vice versa.

Absorption

Bias – Changes the way the fog color is applied. Negative values make the thin parts of the objects more transparent and the thicker parts more opaque and vice-versa (positive numbers make thinner parts more opaque and thicker parts more transparent).

Translucency

Mode – Selects the algorithm for calculating translucency (also called sub-surface scattering). Note that refraction must be enabled for this effect to be visible. Currently only single-bounce scattering is supported.

None – No translucency is calculated for the material.
Hard (wax) model – This model is specifically suited for hard materials like marble.
Soft (water) model – This model is mostly for compatibility with older V-Ray versions (1.09.x).
Hybrid model – This is the most realistic SSS model and is suitable for simulating skin, milk, fruit juice and other translucent materials.

Color – Normally the color of the sub-surface scattering effect depends on the Absorption color; this parameter allows you to additionally tint the SSS effect.

Scatter Coeff. – The amount of scattering inside the object. A value of 1.0 means rays are scattered in all directions; 0.0 means a ray cannot change its direction inside the sub-surface volume.

Backwrd/Fwd Coeff. – Controls the direction of scattering for a ray. A value of 1.0 means a ray can only go forward (away from the surface, inside the object); 0.5 means that a ray has an equal chance of going forward or backward; 0.0 means a ray is scattered backward (towards the surface, to the outside of the object).

Max Trace Distance – The number of times a ray can be reflected. Scenes with lots of reflective and refractive surfaces may require higher values to look correct.

Advanced Options

Show advanced OptionsWhen enabled, exposes some advanced options in this tab.

Dive to Surface Node – Press this button to dive into the Complex Material network of nodes and select the Surface Node.




Textures



Diffuse/Self-Illum./Bump/Reflection/Reflection Glossiness/Refraction/Refraction Glossiness/ Displacement – Each of these channels can have a texture map assigned and controlled from this tab. The drop down menu activates a field where you can specify how to control its settings.

From Tab – The value for the parameter is taken from its tab settings.
Image File – Activates the image field, so you can attach an image file.
Vector/Float Attr. – Activates the last field for the parameter, where you can specify an attribute to control the parameter's settings.
Disabled (Only for Bump and Displacement) – Bump and Displacement can either be used with an image file or stay disabled.

Choosing an option other than From Tab in the drop down menu of each parameter, deactivates its corresponding tab options.

Viewport Display Options

Display Diffuse Texture – When enabled, the diffuse texture is visible in the viewport.

Display Custom Channel – Specifies the UV attribute name that Houdini uses to map the texture in the viewport.

Display Reflections – Enables a rough representation of the reflection in the viewport, taken only from the Reflection tab.

Display Transparency – Enables a rough representation of the refraction in the viewport, taken only from the Transparency tab.

Display Displacement – Enables a representation of the displacement in the viewport, displaying also the Amount and Shift values from the tab.

Display Custom Channel – Shows any of the specified textures in the viewport. You have to include the relative path to the texture in order to see it.

Show Advanced OptionsWhen enabled, exposes some advanced options in this tab.




Roughness/Reflect IOR/Aniso. Strength/Aniso. Rotation/Metalness/Refraction IOR/Absorption/Translucency – Each of these channels can have a texture map assigned and controlled from this tab. The drop down menu activates a field where you can specify how to control its settings.

From Tab – The value for the parameter is taken from its tab settings.
Image File – Activates the image field, so you can attach an image file.
Vector/Float Attr. – Activates the last field for the parameter, where you can specify an attribute to control the parameter's settings.

Choosing an option other than From Tab in the drop down menu of each parameter, deactivates its corresponding tab options.

UVs

From this panel you can control how the texture mapping is executed.

UVs Type – Specifies whether to use the geometry's UV mapping (Use Geometry UV's) or the projection (Use Projection) to generate the UVs.

Projection Type – (available only when the UVs Type is set to Use Projection) Specifies the type of projection mapping to use from the following:

None 
Planar 
Spherical 
Cylindrical
Ball 
Cubic 
Triplanar 
Perspective

UV Attribute Name – Specifies the name of the UV attribute.

Repeat UV – Specifies the number of times to repeat the texture in the U / V direction.

Offset UV – Specifies an offset for the U / V position.

Noise UV – Specifies the amount of noise to add.

Rotate UV – Specifies a rotation amount in UV space.

Wrap U/V – Enables texture wrapping in the U / V direction.

Mirror U/V – Enables texture mirroring in the U / V direction.

Stagger – Enables texture staggering.

Advanced Options

Show advanced OptionsWhen enabled, exposes some advanced options in this tab.

Dive to UV Node – Press this button to dive into the Complex Material network of nodes and select the UV Node.




Displacement



Main

Texture Type – Specifies the mode in which the displacement is 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 converts 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, if 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.

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 appears unchanged. Higher values produce a greater displacement effect. This can also be negative, 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.

Water Level – Geometry below this displacement level threshold is clipped away. This can be used for clip mapping a displacement map value below which geometry is clipped. 

Options

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

Use Bounds – When enabled, sets the minimum and maximum values for the displacement texture. 

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.

Show Advanced OptionsWhen enabled, exposes some advanced options in this tab.




Options

Keep Continuity – When enabled, V-Ray produces a connected surface. Use it when you get splits (usually around sharp edges) in the displaced geometry. 

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.

Use Global Settings – When enabled, the global Displacement quality settings from the V-Ray Renderer are 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 is 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.

Max SubdivionsControls 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 are 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.

Render As Subdivisions – When enabled, the object is subdivided during rendering.

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

None – UVs are always subdivided regardless of whether they are on a UV seam or not;
Internal – Only preserves UVs if they are on an internal UV seam;
All – Does not subdivide UVs on UV seams.

Classic Catmull-Clark – When enabled, V-Ray uses 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 does not work.

Advanced Options

Show advanced OptionsWhen enabled, exposes some advanced options in this tab.

Dive to Displacement Node – Press this button to dive into the Complex Material network of nodes and select the Displacement Node.




Options



Render Options

Camera Visibility – When disabled, the object is not visible to camera rays.

Reflections Visibility – When disabled, the object appears perfectly transparent to reflection rays.

Refractions Visibility – When disabled, the object appears perfectly transparent to refraction rays.

GI Visibility – When disabled, the object is considered perfectly transparent to GI rays.

Shadows Visibility – When disabled, the object is invisible to shadow rays from lights and does not cast shadows.

Shadows Receive – When disabled, the object does not receive shadows.

Show Advanced OptionsWhen enabled, exposes some advanced options in this tab.




BRDF Options

ModeSpecifies one of the following behaviors for the material:

Single-sided – The lighting on the "outer" side of the material is computed. You can use this to achieve a fake translucent effect for thin objects like paper.
Double-sided – V-Ray flips the normal for back-facing surfaces with this material.
Transparent For Camera Rays – The material is not visible to camera rays.
Transparent Except For Shadow Rays – The material is invisible to all rays except for shadow rays. This allows it to still cast shadows.
Transparent Except for Shadow/Refracted Rays – The material is invisible to all rays except for shadow and refraction rays. This allows it to cast shadows and be seen in refractions.

Filter – Specifies a color filter to tint the material.

Material Options

Double-Sided – When enabled, V-Ray flips the normals for back-facing surfaces with this material assigned. Otherwise, the lighting on the "outer" side of the material is computed always. You can use this to achieve a fake translucent effect for thin objects like paper.

Reflection On Back Side – When disabled, V-Ray calculates reflections for the front side of objects only. Checking it makes V-Ray calculate the reflections for the back sides of objects too.

Use Environment Override – Enables the use of the Environment Override color.

Environment Override – A color or texture that is used as an environment for the material.

Environment Priority – Specifies the environment override priority when several materials override it along a ray path.

Advanced Options

Show advanced OptionsWhen enabled, exposes some advanced options in this tab.

Dive to Surface Node – Press this button to dive into the Complex Material network of nodes and selects the Surface Node.




Wrapper


Enabled – Enables the Wrapper options.

Main

Generated GI Mult. – A multiplier for the amount GI generated by the material.

Received GI Mult. – A multiplier for the amount GI received by the material.

Generated Caustics Mult. – A multiplier for the amount of caustics generated by the material.

Received Caustics Mult. – A multiplier for the amount of caustics received by the material.

Subdivs Mult. – A multiplier for the subdivisions of all secondary ray tracing done for the particular surface.

Matte Properties 

Alpha Contribution – Determines the appearance of the object in the alpha channel of the rendered image. A value of 1.0 means the alpha channel is derived from the transparency of the base material. A value of 0.0 means the object does not appear in the alpha channel at all and shows the alpha of the objects behind it. A value of -1.0 means that the transparency of the base material is cut out from the alpha of the objects behind. Matte objects are typically given an alpha contribution of -1.0. Note that this option is independent of the Matte surface option (i.e. a surface can have an alpha contribution of -1.0 without being a matte surface).

Generate Render Elements – When enabled, V-Ray generates zDepth, velocity, extra tex and multi matte render element for matte objects. When this check box is disabled V-Ray does not generate any render elements for matte objects.

Matte Surface – Makes the material appear as a matte material, which shows the background, instead of the base material, when viewed directly. Note that the base material is still used for things like GI, caustics, reflections, etc.

Shadows – When enabled, makes shadow visible on the matte surface.

Affect Alpha – When enabled, makes shadows affect the alpha contribution of the matte surface. Areas in perfect shadow produce white alpha, while completely unoccluded areas produce black alpha.

Shadow Tint – An optional tint for the shadows on the matte surface.

Shadow Brightness – An optional brightness parameter for the shadows on the matte surface. A value of 0.0 makes the shadows completely invisible, while a value of 1.0 shows the full shadows.

Reflection Amount – Shows the reflections from the base material.

Refraction Amount – Shows the refractions from the base material.

GI Amount – Determines the amount of GI shadows.

Advanced Options

Dive To Wrapper Node – Press this button to dive into the Complex Material network of nodes and select the Wrapper Node.