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

live.meter~

Live-style visual peak level indicator

Description

The live.meter~ object is a simple mono Live-style signal level meter that can be attached to any signal whose level is between -1 and 1 (other signals should be scaled first). The visual output of the live.meter~ shows the current signal level, the recent peak level, and provides a red "over" indicator if the signal is greater than or equal to 1. You can change the redrawing interval with the Interval attribute, and the orientation of the meter is set using the Orientation attribute.

Arguments

None.

Messages

int signal-value [int]
Converted to float.
float signal-value [float]
When no signal is connected to the live.meter~ object's inlet, a float value will set the meter to react as though a signal with equal amplitude peak-value has been passed to its input. Corresponding LEDs will light up and the peak-level value will be passed out the outlet (0.0 will show silence, 0.0 through 1.0 will light up to any but the overload LED, and anything above 1.0 will light all LEDs including overload).
db db-value [float]
The word db, followed by a floating point number that specficies a deciBel value, will set the live.meter~ object to react as though a signal with that dB peak-value has been passed to its input. Corresponding LEDs will light up and the value will be passed out the outlet.
signal The peak amplitude of the incoming signal is displayed by the on-screen level meter.

Attributes

Name Type g/s Description
active int
def.:1
Enables (1) or disables (0) the meter display.
bgcolor float Sets the background color in RGBA format.
clip_size int
def.:0
Sets the clipping range for the display. The options are Normal or Extended.
coldcolor float Sets the Cold signal color in RGBA format.
display_range float
def.:-70. 6.
Sets the display range of the meter in dB.
hotcolor float Sets the Warning signal color in RGBA format.
inactivecoldcolor float Sets the Cold signal (inactive) color in RGBA format.
inactivewarmcolor float Sets the Warm signal (inactive) color in RGBA format.
interval int
def.:20
Sets the update-time interval, in milliseconds, of the live.meter~ display. The minimum update-interval is 10 milliseconds, the maximum is 2 seconds, and the default is 50 milliseconds. This message also sets the rate at which meter~ sends out the peak value received in that time interval.
orientation int
def.:0
Sets the orientation of the meter display. The options are Horizontal or Vertical
overloadcolor float Sets the Overload signal color in RGBA format.
warmcolor float Sets the Warm signal color in RGBA format.

Information for box attributes common to all objects

Examples

See Also

Name Description
average~ Multi-mode signal average
meter~ Visual peak level indicator
scope~ Signal oscilloscope