Assembly representations

Assembly representations are substitute data for a production asset that you can swap in and out of a scene depending on the requirements of your current task.

You can quickly substitute the most appropriate version of the production asset as you work on shot sequences, scene layouts, or any other work you need to accomplish with the scene. For example, when laying out a scene with an elaborate table setting, you can use simple locators or cached objects to represent the plates, cutlery, and other tableware, and notice immediate performance improvements as you work.

There are three representation types: Locator, Cache, and Scene. Each production asset can have multiple representations of each type. Only one representation of the asset can be active at once. (See also Switching active representations.)

Tip: You can also convert objects to bounding boxes and use them as assembly representations. See Use a bounding box as a representation.
The active representation state is saved with the scene. When the scene is re-opened, the last active representation is automatically loaded.
Important: Do not use namespaces in representation files.

Locator representations

Locator representations are standard Maya locator objects, marking a point in space. Locator representations are the default representation type and display at the pivot-point of the production asset when active.

Cache representations

Cache representations are Alembic-based cached versions of the production asset, such as a Maya GPU-cached object. Cache representations are intended to be non-editable and fast-loading versions. An object must be saved to an Alembic cache before it can be added as a Cache representation.

For more information about Alembic-based caches, see Alembic Caching and Cache menu.

Scene representations

Scene representations are .ma or .mb scene files containing fully renderable geometry of the production asset. When Scene representations are active, the object's hierarchy displays in the Outliner.

Note: You can create custom assembly representations using the Maya Scene Assembly API. For more information, see the MFnAssembly class in the Maya Developer Help.

Related topics