Clears the peak hold indicator.
Clears the peak hold
indicator. Note that you will need
to call setPeakAndRMS
successively
for the graphics to be updated.
Clears the peak, peak hold and rms values immediately (without ballistics).
Clears the peak, peak hold and rms values immediately (without ballistics). This way the component can be reset when the metering task is stopped without waiting for the bars to fall down.
Sets the peak indicator hold time.
Sets the peak indicator hold time. Defaults to 1800 milliseconds.
new peak hold time in milliseconds. Note that
you can use Int.MaxValue
for an infinite
peak hold. In this case, to clear the indicator,
call clearHold
Decides whether the peak indicator should be painted or not.
Decides whether the peak indicator should be painted or not. By default the indicator is painted.
true
to have the indicator painted,
false
to switch it off
Reads or sets the linear mean square value.
Reads or sets the linear mean square value. Not that this is not the _root_ mean square for optimization purposes. The caller needs to take the square root of the returned value.
Decides whether the blue RMS bar should be painted or not.
Decides whether the blue RMS bar should be painted or not. By default the bar is painted.
true
to have the RMS values painted,
false
to switch them off
Reads or sets the linear mean square value.
Reads or sets the linear mean square value. Not that this is not the _root_ mean square for optimization purposes. The caller needs to take the square root of the returned value.
Updates the meter.
Updates the meter. This will call the component's paint method to visually reflect the new values. Call this method regularly for a steady animated meter.
If you have switched off RMS painted, you may want to
call setPeak
alternatively.
When your audio engine is idle, you may want to stop meter updates. You can use the following formula to calculate the maximum delay of the meter display to be safely at minimum levels after starting to send zero amplitudes: <UL> <LI>for peak hold indicator not painted : delay[sec] = abs(minAmplitude[dB]) / fallTime[dB/sec] + updatePeriod[sec]</LI> <LI>for painted peak hold : the maximum of the above value and delay[sec] = abs(minAmplitude[dB]) / holdFallTime[dB/sec] + holdTime[sec] + updatePeriod[sec] </LI> </UL><P> Therefore, for the default values of 1.8 sec hold time, 15 dB/sec hold fall time and -40 dB minimum amplitude, at a display period of 30 milliseconds, this yields a delay of around 4.5 seconds. Accounting for jitter due to GUI slowdown, in ths case it should be safe to stop meter updates five seconds after the audio engine stopped.
peak amplitude (linear) between zero and one.
mean-square amplitude (linear). note : despite the name, this is considered mean-square, not root-mean-square. this method does the appropriate conversion on the fly!
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.
(Since version ) see corresponding Javadoc for more information.