Versions Compared

Key

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

...

V-Ray 5 comes with its own extensive V-Ray Material Library designed to cover detailed resolution for your realistic renders. V-Ray Material Library Browser eases navigation in this library by providing high quality material previews, content filtering and quick search of the hundreds of materials available.

UI Text Box
typenote

In V-Ray 6, the V-Ray Material Library Browser is replaced by the Chaos Cosmos Browser. The legacy browser is still usable but the plan is to retire it completely. Please use the materials from the Chaos Cosmos Browser for any new projects for the transition period.

 

 

UI Expand
titleUI Path: ||V-Ray Toolbar|| > V-Ray Material Library Browser

||V-Ray Toolbar|| > V-Ray Material Library Browser


Image Added

 Image Removed

UI Text Box
typenote

If the material library has not been installed together with your V-Ray 5, this button will download it for you. Once the library is available, it serves to open the V-Ray Material Library Browser.

 

Material Library Installation

...

Section
Column
width60%

Pick a Material LibraryClick to select a single file .mat (matlib) file, Ctrl+click to scan a folder, Alt+click to recursively scan a folder and all the subfolders.

Pick a Max file – Click to select a single .max file to create a material library from it, Ctrl+click to select a folder and scan it for .max files, Alt+click to also parse all the subfolders for .max files.

Process File(s) – Processes the material library/max file.
Material libraries loaded with the Pick a Material Library button are added to the Material Browser.
Max files added with the Pick a Max file button are used to create a material library with the same name as the max file.
If both file lists are filled, the tool will process all the .mat files first, and then all the .max files.

UI Text Box
titleStopping the process
typetip

Stopping the process

The processing can be halted by standing (not tapping) on the ESC key, until the Chaos Library window pops up.
The Maxscript Listener will contain information about the process progress (f.e. which material library/material is being processed).

 

Render Resolution – Specifies the resolution for the samples. The Chaos Library's default value is 512px.

Render Quality – Specifies the quality for the samples:

Final – Renders with the Chaos Library's Default Values
Preview – Uses BF/BF and 4 subdivs for AA.

UI Text Box
typetip

Low resolution and preview quality, used in conjunction with the tool's ability to operate on many .max and .mat files at once, allows for the rapid generation of many samples.
A second pass, after reviewing the low quality ones, can then be run at the default (or higher) resolution and quality.

Copy Textures to the Library – When enabled, copies all textures to the Library's Asset folder. It also automatically re-paths all texture files.

Also convert them to tiled .TX format – When enabled, converts all textures to tiled .tx format. This is not implemented yet and the option is grayed out.

Overwrite Texture Files – Specifies whether to overwrite the texture files in the asset folder.

Overwrite Preview Files – Specifies whether to overwrite the .jpg images shown as material previews in the library.

Overwrite Matlib Files – Specifies whether to overwrite .mat files copied, or created, in the Material Library root folder.

Turn Off VFB – When enabled, turns off V-Ray VFB until the process is complete. This may help with focus stealing in some cases.

Turn Off HistoryWhen enabled, turns off V-Ray VFB History until the process is complete. This helps by not auto-saving the rendered previews in the VFB history.

Minimise MaxWhen enabled, minimises the Max window until the process is complete. This helps when setting up a low-priority background task (lowering process priority for the Max executable still needs to be done via Task Manager.).

UI Text Box
typewarning

When the Minimise Max option is enabled, note that it may be difficult or impossible to stop the process with the Esc key.

Save Current Settings as new Defaults – Saves the current settings as a new default preset.

Delete Settings and Reset – Deletes the current settings and resets them to factory defaults.
Note that the tool still remembers the last used path.
The ini file can be manually deleted from its location in "C:\Users\%USER%\AppData\Local\Autodesk\3dsMax\2022 - 64bit\ENU\plugcfg_ln\VRayMLCompanionTool.ini"

UI Text Box
typenote

If the Move Textures to the Library option is enabled, the destination .mat file will automatically be overwritten, regardless of the user choice, to ensure the repathing of textures is saved correctly.

Column
width5%
 
Column
width35%

 

Context Menus

...

Section
Column
width60%

Right-click on a thumbnail in the V-Ray Material Library Browser opens a context menu where you can control the selected material:

Expand
titleClick here for UI path of the context menu

Preview – Opens a preview of the selected asset and shows basic information.

Add to material editor – Adds the asset node in the Material Editor.

Apply to selected object(s) – Applies the asset to a selected object(s) in the scene.

Add to favorites – Adds the selected asset to the Favorites panel on the right of the V-Ray Material Library Browser.

 

 

Column
width5%

 

Column
width35%

...

Section
Column
width60%

Right-click on a thumbnail in the Favorites panel opens a context menu with the following options:

Expand
titleClick here for UI path of context menu

Preview –  Opens a preview of the selected asset and shows basic information.

Browse to – Browses to the exact location of the asset in the V-Ray Material Library.

Apply to selection(s) – Applies the asset to a selected object(s) in the scene.

Add to material editor – Adds the asset node in the Material Editor.

Remove from favorites – Removes the selected asset from the Favorites panel.

Add all to material editor – Adds all assets from the Favorites panel to the Material Editor.

Clear favorites – Empties the Favorites panel.

Column
width5%

 

Column
width35%

 

Notes

...

Fancy Bullets
typecircle
  • V-Ray Material Library Browser is not supported for 3ds Max versions earlier than 2018. The V-Ray Material Library can be used there by loading it from Material/Map Browser in 3ds Max material editor.
  • With V-Ray 5 Update 1, the V-Ray Asset Browser has been renamed V-Ray Material Library Browser.
  • User material libraries saved with newer versions of 3ds Max won't work in older host versions. For example, .mat files saved with 3ds Max 2021 and added to the V-Ray Material Library Browser will show errors in 3ds Max 2019 and won't appear in the library.
  • Note that Cosmos browser is using a built-in browser window in 3ds Max 2019 and newer, and opens an external window with previous 3ds Max versions.