Automations

You need a Studio license to use this feature. It is included in v1.1.0 and higher.

Automations are user-defined rules that allow you to automatically and instantly edit multiple materials at once.

• Very powerful when combined with presets and the Command-Line Interface.

• Useful for single models with a large number of materials.

General usage

1. To use Automations, you first need to activate them by clicking the Automations switch:
2. Then open the Automations interface by clicking on Edit Automations:
3. Finally, create a first automation by clicking on "Create an Automation".

The interface is split into two columns, Conditions and Actions. When the conditions on the left are met, the actions on the right are applied.

Conditions are grouped via two operators: AND and OR.

All the conditions in an AND group must be true for that group to be considered true. Several groups can be separated by the OR operator. In that case, at least one group must be true for the actions to be applied.

In the following example, we set the Diffuse Color to black in either of the two following cases:

1. If the material type is Metal

2. If the material type is Generic and the refraction is exactly 1 (like glass):

You can add as many automations, conditions and actions as you wish.

Excluding materials from automations

When you activate automations, you'll notice that all the materials in the list become grayed out and that you cannot edit them anymore. That's because their settings are now controlled by the automations.

If needed, you can exclude some of the materials from being affected by the automations and edit them manually. To do so, simply click on the icon next to the material name.

Variables

You can use variables in text fields (eg. material name and paths) in the form of predefined keywords wrapped in curly braces:

• {ModelName} is the name of the input file. For instance, if you load a file named "tree01.fbx", the actual value of {ModelName} is "tree01". It changes for each model, but is the same for every material.

• {MaterialName} is the name of the material. It is different for each material.

• {SourceFolder} is the path of the folder that contains the imported file. For instance, if you load "C:/library/assets/tree01.fbx", the value of {SourceFolder} is "C:/library/assets".

• {SourceFolderName} is the name of the folder that contains the imported file. For instance, if you load "C:/library/assets/tree01.fbx", the value of {SourceFolderName} is "assets".

• {SourceFolderParent} is the path of the parent of the folder that contains the imported file. For instance, if you load "C:/library/assets/tree01.fbx", the value of {SourceFolderParent} is "C:/library".

• {SourceFolderParentName} is the name of the parent of the folder that contains the imported file. For instance, if you load "C:/library/assets/tree01.fbx", the value of {SourceFolderParentName} is "library".

• {DiffuseMapPath} is the path of the diffuse map file.

• {DiffuseMapName} is the name of the diffuse map file.

• {DiffuseMapExt} is the extension of the diffuse map file.

• {BumpMapPath} is the path of the diffuse/normal map file.

• {BumpMapName} is the name of the bump/normal map file.

• {OpacityMapPath} is the path of the opacity map file.

• {OpacityMapName} is the name of the opacity map file.

• {ReflectionMapPath} is the path of the reflection map file.

• {ReflectionMapName} is the name of the reflection map file.

• {ReflectionGlossinessMapPath} is the path of the reflection glossiness map file.

• {ReflectionGlossinessMapName} is the name of the reflection glossiness map file.

• {RefractionMapPath} is the path of the refraction map file.

• {RefractionMapName} is the name of the refraction map file.

• {DisplacementMapPath} is the path of the displacement map file.

• {DisplacementMapName} is the name of the displacement map file.

• {TranslucencyMapPath} is the path of the translucency map file.

• {TranslucencyMapName} is the name of the translucency map file.

• {EmissiveColorMapPath} is the path of the emissive color map file.

• {EmissiveColorMapName} is the name of the emissive color map file.

• {EmissiveIntensityMapPath} is the path of the emissive intensity map file.

• {EmissiveIntensityMapName} is the name of the emissive intensity map file.

Example: adding a suffix to the material names

Let's say that you want to add a suffix "_palmtree" to all the materials:

1. Add the condition "Name → not empty" (which means that the automation will be applied to all the materials)

2. Add the action "Name → {MaterialName}_palmtree"

With this automation, all the material names will be modified to end with "_palmtree". For instance, a material named "trunk" will be renamed to "trunk_palmtree".

Note: by default, Transmutr prefixes all the materials with the model name. You can disable this behavior in the Options.

If you want to achieve a specific result, but don't know how to, don't hesitate to contact us at [e-mail] We'll be glad to help you!

Applying Automations to multiple files

If you have multiple files that need similar material processing, you can automate the process by combining Automations with Presets and the Command-Line Interface. This is very powerful if you have a large library of files that were created the same way.

1. Open any one of the files with Transmutr and setup your automations

2. Save the current settings (including automations) as a preset file by clicking on
3. Use the Command-Line Interface to convert all your files while applying the preset settings that include the automations you created earlier.

For example, this command converts all OBJ files in C:/models/ and applies preset.json which can contain some automations: transmutr.exe convert --preset C:/models/preset.json C:/models/*.obj