Page History

Important Usage Limitations

There are currently two important limitations which should be heeded:

1) Material names: the following characters aren't allowed in material names: / : \ ? " < > | *

If they are present, the tool dondoesn't render the preview to disk in order to avoid file writing errors, and the library shows a missing preview file icon.

2) Incoming .mat and .max files paths and names: When the tool builds the .mat/.max file list(s) to be processed, the pathing information cannot be carried over to the library.
This means that files with different paths, but identical names are treated as another copy of the same file.
The tool can only try and overwrite (or not, as the user chooses) what is already in the Chaos Material Library root, as the full pathing information isn't transferable to the library.
When mass-processing assets, please ensure they do not share the same file name, even under a different path.

For example:

Take these two files as possible inputs:

C:\matlibs\Oaks\woodMat.mat

C:\matlibs\Redwoods\woodMat.mat

The script correctly processes the first input (collection happens alphabetically), but finds "woodMat.mat" already in the library root by the time it processes the second.
This triggers one of the three conditions for .mat files overwrite:

• Always – the .mat file in the library is overwritten with the new one, old preview files are left in the preview folder;
• Never – the new .mat file is skipped, without any rendering taking place;
• Ask – lets you choose one of the two previous options.