Documentation - General

Here you can find the documentation about the general usage of the manager of SmartRefs. If you want to know more details about SmartRefs and the adventages of using this tool, please visit the Features section or the Videos & Tutorials section.

SmartRefs UI interface manager help documentation external references 3ds max plugin xrefs

SmartRefs Toolbar

SmartRefs UI interface manager Add Add New SmartRef

Launches an Open File dialog so you can select a source file for a new SmartRef in the scene. After selecting the file the reference will be loaded and ready to be modified in the master scene.

SmartRefs UI interface manager Reload Reload SmartRef

Reloads the contents of the selected SmartRefs. All the elements of the references will be updated from the source files keeping the modifications made in the master scene.

Note: The Reference system works by using the names of the nodes, materials and other elements. So in order to get good results try to always avoid duplicated names. A node will also be correctly updated if it's deleted in the source file, and a new one is created with the same name. In that case the overrides are applied into that new node.

SmartRefs UI interface manager Remove Remove SmartRef

Removes the selected SmartRefs and all of their contents from the master scene.

Note: This action can't be undone.

SmartRefs UI interface manager Reset Reset SmartRef

Resets the selected SmartRefs. That means all the modifications made to the objects of those references in the master scene are dismissed and the references are reloaded.

Note: This action can't be undone.

SmartRefs UI interface manager Duplicate Duplicate SmartRef

Duplicates the selected SmartRefs. All the modifications made in the objects of the references in the master scene will be preserved.

SmartRefs UI interface manager Merge Merge SmartRef

Merges the selected SmartRefs. That means all the objects of the references become normal objects and are not referenced anymore.

Note: This action can't be undone.


Properties

Note: Most of the properties can be changed with several references selected at the same time.

Active

This property controls whether the reference is loaded or not. Turning this off unloads the reference removing all the referenced nodes from the scene, turning it on loads the reference and its nodes back again. Changing this parameter do not remove the modifiations made to the referenced objects.

Use Name Prefix

If this property is turned on all the names of the referenced objects, materials and layers will have the name of the reference as prefix.

Name

The name of the reference. By default it's the same as the name of the file but it can be changed. This name is the one used as prefix in the objects, materials and layers names when the Use Name Prefix is turned on.

File Name

The file name and path of the reference. If this property is changed the reference will be reloaded with the new specified file.


Proxy

Use in Viewport

If this property is turned on the proxy file will be loaded instead of the main file in the viewport. This can be useful for temporarily having lighter assets in the scene.

Use in Render

If this property is turned on the proxy file will be loaded instead of the main file at render time.

Proxy File Name

The file name and path of the proxy of the reference. If this property is changed and Use in Viewport is on the reference will be reloaded with the specified file.


Advanced

Persist in Scene

If this property is turned on the reference will be persisted in the scene. That means all the data of the current loaded objects will be saved in the scene, and the references will load the next time the master scene is loaded even if the referenced file is not present. This makes the master scene bigger and slower to save.

Reload only if file has changed

If this property is turned on the reference will reload when the master scene is loaded only if the reference file has changed. This takes effect only if Persist in Scene is on.

Overlay

If this property is turned on the reference wont load when nested. That means the reference is loaded only into the master scene that references it, and it's not loaded in other scenes that reference the master file.


Options Menu

Show Duplicated Names Warnings

By default if a scene with objects with duplicated names is referenced a warning message is prompted, that message can be disabled by the user, with this option that message can be enabled back.

Register

Launches a dialog box to activate the license of SmartRefs.