Motion Clip

A Motion Clip is a node containing a motion file (.gmo/.fbx/.usd/.bvh) which can be played in a Motion Behavior or a Locomotion Behavior. The Motion Clip provides information about the contained motion file (duration, framerate, velocity...) and tools to edit it in a non-destructive way.

Creation

  • CrowdMenu: Crowd Behaviors / Motion Clip Nodes
  • MEL command: glmMotionClipCmd;

Notice that most of the time it is useless to create a Motion Clip manually as both the Motion Behavior and the Locomotion Behavior provide an interface to handle Motion Clips.

Preview

A Motion Clip can be previewed in the Motion Clip Preview tool.

Configuration

Motion File Attributes

Motion Clip Id Unique id of the Motion Clip
Motion File Motion file (.gmo/.fbx/.usd/.bvh) to play and/or edit
Selection Mode For files that can contain several animations (.fbx/.usd), this parameter tell whether the file contains a single animation with several herarchies, or several animations
Motion Take For files containing several animations, this indicate the take to use
Support Property Name Property name storing the support phase for each leg (should be >0.5 when on support, <0.5 when on fly).
If a Motion SkeletonMapping is selected, the property from the skeleton mapping is used instead of this one.
Motion SkeletonMapping

Link to the Skeleton Mapping to use for this animation.
You can select an existing one, or click on the "+" to create and select a new one.
If none is selected, Golaem will try to automatically determine the motion skeleton mapping.

Notice that the following attributes are not editable and filled only when a motion file is loaded:

Number Of Frames Number of frames of the motion file
Frame Rate Framerate of the motion file. Thus, Motion Duration equals Number Of Frames * 1 / FrameRate
Translation Total root translation (difference of position between the first posture and the last posture) of the motion file
Translation Velocity Velocity of the motion (equals to Root Translation / Motion Duration)
Rotation Total root heading rotation (difference of orientation between the first posture and the last posture) of the motion file
Rotation Velocity Rotation velocity of the motion (equals to Root Rotation / Motion Duration)
Heading Direction Direction in which the motion is heading (most of the time it corresponds to the motion Velocity except for motions like strafes)
Footprint Per Limbs For each Limb Node of the Skeleton of the Motion File, specify how many footprints have been computed.
Preview Preview the Motion Clip in the Motion Clip Preview

Edit Attributes

Force Flat Ground This attribute tells Golaem that the animation was done on a flat ground, and allows the engine to do some optimizations knowing that. Disable this for animations that are going up or down (like climbing stairs, ...)
Crop Motion If checked, the following attributes will be applied to the loaded motion
Crop Start Motion First frame of the crop interval
Crop Stop Motion Last frame of the crop interval
Edit Motion If checked, the following attributes will be applied to the loaded motion
Edit Frame Rate New frame rate of the motion file
Edit Translation New total root translation (difference of position between the first posture and the last posture) of the motion file
Edit Rotation New total root heading rotation (difference of orientation between the first posture and the last posture) of the motion file
Edit Heading Direction New heading direction of the motion file
Notice that the attributes above are non-destructive (ie they do not alter the original motion file).
The Edit Attributes are connected to the original values by default. To edit an attribute, first right click on it and choose Break Connection.

Locomotion Attributes

Locomotion Channel Define an id in order to regroup several Motion Clips under the same Locomotion Channel. This attribute defines a panel of motions with the same properties (linear velocity and angular velocity), the Locomotion Behavior will pick a random motion in this set. -1 is the default value which means the Motion Clip does not belong to any set yet.

Miscellaneous Attributes

Auto Rename If checked, the Motion Clip node will be automatically renamed with the name of the motion file, each time it is changed