Versions Compared

Key

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

This page provides information on the MDL Material.


Floatingpagetoc

Overview


Section
Column
width50%

The VRayMDLMtl material loads NVIDIA Material Definition Language files (.mdl) and renders them directly with V-Ray.

Column
width5%

 

Column
width45%

 

UI Path 


 

||Material Editor window|| > Material/Map Browser > Materials > V-Ray > VRayMDLMtl

 

Installed Material Library


The following MDL material files are included when installing V-Ray, starting with V-Ray for 3ds Max 3.5. They are located in Local Disk (C:) > Program Files > Chaos Group > V-Ray > 3dsmax 20xx for x64 > mdl

 

Section
Column
width5%

 

Column
width30%

 
Aluminum Anodized

 

Column
width30%


Architectural

 

Column
width30%


Asphalt

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%


Carbon composite

 

Column
width30%


Carpet Berber White

 

Column
width30%


Ceramic Tiles Small

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%

 
Chrome

 

Column
width30%

 
Coated Flipflop Paint

 

Column
width30%

 
Coated Flint Glass

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%

 
Colored Wax

 

Column
width30%

 
Concrete

 

Column
width30%

 
Concrete Polished

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%

 
Copper

 

Column
width30%

 
Granite Black

 

Column
width30%

 
Mahogany Floorboards

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%

 
Marble White

 

Column
width30%

 
Metal Examples

 

Column
width30%

 
Noise Flow Glossy

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%

 
Noise Perlin Glossy

 

Column
width30%

 
Noise Worley Glossy

 

Column
width30%

 
Pattern Blended

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%

 
Pattern Checker Glossy

 

Column
width30%

 
Porcelain

 

Column
width30%

 
Resin Polyurethane Matte

 

Column
width5%

 

Section
Column
width5%

 

Column
width30%

 
Rubber Studded Black

 

Column
width30%

 
Stucco

 

Column
width30%

 
Walnut Semi Gloss

 

Column
width5%

 

 

 

General


The General rollout holds parameters that control common shader characteristics.

 

 

 

mdl filename – Specifies the .mdl file. This button control also supports a context menu with the following options:

Clear – Unloads the current shader and restores the plug-in as if no shaders have been loaded. 
Open Containing Folder – Reveals the shader location in Explorer.
Open in External Editor – Opens the shader in an appropriate text editor.
Recent Files – Holds a list of the recently loaded shaders and an option to clear the history list.

mdl material – Displays the material name.

max ray depth – Specifies the maximum reflection/refraction depth for the shader.

show preview – Determines whether to render a shader preview in the material editor.

clamp shader result – Determines whether to force the result in the [0, clamping limit ] range or not.

clamping limit – Specifies the upper clamp limit if clamp shader result is enabled.

viewport color – Specifies the diffuse component of the material used in the viewport shading.

wrap texture coordinates – Automatically wraps the texture coordinates for the MDL material passing only values in the [0.0, 1.0] range.

 

Compiler Output


The Compiler Output rollout holds shader compilation and manipulation result messages.

 

 

 

Parameters


Any additional material-specific parameters (if any) are listed in this rollout. 

 

 

MDL Search Paths


The MDL Search Paths rollout hosts the system paths to available mdl modules, as well as options for manually adding and removing additional paths.

 


System paths are the ones defined with the V-Ray environment variable VRAY_MDL_PATH_3DSMAX20YY_x64 and NVIDIA environment variables MDL_SYSTEM_PATH and MDL_USER_PATH. Additional Paths are used to add root locations that will be searched when the given mdl module is not found in available system paths. Mdl modules can also reside in a sub-folder and will be automatically searched for without the need of adding the sub-folder's explicit path name. If an mdl module is loaded from a location that is not present in an already listed path, a pop-up window prompts you to add it to the list of Additional paths (or else it will not be loaded and rendered). All path lists are stored on a global level and are not scene specific.

UI Text Box
typenote

 The MDL modules are cached when loaded. If two or more mdl modules with the same name are used this may cause only the first one to be actually loaded.


MAXScript Usage


The MDL Search Paths lists can also be accessed and controlled through MAXScript.

A single VRayMDLMtl object has to be pointed to reach its properties and methods. This can be done by collecting the available VRayMDLMtls in the scene:

mdl=getclassinstances vraymdlmtl

#(Material #25:VRayMDLMtl)


And then focusing on one of them:

mdl=mdl[1]

Material #25:VRayMDLMtl


Since the MDL Search Paths lists have global effect on all VRayMDLMtl materials any of the collected materials can be used in the script.


The .searchpaths property returns an array of all MDL search paths (both System and Additional lists combined):

mdl.searchpaths

#("C:\ProgramData\NVIDIA Corporation\mdl", "C:\Users\CurrentUser\Documents\mdl", "C:\Program Files\Chaos Group\V-Ray\3dsmax 20yy for x64\mdl")




The table below lists the available methods for editing the Additional paths with MAXScript:

Method Description

mdl.addSearchPath <filename>

Adds a path to the Additional paths list.
mdl.removeSearchPath <filename>Removes a path from the Additional paths list.
mdl.clearSearchPaths()Clears all paths from the Additional paths list.


Importing NVIDIA vMaterials

In order for the MDL Material to correctly load NVIDIA vMaterials, the following two paths should be present in the MDL Search paths lists:
%PROGRAMDATA%\NVIDIA Corporation\mdl;
%USERPROFILE%\Documents\mdl

By default, on vMaterials installation they are set in the environment variables MDL_SYSTEM_PATH and MDL_USER_PATH which is the proper workflow. An alternative way to add them to the system paths is to append them to the V-Ray environment variable that specifies default location for MDL modules:

VRAY_MDL_PATH_3DSMAX20yy_x64=%PROGRAMDATA%\NVIDIA Corporation\mdl;%USERPROFILE%\Documents\mdl

where yy is the version of Max installed.

Example:

VRAY_MDL_PATH_3DSMAX2018_x64=C:\Program Files\Chaos Group\V-Ray\3dsmax 2018 for x64\mdl;%PROGRAMDATA%\NVIDIA Corporation\mdl;%USERPROFILE%\Documents\mdl

 

Importing MDL Files from Substance Designer 


In some cases, when using MDL files exported from Substance Designer, V-Ray may fail to load some modules. In order to load these modules, a folder needs to be set up before starting 3ds Max.

  1. Make a folder, for example X:\MDL, that will act as the MDL repository. Put the MDL modules that are exported from Substance Designer into this folder.
  2. Put the textures needed by the MDL materials in the same repository in their respective subfolder (for example, X:\MDL\MDL_Plywood_02).
  3. Tell V-Ray where the MDL repository is by appending it to the VRAY_MDL_PATH_3DSMAX20yy_x64 environment variable.
  4. Find the folder where Substance Designer keeps its MDL modules (usually C:\Program Files\Allegorithmic\Substance Designer 5\resources\view3d\iray but may differ from version to version) and append its path to the same environment variable. 

In the end, the environment variable should look something like:

VRAY_MDL_PATH_3DSMAX20yy_x64=C:\Program Files\Chaos Group\V-Ray\3dsmax 20yy for x64\mdl;C:\Program Files\Allegorithmic\Substance Designer 5\resources\view3d\iray;X:\MDL


References


Fancy Bullets
typecircle