Effects.BassBoostApply method |
|
Remarks
Applies a DSP effect for boosting bass levels on the playing song. This DSP effect can be reset through the Effects.BassBoostReset method.
When this kind of filter is activated on any of the players instanced by the control, eventual custom DSPs must be set to work with floating point samples through the CustomDSP.UseFloatSamples method.
See the How to apply special effects to a playing sound section for further details.
Syntax
[Visual Basic] control.Effects.BassBoostApply ( nPlayer as Integer, nFrequencyInHz as Long, fBoostLevelIndB as Single, nPriority as Integer ) as enumErrorCodes |
[C++] short control.Effects.BassBoostApply ( short nPlayer, long nFrequencyInHz, float fBoostLevelIndB, short nPriority ); |
Parameter |
Description |
|
|
nPlayer |
Number representing the zero-based index of the involved player |
nFrequencyInHz |
Numeric value representing the frequency expressed in Hz. Accepted values range from 0 to 1000. |
fBoostLevelIndB |
Numeric value representing the Boost level expressed in dB. Accepted values range from 0 to 36. |
nPriority |
Effect's priority level inside the chain of DirectX effects, custom DSP effects and VST effects. Effects with higher priority are applied before effects with lower priority; in case more effects should have the same priority, they would be invoked in the same order that they were added. |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred (see the LastError property for further error details) |
enumErrorCodes.ERR_NOERROR (0) |
The call was successful. |