Events > VUMeterValueChange event

Remarks

Occurs whenever there is a change on the VU-Meter peak values: this event, generated every 15 milliseconds, can be useful if you need to implement your own VU-Meter graphical representation.

For regular mono or stereo streams, peak levels are reported inside the nLeftPeak and nRightPeak parameters: in case you should need to retrieve peak levels or RMS (Root-Mean-Square) levels for each of the channels of a multi-channel audio stream, you could use the StreamPeakLevelsGet method.

This event is fired only if you have created the VUMeter object though a call to the VUMeter.Create method.

For further details about synchronization through Events see the How to synchronize the container application through events tutorial.

Syntax

[Visual Basic]

VUMeterValueChange (

ByVal nPlayer as Integer,

ByVal nLeftPeak as Integer,

ByVal nRightPeak as Integer

)

[C++]

void VUMeterValueChange (

short nPlayer,

short nLeftPeak,

short nRightPeak

);

Parameter	Description

nPlayer	Number representing the zero-based index of the player that fired the event
nLeftPeak	Number representing the peak value for the left channel: can assume values from 0 (no sound) to 32767 (max volume).
nRightPeak	Number representing the peak value for the right channel: can assume values from 0 (no sound) to 32767 (max volume). If the sound is in Mono, the nLeftPeak and nRightPeak parameters assume the same value.