FBX Morph Target Pipeline

Overview

Morph Target support in the FBX import pipeline provides an easy method for getting morph targets for skeletal meshes from 3D applications into Unreal for use in games. The pipeline allows for any number of morph targets for any number of skeletal meshes to be imported within a single file.

This page is a technical overview of using the FBX content pipeline to import morph targets into UnrealEd. See the FBX Best Practices page for more information, tips, and tricks on working with the FBX content pipeline in a development environment.

IMPORTANT: As of September 2011 the UE3 FBX import pipeline uses FBX 2012. Using a different version during export may result in incompatibilities.

Naming

When importing morph targets into UnrealEd using the FBX format, the individual morph targets will be named according to the names of the blend shapes or morphs in the 3D application.

• 3dsMax: The name will be the name of the channel in the Morpher modifier.
• Maya: The name will be the name of the blendshape added to the name of the blendshape node, i.e. [BlendShapeNode]_[BlendShape]

Setting Up Morph Targets

3dsMax

Setting up morph targets in 3dsMax to be exported to FBX requires the use of the Morpher modifier. The steps below provide a brief explanation of the steps necessary to set up a morph target for export. Refer to the help files of the application for more detailed information.

1. Start with the base mesh.
   
2. Duplicate the mesh that will be modified to create the target pose. In this case, it is the head. Create the target pose. For this example, the target pose is the character winking.
   
3. Add a Morpher modifier to the base mesh. It needs to be before the Skin modifier in the stack.
   
4. With the morph channel you want to populate selected, press the in the Morpher modifier's properties rollout or right-click on the channel and choose Pick Object From Scene.
   
5. In the viewport, click on the target mesh.
   
6. The morph channel is now populated and displays the name of the target mesh. This is the name that will be given to the morph target in UnrealEd. You can change it in the Channel Parameters section of the Morpher modifier's rollout.
   
7. Adjusting the channel's weight up to 100.0 causes the base mesh to interpolate toward the target pose.
   

Maya

Setting up morph targets in Maya to be exported to FBX requires the use of blend shapes. The steps below provide a brief explanation of the steps necessary to set up a morph target for export. Refer to the help files of the application for more detailed information.

1. Start with the base mesh.
   
2. Duplicate the mesh that will be modified to create the target pose. In this case, it is the head. Create the target pose. For this example, the target pose is the character winking.
   
3. Select the target mesh and then the base mesh in that order.
   
4. In the Create Deformers menu of the Animation menu set, select Blend Shape. The target mesh can be deleted after this step if desired.
   
5. The blend shape node is now visible in the base mesh's properties. These are the names that will be used in UnrealEd. You can change the names of the blendshape node and the blendshape here.
   
6. Adjusting the blendshape's weight up to 1.0 causes the base mesh to interpolate toward the target pose.
   

Exporting Morph Targets

3dsMax

1. Select the base mesh(es) and bones to be exported in the viewport.
   
2. In the File menu choose Export Selected (or Export All if you want to export everything in the scene regardless of selection).
   
3. Choose the location and name for the FBX file to export the morph target to and click the button.
   
4. Set the appropriate options in the FBX Export dialog. For the purposes of exporting morph targets, you must enable the Animations checkbox and all of the Deformations options.
   
5. Click the button to create the FBX file containing the morph target(s).

Maya

1. Select the base mesh(es) and joints to be exported in the viewport.
   
2. In the File menu choose Export Selection (or Export All if you want to export everything in the scene regardless of selection).
   
3. Choose the location and name for the FBX file to export the morph target to and set the appropriate options in the FBX Export dialog. For the purposes of exporting morph targets, you must enable the Animations checkbox and all of the Deformed Models options.
   
4. Click the button to create the FBX file containing the morph target(s).

Importing Morph Targets

The FBX morph target import pipeline allows for importing both a skeletal mesh and morph target all at once, or importing one or the other individually.

Skeletal Mesh with Morph Targets

1. Click the button in the Content Browser. Navigate to and select the FBX file you want to import in the file browser that opens. Note: you may want to select in the dropdown to filter out unwanted files.
   
2. Choose the appropriate settings in the Import dialog. Make sure that Import Morph Targets is enabled. Note: The name of the imported mesh will follow the default Naming Rules. See the FBX Import Dialog section for complete details of all of the settings.
   
3. Click the button to import the mesh and LODs. The resulting mesh, morph target (MorphTargetSet), material(s), and texture(s) will be displayed in the Content Browser if the process was successful. You can see the MorphTargetSet that was created to hold the morph target was named after the root bone of the skeleton by default.
   

   By viewing the imported mesh in the AnimSet Editor and selecting the newly created MorphTargetSet in the Morph tab, you can adjust the strength of the imported morph target and see that it is working as expected.

   

Individual Morph Targets

To import a morph target, you first need an MorphTargetSet to import the morph target into. This can be created through the AnimSet Editor's File menu if one does not already exist.

1. Open the MorphTargetSet you wish to import the morph target into by double-clicking it in the Content Browser or by double-clicking the skeletal mesh the MorphTargetSet is associated with and then selecting the MorphTargetSet in the Morph tab of the AnimSet Editor.
   
2. In the File menu of the AnimSet Editor, select Import MorphTarget (or one of the other morph targe import options).
   
3. Navigate to and select the FBX file containing the morph target in the file browser. Note: You may need to set the file format to to see your file.
   
4. A progress dialog displays while the morph target is being imported. Once complete, the new morph target will be dislayed in the Morph Targets list of the Morph tab.
   
   

   You can now adjust the strength of the imported morph target sequence and see that it is working as expected.