Animation blend tree editor

From Dragon Age Toolset Wiki

Jump to: navigation, search

Animation blend trees are used to group and combine animations (stored in ANI files) so that the game engine knows how to use them when they're triggered by game events.

The animation blend trees used by the single player module can be downloaded from the Single player and core resource source files project.

A new blend tree can be created via the "File → New → Animation Worksheet" menu command.

Animation worksheet editor

An animation worksheet is used to group and blend separate animations together.

The 2DA file APR_base.xls contains 3 columns for the blend trees, so unique bend trees can be assigned to a class of creatures or a unique creature.

Animation worksheet editor.png

The main window shows the various nodes that are defined in the open worksheet and how they are interconnected. There are two main kinds of nodes; animation streams and blend trees. Animation streams are the sources of animation information; each animation stream node can be associated with a single animation source file. They can also take streams from other animation stream nodes.

Blend tree nodes form the roots; these take animation information streams and blend them together into a finished product.

The properties for a blend tree are as follows:

General
Color
Looping Specifies whether this animation will be marked as looping in the exported blend tree.
Tree Name Specifies the node label in the exported blend tree. If this is left blank, a unique name will be automatically generated.

And the properties for an animation stream are:

General
Animation Animation that streams from this node.
Color
Looping Specifies whether this animation will be marked as looping in the exported blend tree.
Node Name Specifies the node label in the exported blend tree. If this is left blank, a unique name will be automatically generated.

Below the main pane is a timeline and a curve editor, much like those found in the cutscene editor. The curve editor allows you to modify the relative strengths of the blended animations.

To the right of the worksheet editor is a pane showing a creature or placeable that will allow you to preview your blend tree. You can use any pre-existing creature or placeable.

Event editor

Animation event editor.png

The event editor is used to add events to animations. Events include the following:

This allows the game to synchronize the effects of a creature's actions with the animation that the creature is playing.

The main window of the event editor consists of a large nested list of all of the animations in the game's resources. They are grouped based on a prefix.name system. For example, the animations bow.aim, bow.enter, bow.fire and bow.withdraw are all grouped under "bow" and c_chicken.p, c_chicken.wkf, and c_chicken.com_v1 are grouped under "c_chicken".

Below the main window is a timeline, somewhat similar to the cutscene editor. The scale is in frames per second and covers the duration of the animation. since the animation itself cannot be modified in the event editor the length of the timeline is fixed, though it can be scaled for easier viewing. Events are added by placing the scrubber at the frame you want to add the event on and right-clicking on it, or alternately by selecting the "Add Event" command from the Edit menu.

Animation add event.png

The type of event is determined by its ID, which starts out as "Invalid" for new events. All events can have a "String" property, and certain types of events can have additional properties set on them. The available event types and their additional properties are:

To the right of the event editor is a creature or placeable view port where you can preview animations while placing their events.

Animation list

See Article: Animation list
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox