Skip to main content

Modify material mappings for Trimble Visualizer

Modified: 12 Jun 2026 Tekla Structures 2025
2025
Tekla Structures

By default, Trimble Visualizer attempts to map the materials used in Tekla Structures to the material types used in the Trimble Visualizer material catalog. You can also set material type mappings manually to define how you want materials to look in Trimble Visualizer. If necessary, you can override the materials of particular model objects, and use another material instead.

Pre-defined materials and their color and transparency information are read from the materials_ifc.xml file saved in the ..\TeklaStructures\<version>\bin\applications\Tekla\Tools\TrimbleConnectVisualizer folder.

In Trimble Visualizer, you can currently only render the material type of objects, not their material finish. This means that paints or other finishes are not visible in Trimble Visualizer.

To set the material type mappings used in Trimble Visualizer:

  1. On the View tab, click Visualize and select Visualizer material type mapping.
  2. In the lists on the right side of the related Tekla Structures materials, select the Trimble Visualizer material types that you want to map to.

    Selecting the blank option renders the color of the Tekla Structures class as a material that is similar to plastic. The blank option can be useful if you need to show the class colors to communicate an aspect of the structural design.

  3. To override the Tekla Structures material of particular model objects in Trimble Visualizer:
    1. In the model, select the objects.
    2. In the Override Visualizer materials of selected objects list, select the material that you want to use for visualizing the selected objects.
    3. Click Set.
  4. Click OK to update the material type mapping.
  5. To save the material type mapping as an XML file, do either of the following:

    To

    Do this

    Save the material mapping to the model folder

    • When Tekla Structures asks you if you want to save the material mapping to the model, click Yes.

    The material type mapping is saved in the model folder under the \attributes folder. The file name is VisualizerMaterials.tcv11.

    The material type mapping is saved for all users of the model, including the users that edit the model using Tekla Model Sharing or the multi-user mode.

    To avoid issues, do not modify the colors in the VisualizerMaterials.tcv11 file manually.

    Save the material mapping to local application data

    • When Tekla Structures asks you if you want to save the material mapping to the model, click No.

    The material type mapping is saved in the \Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\TrimbleConnectVisualizer folder. The file name is VisualizerMaterials.tcv11.

    The material type mapping now applies to all projects that you are working on.

    To avoid issues, do not modify the colors in the VisualizerMaterials.tcv11 file manually.

Submit

Table of Contents