Starts loudness measurement on a channel.
Namespace: Un4seen.Bass.AddOn.Loud
Assembly: Bass.Net (in Bass.Net.dll) Version: 2.4.18.0
Syntax
[DllImportAttribute("bassloud")] public static int BASS_Loudness_Start( int handle, BassLoudness flags, int priority )
Parameters
- handle
- Type: SystemInt32
The channel handle... a HSTREAM, HMUSIC, or HRECORD. - flags
- Type: Un4seen.Bass.AddOn.LoudBassLoudness
A combination of these flags BassLoudness:BASS_LOUDNESS_CURRENT Enable loudness measurement of the last 400ms or up to the duration (in milliseconds) specified in the HIWORD (use MakeLong(Int16, Int16)). This is always enabled with a duration of at least 400ms even if not specified. BASS_LOUDNESS_INTEGRATED Enable integrated loudness measurement. BASS_LOUDNESS_RANGE Enable loudness range measurement. BASS_LOUDNESS_PEAK Enable peak level measurement. BASS_LOUDNESS_TRUEPEAK Enable true peak level measurement. BASS_LOUDNESS_AUTOFREE Automatically free the measurement when the channel is freed. - priority
- Type: SystemInt32
The DSP priority of the measurements. Any DSP/FX with a higher priority than this will be present in the measurements, while any with lower priority will not. Any with the same priority may or may not be present, depending on which was set first.
Return Value
Type: Int32The loudness measurement handle is returned if it is successfully started, else 0 is returned. Use BASS_ErrorGetCode to get the error code.
Remarks
Each measurement type may use a bit more CPU and/or memory, so only the ones that are needed should be included in the flags parameter. When no longer needed, a measurement can be stopped and its resources freed with BASS_Loudness_Stop(Int32). The BASS_LOUDNESS_AUTOFREE flag may also be used to have it freed automatically when the channel is. A measurement may also be moved to another channel via BASS_Loudness_SetChannel(Int32, Int32, Int32).
| ERROR CODE | Description |
|---|---|
| BASS_ERROR_HANDLE | handle is not valid. |
| BASS_ERROR_MEM | There is insufficient memory. |
See Also