Version
The Attenuation Editor allows you to define the distance-based attenuation properties for a particular object. By creating a series of curves to define the relationship between specific Wwise properties, such as volume and Low-Pass Filter, and the distance between the emitting source and the listener, you can simulate sophisticated distance-based attenuation for the sounds, music, and motion in your game. You can further refine your attenuation using sound cones, which simulate attenuation based on the orientation of the game object in relation to the listener.
You can create detailed and complex attenuation curves by defining the shape of each curve segment. A curve segment is any part of the curve between two control points. You can choose from a variety of curve shapes, including linear, constant, logarithmic, exponential, and s-curve.
These attenuation settings can also be saved as ShareSets, which means you can share these settings across several objects in your project.
Note | |
---|---|
The attenuation values are always added to the existing property values of the associated objects. So if you have a hierarchy of sounds or music with a cumulative volume level of -20 dB and then attenuate the volume by -64 dB, the volume of the object will be -84 dB. |
Note | |
---|---|
The graph view will also display the distance between Game Objects and Listeners. Note that only Game Objects and Listeners added to the Watches Tab of the Game Object Explorer will be displayed. |
A few of the attenuation properties can be controlled using RTPCs. For a description of the RTPC properties, switch to the RTPC Tab and click the Help icon. For more information on how to apply RTPCs, refer to Chapter 19, Working with RTPCs.
Interface Element |
Description |
|||||
---|---|---|---|---|---|---|
Name |
The name of the Attenuation ShareSet. |
|||||
Shared by |
A list of objects that currently subscribe to the selected ShareSet. |
|||||
|
Opens a search field where standard alphanumeric entries filter out unmatching elements from the view. Learn more in Using Tables. Click the Close icon to the left of the search icon to close the search field and remove the filter.
|
|||||
Reset Attenuation |
Returns the attenuation settings to their default values. This option is only available when editing a custom attenuation instance. |
|||||
Notes |
Additional information about the ShareSet or the attenuation settings that have been applied. |
|||||
Attenuation Settings | ||||||
Graph view |
A graphical representation of the relationship between specific Wwise properties, such as volume and Low-Pass Filter, and distance. The combination of all of these curves simulates the distance-based attenuation for the sounds, music, and motion objects within your game. The X axis is represented in distance units. The minimum value is 0 and the maximum value is determined by the current max distance value. The values along the Y axis will depend on which property curves are selected in the Curves list. The two default control points in the Graph view represent the values for Radius center and Max distance. The radius center cannot be deleted or moved along the X axis because it is defined by the game object (3D game-defined) or listener's position (3D User-defined) in game. You can add additional points to modify the shape of the attenuation curve. You can preview the attenuation curves by dragging the Distance cursor during playback. The graph view can display several curves simultaneously. |
|||||
|
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. |
|||||
Game Object Explorer... |
Clicking this button opens the Game Object Explorer view. |
|||||
Show Game Objects |
Enables the display of game object values in the graph view. The game objects shown will be those that are added to the watch list in the Game Object Explorer.
|
|||||
Coordinates | ||||||
X |
The coordinate along the X axis of the selected control point. The x value represents distance. If more than one control point is selected, the field displays a value of 0, so that 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 units. |
|||||
Y |
The coordinate along the Y axis of the selected control point. The values along the Y axis may be different depending on which curve is selected in the Curves list. If more than one control point is selected, the field displays a value of 0, so that 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 units. |
|||||
Curves | ||||||
|
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. |
|||||
(Pin/Unpin) |
Determines whether the attenuation curve is displayed in the graph view. When the Pin icon is selected, the attenuation curve will be displayed in the graph view whether the curve is selected or not. |
|||||
(Color block) |
Displays the color of the attenuation curve in the graph view. Each property curve is assigned a different color. |
|||||
(Link/Unlink) |
Displays whether the curve is applied across all platforms. |
|||||
Properties |
The Wwise property upon which distance attenuation is applied. You can create attenuation curves for the following Wwise properties:
These properties are displayed along the Y axis in the graph view. The Wet Volume, High-Pass Filter, and Low-Pass Filter properties have no effect on Motion FX objects. |
|||||
Curve |
Specifies which attenuation curve will be used for each property. You can chose one of the following options:
Keep in mind that each new curve you create will require additional processing power. For Motion FX objects, the Wet Volume, and Low-Pass Filter curves should be set to None, because these properties have no effect on these types of objects. |
|||||
Max distance |
The distance from the emitting source where the sound/motion reaches its lowest level. The attenuation of the object remains constant beyond the max distance. Sound and motion propagation is omni-directional, so the max distance value creates a spherical boundary around the emitting source. The max distance is represented in the Graph view by the last control point.
Default Value: 100 Wwise distance units will match the distance units that you are using in game, for example, centimeters, meters, and so on. |
|||||
Cone Attenuation |
Creates a sound cone where attenuation is controlled using a series of cones with varying angles. The direction of the cone-shaped boundaries are ultimately controlled by the orientation of the game object. The cone attenuation value is added to the distance-based attenuation values. |
|||||
Inner angle |
The angle that defines an area where no attenuation occurs. The inner angle defines the top boundary in the mini cone display. It is re-drawn in real time as the value is modified.
Default Value: 90 The area between the inner and outer angle is called the transition area. The volume attenuation within this area is linearly interpolated between zero attenuation and the max attenuation value. |
|||||
Outer angle |
The angle that defines the area where volume, Low-Pass Filter, spread and focus attenuation remain at their maximum levels. The outer angle defines the bottom boundary in the mini cone display. It is re-drawn in real time as the value is modified.
Default Value: 245 The area between the inner and outer angle is called the transition area. The volume attenuation within this area is linearly interpolated between zero attenuation and the max attenuation value. |
|||||
Max attenuation |
The amount by which the volume is attenuated when the emitting source falls outside the transition area.
Default Value: -6 Max attenuation has a link indicator and an RTPC indicator, see Working with the Property Editor for more information. |
|||||
Low-pass Filter |
A recursive filter that attenuates high frequencies based on the value specified. The units for this filter represent the percentage of low-pass filtering that has been applied, where 0 means no low-pass filtering (signal unaffected) and 100 means maximal attenuation.
Default value: 0 The low-pass filter has a link indicator and an RTPC indicator, see Working with the Property Editor for more information. |
|||||
High-pass Filter |
A recursive filter that attenuates low frequencies based on the value specified. The units for this filter represent the percentage of high-pass filtering that has been applied, where 0 means no high-pass filtering (signal unaffected) and 100 means maximal attenuation.
Default value: 0 High-pass filter is not available on the Vita Hardware platform. The high-pass filter has a link indicator and an RTPC indicator, see Working with the Property Editor for more information. |
|||||
Attenuation Preview | ||||||
|
A graphical representation of the maximum radius attenuation of a sound, where the source of the sound is located directly in the middle of the circle. This tool is not a panner so moving the red circle won't position your sound in the surround field. This tool can only be used to preview your attenuation settings. The Attenuation Preview has the following two functions:
The Attenuation Preview only works for objects that use 3D Game-defined positioning. |
Questions? Problems? Need more info? Contact us, and we can help!
Visit our Support pageRegister your project and we'll help you get started with no strings attached!
Get started with Wwise