A newer version of Max is available. Click here to access the latest version of this document.

levelmeter~

Visual RMS level indicator

Description

levelmeter~ is a signal level-meter with optional ballistics.

Arguments

None.

Messages

bang The RMS amplitude most recently calculated for an input signal is displayed and output by the needle of the on-screen level meter.
int input [int]
An int sets dB value displayed and output by levelmeter~.
clear The word clear clears the FB delay stage memory.
mode operational-mode (0 through 5) [int]
The word mode followed by an integer between 0 and 5 will set the operational mode of levelmeter~ as follows:
0 = "fast"(no ballistics or dB-offset)
1 = "VU" (attack = 330; release = 330; dB-offset = -20)
2 = "DIN 45 406(IEC PPM type IIb)"(attack = 10; release = 1500; dB-offset = -14)
3 = "BBC (IEC PPM type IIa)" (attack = 10; release = 3000; dB-offset = -14)
4 = "Nordic (IEC PPM type I)" (attack = 5; release = 2000; dB-offset = -14)
5 = "EBU Digital" (attack = 0; release = 1500; dB-offset = -14)
(Object defaults to "fast" mode.)
signal The RMS amplitude of the incoming signal is displayed by the needle of the on-screen level meter.

Attributes

Name Type g/s Description
attack int
def.:0
The word attack, followed by a number, sets the levelmeter~ object attack time, in milliseconds. The default is 0.
bgcolor float
def.:0.94267 0.94267 0.94267 1.
Sets the RGBA color values for the background color of the levelmeter~ object.
bordercolor float
def.:0. 0. 0. 1.
Sets the RGBA values for the border color of the levelmeter~ object.
coolcolor float
def.:0.70588 0.82353 0.39126 1.
Sets the RGBA values for the color for the lower “cool” range of the levelmeter~ object.
fgcolor float
def.:0.78542 0.78542 0.78542 1.
Sets the RGBA color values for the foreground color of the levelmeter~ object
hotcolor float
def.:0.86275 0.39126 0.39126 1.
Sets the RGBA values for the color for the upper-middle “hot” range of the levelmeter~ object.
interval int
def.:20
Sets the update time interval in milliseconds, of the levelmeter~ display. The minimum update interval is 10 milliseconds, the maximum is 2 seconds, and the default is 100 milliseconds. This message also sets the rate at which levelmeter~ sends out the peak value received in that time interval.
markercolor float
def.:0. 0. 0. 1.
Sets the RGBA values for the markers of the levelmeter~ object.
markers int
def.:-48 -36 -24 -12 -6 0 6 12
Sets the locations of the small dots along the colored stripe on the four floating-point numbers in the range 0.-1.0, object. Up to 8 markers may be diaplayed.
markersused int
def.:8
Specifies the number of markers used in the levelmeter~ object's display.
needlecolor float
def.:0. 0. 0. 1.
Sets the RGBA values for the color for the needle of the levelmeter~ object.
offset int
def.:0
Sets the levelmeter~ object display's deciBel offset.
overloadcolor float
def.:1. 0. 0. 1.
Sets the RGBA values for the color for the upper “overload” range of the levelmeter~ object.
range int
def.:-48 12
Sets the display range of the levelmeter~ object. The default range is -40 dB to 12 dB.
release int
def.:0
Sets the levelmeter~ object release time, in milliseconds. The default is 0.
rounded int
def.:8
Sets the roundness, in pixels, of the levelmeter~ object box. The default is 6.
tepidcolor float
def.:0.86275 0.78431 0.39126 1.
Sets the RGBA values for the color for the lower-middle “tepid” range of the levelmeter~ object.
warmcolor float
def.:0.86275 0.58824 0.31373 1.
Sets the RGBA values for the color for the middle “warm” range of the levelmeter~ object.

Information for box attributes common to all objects

Output

float: The RMS (root mean square) value in deciBels of the signal for the current update interval is sent out the outlet when audio processing is on.

Examples

levelmeter~ displays and sends out the RMS amplitude of a signal in deciBels

See Also

Name Description
average~ Multi-mode signal average
meter~ Visual peak level indicator
scope~ Signal oscilloscope
MSP Tutorial 23: Viewing Signal Data MSP Tutorial 23: Viewing Signal Data