Documentation

​
​

Development

User Acquisition

Monetization

Industry

Asset Transformer Studio

2026.5.0

Supported
​

User Manual

Python API

Changelog

Asset Transformer Studio

2026.5.0

Supported
​

​
​
Get started
  • About Asset Transformer Studio
  • Getting started
  • Additional Resources
User Interface
  • Overview
  • Menu Bar
  • Toolbars
  • Window
  • Customizing the User Interface
Data Preparation Fundamentals
  • Overview
  • General Information
    • About Asset Transformer Studio and Selections
  • Typical Data Preparation Workflow
  • About 3D Models Types
  • About the Product Structure (Tree)
  • About Occurrences
  • About Instances & Prototypes
  • About Face and Vertex Normals
  • About UVs
  • About Tessellation
  • About Decimation
  • About Animation
  • Glossary
Working With Asset Transformer Studio
  • Overview
  • Videos and Tutorials
  • Supported File Formats
  • Importing Files
  • Exporting Files
  • Scripting With the Python API
  • Interrupting a Process
  • Plugins
  • Errors in Asset Transformer Studio
Python API Reference
  • Overview
Changelog
  • Changelog
  1. Asset Transformer Studio
  2. Data Preparation Fundamentals
  3. General Information

About Asset Transformer Studio and Selections

How selections work when running functions in Asset Transformer Studio
Read time 2 minutes
Last updated 12 hours ago

In Asset Transformer Studio, if a selection is empty when opening a function that requires a list of occurrences to be processed, the whole scene will be processed.
A message warns about that behavior, before opening the function's dialog:
Root warning message
Also, in the functions' dialog box, the
Root
occurrence is displayed in orange and comes with a tooltip reminding the user of this specific behavior:
Root message in dialog

Advanced explanation

To process a 3D model present in the scene with a function (like Tessellate, Repair Meshes, Decimate…), the user generally selects "manually" the occurrences to process using the Viewer or the Product Structure.
In Asset Transformer Studio, if nothing is selected when running a function requiring a list of occurrences as input, the
Root
node is automatically selected
. Which means all occurrences of the scene will be processed, whether they are visible or not (the full hierarchy is parsed).
This behavior can be very handy, for example when the user wants to tessellate or retessellate all the parts of the scene.
But it can also have unexpected impacts. For example:
  • When executing a Decimate To Target on the whole scene, hidden parts will also be decimated and counted in the triangle target
  • When doing a
    Select All
    , all parts of the scene will be selected, including hidden ones
CONCLUSION: The user should be careful with their selection when running a function!

Modifying the selection

To modify a selection once a function's dialog box is open, either:
  • Use the
    Select
    button to modify the selection
  • Close the dialog box, modify the selection and open the dialog box again

Disable warning in dialogs

The warning message displayed when the
Root
node is selected can be disabled:
  • Use the "Do not show again" checkbox to prevent the warning from opening every time.
  • Go to Preferences (F9) >
    Dialogs
    and enable the parameter
    HideRootWarningDialog

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Advanced explanation

    • Modifying the selection

    • Disable warning in dialogs