Transmutr Help
HomeForumsDownloadSkatter Help
  • Welcome to Transmutr
  • Getting started
  • Overview
  • Tutorials
    • Quick start
    • Convert hundreds of files at once with Automations and Command-Line Interface
    • V-Ray 3dsmax to V-Ray SketchUp with materials
    • Revit to SketchUp
    • Vectorworks to SketchUp
  • FAQ
    • I have lost or didn't receive my license key
    • How can I reset my license activations?
    • Can I sell the files generated by Transmutr Artist?
    • What versions of Render Engines does Transmutr support?
    • On how many computers can I install my license?
    • I cannot activate my license due to a restrictive internet connection
    • Where can I report bugs or request features?
    • SketchUp asks if I want to "fix" my file
    • Transmutr's window is blank
    • SketchUp cannot connect to Transmutr
  • Manual
    • Loading a file
    • Preview
    • Geometry tab
      • Transformation
      • Mesh Simplification
      • Stats
      • Proxies
    • Materials tab
      • Material settings
      • Map name variants
      • Automations
    • Presets
    • Options
    • Command-Line Interface
    • Known issues
  • Release Notes
  • Roadmap
Powered by GitBook
On this page
  • General usage
  • Excluding materials from automations
  • Variables
  • Applying Automations to multiple files

Was this helpful?

  1. Manual
  2. Materials tab

Automations

PreviousMap name variantsNextPresets

Last updated 2 years ago

Was this helpful?

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 and the .

  • 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.

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".

Applying Automations to multiple files

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

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

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.

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

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

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

Save the current settings (including automations) as a preset file by clicking on

Use the to convert all your files while applying the preset settings that include the automations you created earlier.

Options
transmutr@lindale.io
Presets
Command-Line Interface
Command-Line Interface
presets
Command-Line Interface