Copyright © 2001-2018 MultiMedia Soft

SetAutomaticBPM method

Previous pageReturn to chapter overviewNext page

Remarks

 

Enable/disables the automatic BPM (Beat Per Minute) detection during the loading of a sound through one of the many methods having the "Load" prefix like LoadSound or LoadSoundFromMemory: 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 specifies 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