Keying groups

Whenever you set a keyframe in MotionBuilder, you set it for at least one property of a selected object. For example, if you want to animate a cube moving across the scene, you set keyframes for the cube’s translation property.

There are three ways you can choose the properties to be keyframed:

• Select each property from a list of properties.
• Select a keying group (pre-determined groups of properties) in the Key Controls.
• Select keying groups for character animation.
• Create custom keying groups that can be selected from the keying groups list in Key Controls.

Selecting individual properties

You can select any property in the Properties window, the FCurves window, and the Dopesheet window. These windows list all properties of selected objects, such as common properties (translation, rotation, and scaling) and object-specific properties (a Light’s color or cone angle). See Property list.

Selecting keying groups in the Key Controls

Instead of selecting and deselecting frequently used properties one by one, you can select keying groups in the Key Control’s Keying Group menu.

Keying groups are pre-determined groups of properties. Selecting a keying group selects specific properties. For example, if you select TRS in the Keying Group menu, keyframes are set for translation, rotation, and scaling properties for the selected object. If you then select the T keying mode, keyframes are set only for the translation property, but not for rotation or scaling.

You can add individual properties to a keying group selection. For example, if TR is the keying group selected in the Key Controls, you can select additional properties in the Properties window. You can also create custom keying groups for objects and characters that let you choose what properties you want to key on. See Selecting keying groups for objects or Creating a custom keying group.

Selecting keying groups for characters

Keyframing a character’s Control rig involves selecting many effectors and their properties. The Manipulation and keying mode buttons on the Character Controls toolbar lets you do all of following at the same time:

• Select all effectors or the group of effectors you want to animate.
• Select a pre-determined group of properties for animating effectors.
• Affect effector manipulation, to control effector movement.

For more information, see Manipulation and keying modes.

Selecting keying groups for objects

Select keying groups to choose the properties you keyframe.

1. Select an object in the scene, such as a light.
2. In the Key Controls window, select a keying group in the Keying Group menu, such as TR to select translation and rotation properties.

   When you set a keyframe, only the properties in the keying group are selected. If TR is the current keying group, only translation and rotation can be animated.

   Note: Properties that are selected as part of the current keying group display light blue in the Properties, FCurves, and Dopesheet windows.
3. You can add to the keying group selection by clicking additional properties in the Properties window.

   For example, you can select a light’s Color property. When TR is the current keying group and the Color property is also selected, you set keyframes for the light’s translation, rotation, and color.

See Keying Mode menu for more information on the different keying groups, and see Creating a custom keying group for more information about how to create a custom keying group for objects or characters.

Creating a custom keying group

You can control an object’s animation with keying groups [also called keying modes], and MotionBuilder lets you create custom keying groups for objects. Keying groups contain information about which properties will be captured when you create keyframes.

With any custom keying group, you can also edit relationships between the keying group’s properties and an object pose using the Connection Editor.

The types of custom keying groups that can be created are:

• “local” objects—the keying group will only belong to the object or objects selected at the time the keying group is created)
• “object types”—these keying groups can be assigned for objects of the same type which will usually contain the same properties information
• “global”—these keying group can be associated with any object in a scene, but only corresponding properties will be applied

Note: MotionBuilder needs to have an object selected as a reference to know what Object Type keying group you want to create. If no object is selected (and there is nothing in the source column) when you create a keying group of Object Type, the keying group created is “Global” instead.

To create a custom keying group:

1. Do one of the following:
   • Select one or more objects in a scene.
   • If you have an object’s property view open, select one or more properties from it.
2. Select Window > Add Property Editor.
3. Select the Keying Groups tab.
   • If you have selected properties from another object’s property view, drop them in the source column of the Keying Groups tab
4. Click the right arrow next to the views menu, and select Create Keying Group as...
5. Choose which type of keying group you want to create (either local, object type or global).
   Note: To create an Object Type keying group, you need to select an object as a reference for MotionBuilder to know what type to create. If no object is selected (and there is nothing in the source column) when you create a keying group of Object Type, the custom keying group will be “Global” instead.
6. Select the properties you want to include from the Source column and either drag them or click >> [Assign] to add them to the keying group.
7. Close the Property Editor when you are finished adding properties to the keying group.

Tip: From the Property View you can click the Editor button to open the Property Editor. The Property Editor will open on the tab you used last, and when you access the Keying Groups tab, it will automatically display the properties of any object(s) that you currently have selected in the Source column.

See Loading custom local keying group data for more information about how to apply a custom local keying group to many characters in a scene.