Modeling and Styling	Parametric Effects	Animation	Rendering	Import/Export
Edit Guides _Modifier	Surface Comb _Modifier	MassFX Dynamics _Modifier	MentalRay _Object	Alembic Export _Exporter
Ground Strands _Modifier	Curling _Modifier	Strand Multiplier _Modifier	Strand Animation _Modifier	Ornatrix Hair _Exporter
Guides from Surface _Modifier	Frizz _Modifier		Fast Ray Tracer _Atmospheric	Shading and Materials
Guides from Mesh _Object	Hair Clustering _Modifier		Accurate Ray Tracer _Atmospheric	MR Hair _{MR Shader}
Guides from Shape _Modifier	Guide Clustering _Modifier		Hair Draw _Effect	Hair Texture _{2d Map}
Hair from Guides _Modifier	Propagation _Modifier		Render Settings _Modifier	Cheap Shader _Shader
Baked Guides _Object	Gravity _Modifier		Shadow Maps _Shadow	Expensive Shader _Shader
Baked Hair _Object	Length _Modifier		Raytraced Shadows _Shadows	Translucent Shader _Shader
Hair Presets _Object	Detail _Modifier		Deep Shadow Maps _Shadow
Hair Preset Maker _Object	Symmetry _Modifier		VRay _Modifier
Guides from Guide Mesh _Modifier
Guides on Spline _Modifier
Hair Shells _Modifier
Mesh from Strands _Modifier
Hair from Mesh Strips _Object

Working with Xref Assets

Working with Xref Assets

Overview

Xref objects in 3dsmax provide a flexible way of referencing external scenes within other scenes. This allows for creation of 3dsmax scenes which act as assets that can be included into other production scenes and updated separately by multiple departments.

Ornatrix provides a workflow to use Xref scenes containing hair assets inside other scenes with the ability of separating the distribution surface of the hair from the Xref scene. This means that only the hair groom itself can be Xref'ed, while the object to which it applies can be located inside another scene.

Applying Xref grooms

Working with Xref hair assets

First step to using this workflow is to create a scene where you save some hair placed onto an object. This hair can be a modifier stack starting with your base mesh, followed by the Guides from Surface modifier, or a Guides from Surface object which references some object within the scene. On top of this modifier/object you can have any normal Ornatrix hair stack. The scene needs to be saved as a *.max file.

Then, inside another scene, you need to use the Reference->Xref Objects menu and select the other .max file containing your hair asset.

The Xref hair asset will be placed inside your scene. At this point the base object will be brought in along with the Xref'ed object and there is no way of changing its distribution surface to be one of the objects inside the current scene using default 3dsmax UI.

There are two ways to change the distribution surface of the Xref'ed hair object to an object within the scene:

Recommeneded way: Select the Xref hair object and use the MaxScript listener to execute the following command:
```
OxOverrideDistributionSurface $ $DistributionMeshObject
```
DistributionMeshObject is the name of the node which you want to assign as the distribution mesh.
Another way to do this is to right click on the Xref object, select Properties, and then in User Defined tab add the following text:
```
OxSurfaceOverride = $DistributionMeshObject
```
After doing this you need to save and reload the scene.

Once you set the distribution object override it will be automatically applied to the Xref objects and persist after you reopen the scene. To remove this override simply clear the OxSurfaceOverride user property from the scene node and reload the scene.

What happens internally

To perform the distribution surface override Ornatrix goes through all of the Xref nodes within the scene and finds the ones that contain Ornatrix modifiers and objects. It then manually replaces the base objects within an Ornatrix modifier stack, or set the distribution surface in Ornatrix object if it is used as the base object. This step is performed right after a scene is loaded and after OxOverrideDistributionSurface MaxScript command is executed. Therefore, the functionality outlined in this document will not happen if Ornatrix plugin is absent from 3dsmax installation.

OxSurfaceOverride user property is assigned to the target node to which the distribution object will be assigned. The value of this property needs to be a MaxScript string which will evaluate the object within the scene at runtime. For example, this is also a valid way of setting this property:

OxSurfaceOverride = maxOps.getNodeByHandle 5

MaxScript reference

The following MaxScript function sets and clears the distribution surface override:

OxOverrideDistributionSurface [targetNode] [distributionNode]

Missing Something? Let us know if this page needs more information about the topic.