What's New in 1.09

FMOD Studio API

previous page next page

Firelight Technologies FMOD Studio API

What's New in 1.09

This section describes the major features introduced in the 1.09 release. See the Detailed Revision History for information regarding each patch release.

Multiple listener weighting

Studio's multiple listener support has been improved with the ability to set a weighting per listener with Studio::System::setListenerWeight. The weight allows listeners to be smoothly faded in or out of existence.

For example to do a crossfade, an additional listener can be created with a weighting of 0 that ramps up to 1 while the old listener weight is ramped down to 0. After the crossfade is finished the number of listeners can be set down to 1 again.

Listener weight is used in the 3D panner, the doppler calculation, and the automatic distance event parameter.

For more information, see the Studio 3D Events page.

Getting final value for volume and parameter values

The Studio API getter functions take an extra optional argument which will receive the final value after automation, modulation, and snapshots.

It allows the sound designer to set up automations on parameters which the game can query and drive other game side systems, as well as getting volume of buses after snapshots are applied. For existing codebases, the second argument defaults to NULL which is unchanged behaviour.

The functions that have the extra functionality are:

As part of this change, the older function names have been renamed for consistency:

Multiband EQ

A new EQ DSP has been developed to roll up several simpler DSPs into one high performance flexible effect.

The multiband EQ consists of 5 independently configurable parametric equalizers with several filtering modes:

  • Low-pass (12dB, 24dB, 48dB)
  • High-pass (12dB, 24dB, 48dB)
  • Low-shelf
  • High-shelf
  • Peaking
  • Band-pass
  • Notch
  • All-pass

This new effect will supercede existing lowpass, highpass, lowpass simple, highpass simple and parametric eq effects. It has better performance and a superset of functionality compared with the now deprecated effects and thus should be considered as a replacement. For more information on how to use the new effect as a replacement see FMOD_DSP_TYPE remarks.

What's new since 1.08 initial release

This section covers some of the improvements introduced between the first 1.08 release and the new 1.09 release. See the Detailed Revision History for more information on features introduced during the 1.08 lifetime.

Sound Play / Stop callbacks

You can now set a callback to be fired when the Studio runtime plays or stops an events. With the callback is the low level FMOD::Sound through which you can query the name of the sound played

Listener mask

Events can be set up to only be influenced by some of the listeners. Studio::EventInstance::setListenerMask can be used to specify a mask for what listeners apply to that event.

For more information, see the Studio 3D Events page.

previous page start next page