BASS.NET API for the Un4seen BASS Audio Library

BassLoudBASS_Loudness_GetLevelMulti Method

BASS.NET API for the Un4seen BASS Audio Library
Retrieves the level of multiple loudness measurements combined.

Namespace:  Un4seen.Bass.AddOn.Loud
Assembly:  Bass.Net (in Bass.Net.dll) Version: 2.4.18.0
Syntax

public static bool BASS_Loudness_GetLevelMulti(
	int[] handles,
	BassLoudness mode,
	ref float level
)

Parameters

handles
Type: SystemInt32
An array of loudness measurement handles.
mode
Type: Un4seen.Bass.AddOn.LoudBassLoudness
The measurement type to retrieve. One of the following BassLoudness:
BASS_LOUDNESS_CURRENTLoudness in LUFS of the last 400ms or the duration (in milliseconds) specified in the HIWORD (use MakeLong(Int16, Int16)).
BASS_LOUDNESS_INTEGRATEDIntegrated loudness in LUFS. This is the average since measurement started.
BASS_LOUDNESS_RANGELoudness range in LU.
BASS_LOUDNESS_PEAKPeak level in linear scale.
BASS_LOUDNESS_TRUEPEAKTrue peak level in linear scale.
level
Type: SystemSingle
The returned single measurement level (eg. weighted over all channels, stereo, 5.1 etc.).

Return Value

Type: Boolean
If successful, is returned, else is returned. Use BASS_ErrorGetCode to get the error code.
Remarks

his function is identical to BASS_Loudness_GetLevel(Int32, BassLoudness, Single) but with the ability to combine the data from multiple measurements, which can be useful for getting the overall loudness (or peak) of a group of files. Combining the measurements of multiple files is equivalent to putting those files through the same measurement one after another.

The BASS_LOUDNESS_CURRENT mode is not available when combining multiple measurements.

ERROR CODEDescription
BASS_ERROR_HANDLEhandles is not valid.
BASS_ERROR_ILLPARAMmode is not valid.
BASS_ERROR_NOTAVAILThe requested measurement has not been enabled. It needs to be enabled on all of the provided handles.

See Also

Reference