Documentation



Menu

Using MDL

Adding Custom MDL search paths

To use MDL within Iray for 3ds Max, you must specify the location on disk where the MDL is stored in Render Setup > Settings > Custom MDL for MDL import to work. This is also true if the MDL you are importing is based on other supporting MDL files (i.e. it includes other MDL files), in this case the path to the supporting MDL will also need to specified in the Custom MDL section.

Adding MDL search paths to Iray
  1. Open Render Setup > Settings and scroll to the Custom MDL section
  2. Select the Add button and navigate to the folder containing the required MDL.
  3. Click OK and it will be added.
✱  Note: If your MDL does not reference full paths (including subfolders) then you should add those subfolders to the Custom MDL search paths.

Importing MDL

Adding Layers & Import/Export of MDL in the material editor

Iray for 3ds Max maintains compatibility with other MDL enabled applications.

To import MDL into 3ds Max:

  1. Open the 3ds Max Material Editor
  2. Add an Iray+ Material from Materials > Iray+ in the Material/Map Browser
  3. With the Iray+ Material selected, Choose MDL I/O > Import... from the Material Detail panel
  4. Navigate to your MDL file in the file browser and click Open.

The imported file will expose any supported parameters included in the MDL and you will be able to edit any enabled parameters. The file path that you are importing the MDL from will need to be specified in Custom MDL for importing to function correctly.

An Imported MDL
✱  Note: Reimporting MDL into Iray for 3ds Max that you have previously exported from the plug-in may result in limited editing ability.
If you want to save your materials to re-use in Iray for 3ds Max, save them in Material Libraries.

Supported Parameters for Editing

Imported MDL materials maintain their appearance but not all parameters can be edited once imported. The following categories of MDL parameters are all editable once imported: 

color
float3
float2
float
bool
int
::df::scatter_mode
::intensity_mode
texture_2d
texture_3d
texture_cube
texture_ptex
light_profile

Exporting MDL

Exporting MDL is a similar process:

  1. Open the 3ds Max Material Editor
  2. Choose the material you want to export to MDL
  3. With the Material selected, Choose MDL I/O > Export... from the Material Detail panel
  4. Choose a location and name your MDL file in the file browser and click Save.
✱  Note: When exporting an MDL material, the filename must conform to the MDL syntax. It must begin with an alphabetic ASCII character [a-z, A-Z] and then can only consist of alphabetic, numeric [0-9] or the underscore [_] characters. The filename also cannot be any of the reserved words of MDL itself. See NVIDIAs Material Definition Language (MDL) Handbook for further details.

Resources


For more information on MDL, see NVIDIAs Material Definition Language (MDL) Handbook.
▲

Page Last Edited: