nw::snd::FxReverb::SetParam Member Function

Syntax

#include <nw/snd/snd_FxReverb.h>

bool SetParam(
     const Param & param
);

Arguments

Name Description
in param Reverb parameters.

Return Values

Returns true if settings are successful. Returns false if settings fail (value out of bounds, for instance).

Description

Sets reverb parameters.

The GetRequiredMemSize function calculates the memory size required based on the reverb parameters that have been set.

The Param structure that has been set is copied internally.

Behavior changes before and after calling SoundSystem::AppendEffect and passing an instance of FxReverb.

Before calling SoundSystem::AppendEffect, a value range check is made for the m_Coloration, m_Damping, m_EarlyGain, and m_FusedGain members of the Param structure. If values are out of range, execution stops on an assert for Debug and Development versions, while false is returned for Release versions.

After SoundSystem::AppendEffect is called, in addition to the value range check performed before the call, a check is made whether the required memory size has increased. In other words, if operations such as the following:
- A value larger than when Initialize was called is set for m_EarlyReflection
- A value larger than when Initialize was called is set for m_PreDelay
- Value largers than when Initialize was called are set for each member of m_pFilterSize
- m_IsEnableSurrund is set to true even though it was set to false when Initialize was called
are performed, this function fails and returns false. If all of the conditions given above are satisfied, parameters can now be changed using SoundSystem::AppendEffect.

See Also

GetRequiredMemSize
GetParam

Revision History

2010/09/30
Added information on behavior before and after calling SoundSystem::AppendEffect.
2010/09/03
Added information about return values and behavior with Debug and Development versions.
2010/07/07
Added to the description of the Param structure set, and added GetParam to See Also.
2010/06/17
Initial version.

CONFIDENTIAL