Version
The Attenuation Editor allows you to define the 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 specific drivers, such as distance or obstruction between the emitting source and the listener, you can simulate sophisticated 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 emitter 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. |
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 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.
| ||||
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 different drivers, such as distance and obstruction. The combination of all of these curves simulates the attenuation for the sounds, music, and motion objects within your game based on distance, obstruction, occlusion, diffraction, and transmission. For distance-driven curves, 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. For curves driven by obstruction, occlusion, diffraction, and transmission, the X axis is a percentage. 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 Automation) in game. You can add additional points to modify the shape of the attenuation curve. You can preview the effect of attenuation curves by dragging the Distance, Obstruction, Occlusion, Diffraction, and Transmission cursors 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. | ||||
Coordinates | ||||
X |
The coordinate along the X axis of the selected control point. The values along the X axis may vary 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 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. | ||||
(Pinned/Unpinned) |
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. | |||
Driver |
The phenomena driving the attenuation. You can create attenuation curves for the following drivers:
The drivers are displayed along the X axis in the graph view.
| |||
Property |
The Wwise property upon which 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.
| |||
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. | |||
Max distance |
The distance from the emitting source at which the object's signal reaches its lowest level. Used only for distance-driven curves, this distance is represented in the Graph view by the last control point. The attenuation of the object's signal remains constant beyond this point. Sound and motion propagation is omni-directional, so the max distance value creates a spherical boundary around the emitting source.
Default Value: 100 Wwise distance units will match the distance units that you are using in game, for example, centimeters, meters, and so on. | |||
Height Spread |
Height Spread automatically computes a minimal spread based on elevation, if and only if panning occurs on a planar configuration, or based on negative elevation alone if panning occurs on hemispherical configurations like 7.1.4. This helps smooth out panning when 3D sounds pass above or below the listener. Height Spread is always enabled by default even if a sound doesn’t have an attenuation. Height Spread can only be disabled by deselecting this property. If a sound doesn’t have an attenuation, and you would like to disable Height Spread, an Attenuation ShareSet with a constant Output Bus Volume must be created specifically for this purpose. For more information, refer to Effect of Height Spread . Default value: true | |||
Cone Use |
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. Default value: No | |||
Cone max attenuation |
The amount by which the volume is attenuated when the emitting source falls outside the transition area. Cone max attenuation has a link indicator and an RTPC indicator. Refer to Working with the Property Editor for more information. Default value: -6.0 Range: -200 to 0 Units: dB | |||
Cone inner angle |
The angle that defines an area where no attenuation occurs. The Cone inner angle defines the top boundary in the Cone Preview. It is redrawn in real time as the value is modified. 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 Cone max attenuation value. Default value: 90 Range: 0 to 360 Units: ° | |||
Cone outer angle |
The angle that defines the area where Volume, Low-Pass Filter, Spread, and Focus Attenuation remain at their maximum levels. The Cone outer angle defines the bottom boundary in the Cone Preview. It is redrawn in real time as the value is modified. 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 Cone max attenuation value. Default value: 245 Range: 0 to 360 Units: ° | |||
Cone 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 will be applied, where 0 means no low-pass filtering (signal unaffected) and 100 means maximal attenuation. The Cone Low-pass filter has a link indicator and an RTPC indicator, see Working with the Property Editor for more information. (For more detail, see Wwise LPF and HPF Value Cutoff Frequencies .) Default value: 0 Range: 0 to 100 Units: % | |||
Cone 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 will be applied, where 0 means no high-pass filtering (signal unaffected) and 100 means maximal attenuation. The Cone High-pass filter has a link indicator and an RTPC indicator. Refer to Working with the Property Editor for more information. Default value: 0 Range: 0 to 100 Units: % | |||
Cone 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 Cone Preview has the following two functions:
The Cone Preview only works for objects that use a listener position. |
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