Methods > Init and info > EnableAutoWaveAnalysisOnLoad method

Remarks

Enables/disables the automatic waveform analysis when a new sound file is loaded: when auto analysis is enabled there is no need to perform a subsequent call to the WaveformAnalyzer.AnalyzeFullSound method.

For further details about methods of the Waveform Analyzer refer to the WaveformAnalyzer object section.

Syntax

[Visual Basic]

control.EnableAutoWaveAnalysisOnLoad (

bEnable as enumBoolean

) as enumErrorCodes

[C++]

short control.EnableAutoWaveAnalysisOnLoad (

short bEnable

);

Parameter

Description

bEnable

Boolean value that specifies if auto analysis is enabled.

Supported values are the following:

Value

Meaning

BOOL_FALSE (default)

Auto analysis is disabled.

BOOL_TRUE

Auto analysis is enabled.

When auto analysis is enabled the file loading requires more CPU time but it's in any case a little bit faster then calling the LoadSound method followed by the WaveformAnalyzer.AnalyzeFullSound method.

This setting is ignored when the "loading mode", set through the SetLoadingMode method. is set to a value different from LOAD_MODE_NEW.

Return value

Value	Meaning

Negative value	An error occurred. Check the LastError property value in order to see the last error.
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.