SetAutomaticBPM method

SetAutomaticBPM method

Remarks

Enable/disables the automatic BPM (Beat Per Minute) detection during a LoadSound or LoadSoundFromMemory methods call: the automatic BPM detection is enabled by default: disabling the automatic BPM detection will result in a faster load.

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 BPM detection is enabled, the container application will be notified about the detected BPM through the BPMAvailable event.

When the automatic BPM detection is disabled, the loaded song BPM can be requested at any time using the RequestSoundBPM method.

For further details about BPM detection refer to the How to detect beats positions and BPM tutorial.

Syntax

[Visual Basic]

control.SetAutomaticBPM (

bAutomatic as enumBoolean

)

[C++]

void control.SetAutomaticBPM (

short bAutomatic

);

Parameter

Description

bAutomatic

Boolean value that tells to execute the automatic BPM detection

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	Automatic BPM detection is disabled
BOOL_TRUE	1	Automatic BPM detection is enabled (default)

Return value

None

Return to Table of contents