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]

Public Event VUMeterValueChange As VUMeterValueChangeEventHandler

[C#]

public event VUMeterValueChangeEventHandler VUMeterValueChange;

[C++]

public: __event VUMeterValueChangeEventHandler VUMeterValueChange;

Event Data

The event handler receives an argument of type VUMeterValueChangeEventArgs having the following parameters:

Parameters	Description

nPlayerIndex	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.