Version
menu_open

Position Editor (3D Automation)

The Position Editor (3D Automation) allows you to define the spatial positioning of your object in a surround environment using animation paths. You can create many different versions of a path and then animate your object along these paths. You can also define how the different paths will be played back. The paths you create will override the position and orientation of both the game object and listener in game.

3D automation positioning can be used in many different situations, such as game interfaces, menus, non-localized ambient sounds, and voices.

Interface Element

Description

Name

The name of the Wwise object to which the propagation behaviors will be applied.

Notes

Additional information about the object or propagation behaviors that have been applied.

Paths

Creates a new animation path in the list.

Deletes the selected animation path from the list.

Click the Configure Columns... shortcut (right-click) option from the column header band.

The Configure Columns Dialog opens. Specify which columns to display and their order.

Path Name

The name of the animation path.

Duration

The duration of the animation path.

Random Range

Horizontal

Randomizes the horizontal position of a path each time it is played. This value acts as a +/- offset to the X and Y coordinate values of each point, creating a range of possible values. At runtime, Wwise picks a random value from within these ranges to specify the horizontal position of the control point.

Default value: 0
Range: 0 to 100
Units: Percentage of max distance value

Vertical

Randomizes the vertical position of your path each time it is played. This value acts as a +/- offset to the Z coordinate value of each point, creating a range of possible values. At runtime, Wwise picks a random value from within this range to specify the vertical position of the control point.

Default value: 0
Range: 0 to 100
Units: Percentage of max distance value

The default vertical position (Z value) of each point along your path is 0.

Play Type

Sequence

Plays the animation paths in a sequential order from the start of the list to the end. When the last path is played, it returns to the beginning of the list.

Random

Plays the animation paths in a random order until all paths have been played.

Play Mode

Continuous

Plays the animation paths one after the other until all paths have been played.

Step

Plays a single animation path from the list.

Use new path for each sound

Forces a new path to be used each time a new sound is played regardless of whether the sound is triggered by a play event.

When selected, this option allows you to use a different path for each sound played within a continuous container. If this option is not selected, each sound within a continuous container will use the same path.

This option is only available when the play mode of the animation paths is set to Step.

Default value: false

Loop

Determines whether the animation paths will be played indefinitely. When selected, the entire path list is played indefinitely. When unselected, the entire path list is played only once.

This option is only available when the Continuous option is selected.

Transition time

Determines the amount of time that passes between the end of one path and the start of another.

This option is only available when the Continuous option is selected.

Default value: 1

 

Graph view

A visual 2D representation of the position of the control points within a horizontal 3D sound or motion field. The graph view displays animation paths and allows you to simulate 3D attenuation along a horizontal axis by creating radius and cone-shaped boundaries.

Zooms in towards the center of the graph view.

Resets the graph view to the default zoom factor ratio of 1:1.

Zooms out from the center of the graph view.

Pan Left-Right (3D)

The coordinate along the X axis of the currently selected control point. The X coordinate is measured as a percentage of the attenuation max distance; therefore, the value will always fall between 0 and +/- 100, regardless of the actual distance value (which could even be 0).

If more than one control point is selected, the field displays a value of 0. This way, you can increase or decrease the value of all selected control points relative to their current values. For example, if you select two control points and type -5 in the X text box, both control points will move to the left by 5 percentage units.

Default value: 0
Range: -100 to 100

Pan Front-Rear (3D)

The coordinate along the Y axis of the currently selected control point. The Y coordinate is measured as a percentage of the attenuation max distance; therefore, the value will always fall between 0 and +/- 100, regardless of the actual distance value (which could even be 0).

If more than one control point is selected, the field displays a value of 0. This way, you can increase or decrease the value of all selected control points relative to their current values. For example, if you select two control points and type -5 in the Y text box, both control points will move down by 5 percentage units.

Default value: 35
Range: -100 to 100

Pan Up-Down (3D)

The coordinate along the Z axis of the currently selected control point. The Z coordinate is measured as a percentage of the attenuation max distance; therefore, the value will always fall between 0 and +/- 100, regardless of the actual distance value (which could even be 0).

If more than one control point is selected, the field displays a value of 0. This way, you can increase or decrease the value of all selected control points relative to their current values. For example, if you select two control points and type -5 in the Z text box, both control points will move down by 5 percentage units.

Default value: 0
Range: -100 to 100

From center

The actual distance in Wwise units between the selected control point and the center of the radius.

This field is read-only and is only enabled when the Radius option is selected.

Display Options

Show Radius

Displays a representation of the attenuation max distance radius in the graph view. The radius is shown as a percentage of the max distance value.

This option is not available if you aren't using any attenuation.

Show Cone

Displays a representation of the sound cone angles (inner and outer) in the graph view.

This option is not available if you aren't using cone-based attenuation.

 

(Timeline)

A visual representation of the control points seen as a measure of time. The timeline displays time using the mm:ss:ms time format.

The first control point key on the timeline cannot be deleted.

Zooms in towards the center of the timeline by a factor of 50%.

Resets the timeline to the default zoom factor ratio of 1:1.

Zooms out from the center of the timeline.

The timeline can only be zoomed out to the length of the timeline.

Linear mode

Determines if control points are evenly spaced along the timeline.

If selected, control points will always be spaced evenly along the timeline producing a constant motion from key frame to key frame. If unselected, control points can be placed anywhere on the timeline, which can create the effect of speeding up or slowing down between key frames.

Key

Displays the current time of the selected control point.

This option is read-only in Linear mode.

Opens the Timeline Configuration dialog box where you can define certain properties and behaviors of the Position Editor timeline.


Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise