Animation blend tree editor - Revision history

Sunjammer: Splitting

2014-05-08T17:57:05Z

Splitting

Eshme at 21:56, 26 January 2010

2010-01-26T21:56:17Z

BryanDerksen: Not my area of expertise by a long shot, but adding a link to source files to maybe help others work with this, and also a pointer for how to open a new blend tree editor

2010-01-25T18:38:29Z

Not my area of expertise by a long shot, but adding a link to source files to maybe help others work with this, and also a pointer for how to open a new blend tree editor

BryanDerksen at 20:34, 2 July 2009

2009-07-02T20:34:31Z

BryanDerksen: /* Event editor */ shrink a giant image

2009-07-02T20:33:46Z

‎Event editor: shrink a giant image

BryanDerksen: Category:Animations

2009-07-02T12:05:04Z

Category:Animations

BryanDerksen: imported from extranet

2009-06-27T20:34:06Z

imported from extranet

New page

== 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.

[[Image: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:

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

And the properties for an animation stream are:

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

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 ==

[[Image:Animation event editor.png]]

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

*The triggering of sounds such as footfalls or weapon impacts
*The firing of projectiles
*Triggering VFX
*Drawing or sheathing a weapon

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.

[[Image: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:

*Invalid - does nothing.
*Attack Impact
**Hand or foot - can be "right" or "left"
*Attack Impact Reaction
**Hand or foot - can be "right" or "left"
*Equip Right
*Equip Left
*Unequip Right
*Unequip Left
*Ability Cast Impact
**Hand or foot - can be "right" or "left"
**PlayHitSound - True or false
*VFX Start
*Projectile Load
*Projectile Fire
*Blend Start
*Blend End
*Animation Done
*Foot Down
**Hand or foot - can be "right" or "left"
*Detonate Emitter
*Movement sound
**Movement scale - can be Unknown, Small, or Medium
*Bodyfall
*Weapon swish
**Hand or foot - can be "right" or "left"
*Play Custom Sound
**Sound - an [[FSE]] file
*Weapon Blocked
**Hand or foot - can be "right" or "left"
*Lock Movement
*Unlock Movement
*Set Next Transition
*Set Animation Offset
*Play placeable sound
**Animation ID - can be set to ClosedToOpened, Destroyed, Hit, Locked, OpenToClosed, or Used (these are defined in the <tt>sound_plc_column_names</tt> 2DA, in the [[placeables.xls]] file)
*Deathblow Decapitation
**Sound - an [[FSE]] file
*Deathblow Decapitation VFX
*Deathblow Damage Impact
*Deathblow Attack Merge
*Deathblow Death Merge
*Game Speed
*Attach Point
*Fly Start
*Fly End
*Attach Point (with Rotation)
*VFX Instant

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

BryanDerksen at 15:35, 27 June 2009

2009-06-27T15:35:01Z

← Older revision		Revision as of 21:56, 26 January 2010
Line 110:		Line 110:

	To the right of the event editor is a creature or placeable view port where you can preview animations while placing their events.		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]]''

	[[Category:Animations]]		[[Category:Animations]]

← Older revision		Revision as of 18:38, 25 January 2010
Line 1:		Line 1:
		+	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 [http://social.bioware.com/project/1331/#files 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 ==		== Animation worksheet editor ==

← Older revision		Revision as of 12:05, 2 July 2009
(One intermediate revision by the same user not shown)
Line 105:		Line 105:

	To the right of the event editor is a creature or placeable view port where you can preview animations while placing their events.		To the right of the event editor is a creature or placeable view port where you can preview animations while placing their events.
		+
		+	[[Category:Animations]]

@@ Line 39: / Line 39: @@
 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 ==
+== See also ==
-[[Image:Animation event editor.png|thumb|300px]]
+* [[Animation list]]
+* [[Event editor]]
-The event editor is used to add events to animations. Events include the following:
-−
-*The triggering of sounds such as footfalls or weapon impacts
-*The firing of projectiles
-*Triggering VFX
-*Drawing or sheathing a weapon
-−
-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.
-−
-[[Image: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:
-−
-*Invalid - does nothing.
-*Attack Impact
-**Hand or foot - can be "right" or "left"
-*Attack Impact Reaction
-**Hand or foot - can be "right" or "left"
-*Equip Right
-*Equip Left
-*Unequip Right
-*Unequip Left
-*Ability Cast Impact
-**Hand or foot - can be "right" or "left"
-**PlayHitSound - True or false
-*VFX Start
-*Projectile Load
-*Projectile Fire
-*Blend Start
-*Blend End
-*Animation Done
-*Foot Down
-**Hand or foot - can be "right" or "left"
-*Detonate Emitter
-*Movement sound
-**Movement scale - can be Unknown, Small, or Medium
-*Bodyfall
-*Weapon swish
-**Hand or foot - can be "right" or "left"
-*Play Custom Sound
-**Sound - an [[FSE]] file
-*Weapon Blocked
-**Hand or foot - can be "right" or "left"
-*Lock Movement
-*Unlock Movement
-*Set Next Transition
-*Set Animation Offset
-*Play placeable sound
-**Animation ID - can be set to ClosedToOpened, Destroyed, Hit, Locked, OpenToClosed, or Used (these are defined in the <tt>sound_plc_column_names</tt> 2DA, in the [[placeables.xls]] file)
-*Deathblow Decapitation
-**Sound - an [[FSE]] file
-*Deathblow Decapitation VFX
-*Deathblow Damage Impact
-*Deathblow Attack Merge
-*Deathblow Death Merge
-*Game Speed
-*Attach Point
-*Fly Start
-*Fly End
-*Attach Point (with Rotation)
-*VFX Instant
-−
-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]]''
 [[Category:Animations]]

@@ Line 5: / Line 5: @@
 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.
-[[Image:Animation worksheet editor.png]]
+[[Image:Animation worksheet editor.png|thumb|300px]]
 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.

@@ Line 14: / Line 14: @@
 {{inspector start}}
-{{inspector group|General}}
+{{inspector section|General}}
 {{inspector row|Color|}}
 {{inspector row|Looping|Specifies whether this animation will be marked as looping in the exported blend tree.}}
@@ Line 23: / Line 23: @@
 {{inspector start}}
-{{inspector group|General}}
+{{inspector section|General}}
 {{inspector row|Animation|Animation that streams from this node.}}
 {{inspector row|Color| }}