SetAutomaticSilenceDetection method

Enable/disables the automatic detection of silent sound's portions during a LoadSound or LoadSoundFromMemory methods call: the automatic silence detection is disabled by default.

This method doesn't work with sounds with more than 2 channels (5.1 or 7.1) or if the EnableMixingFeatures property has been set to BOOL_FALSE.

When the automatic silence detection is enabled, the container application will be notified about initial and final positions of silent portions at the start and end of loaded songs through the SilencePositionAvailable event.

When the automatic silence detection is disabled, the loaded song silence can be requested at any time calling the RequestSoundSilenceDetection method.

[Visual Basic]

control.SetAutomaticSilenceDetection (

bAutomatic as enumBoolean,

nThresholdInitial as Long,

nThresholdFinal as Long

)

[C++]

void control.SSetAutomaticSilenceDetection (

short bAutomatic,

long nThresholdInitial,

long nThresholdFinal

);

Parameter

Description

bAutomatic

Boolean value that tells to execute the automatic silence detection on each loaded sound.

Supported values are the following:

Value	Meaning
false	Automatic silence detection is disabled (default)
true	Automatic silence detection is enabled

nThresholdInitial

Number representing the silence threshold at the start of the loaded sound: can assume values from 0 (no sound) to 32767 (max volume).

nThresholdFinal

Number representing the silence threshold at the end of the loaded sound: can assume values from 0 (no sound) to 32767 (max volume).