Methods > Init, info and tags > SilenceDetectionOnPlayerLoadAutoSet method

Remarks

Enable/disables the automatic detection of silent sound's portions during the loading of a sound through one of the many methods having the "Load" prefix like LoadSound or LoadSoundFromMemory: 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 SilenceDetectionOnPlayerRequest method.

For further details about silence detection management see the How to detect silent portions of sound files tutorial.

Syntax

[Visual Basic]

control.SilenceDetectionOnPlayerLoadAutoSet (

bAutomatic as enumBoolean,

nThresholdInitial as Long,

nThresholdFinal as Long

)

[C++]

void control.SilenceDetectionOnPlayerLoadAutoSet (

short bAutomatic,

long nThresholdInitial,

long nThresholdFinal

);

Parameter

Description

bAutomatic

Boolean value that specifies 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).

Return value

None