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

live.slider Reference

Output numbers by moving a slider onscreen

live.slider

Description

live.slider is a user interface object that resembles a sliding potentiometer.

Examples

Arguments

None.

Attributes

active [int] (default: 1)

Toggles the object's active mode. When the active attribute is set to 0, the mouse action does not cause output and the inactive colors are used.

annotation_name [symbol] (default: )

The string that is prepended to annotations. This shows up in the Info pane in Live, and the clue window in Max.

focusbordercolor [4 floats]

Sets the border color in RGBA format to be used when the live.slider has the focus.

modulationcolor [4 floats]

Sets the modulation color of the live.slider object in RGBA format.

orientation [int] (default: 0)

Defines the orientation of the live.slider object.

Possible values:

0 = 'Vertical' ( Vertical )
Vertical orientation (the default).

1 = 'Horizontal' ( Horizontal )
Horizontal orientation (the default).

parameter_mappable [int] (default: 1)

When parameter_mappable is enabled, the object will be available for mapping to keyboard or MIDI input using the Mappings feature.

relative [int] (default: 0)

Sets the way that the live.slider object responds to mouse clicks.

Possible values:

0 = 'Absolute' ( Absolute )
In absolute mode, the live.slider object will automatically jump directly to the clicked location.

1 = 'Relative' ( Relative )
In relative mode (the default), the live.slider object keeps its relative position when you click on it. Moving the mouse outputs higher or lower values in relation to that relative position.

showname [int] (default: 1)

The word showname, followed by the number 1 or 0, shows or hides the parameter name.

shownumber [int] (default: 1)

The word shownumber, followed by the number 1 or 0, shows or hides the parameter value.

slidercolor [4 floats]

Sets the slider color of the live.slider objectin RGBA format.

textcolor [4 floats]

Sets the display color for the live.slider object's text in RGBA format.

tribordercolor [4 floats]

Sets the triangle border color in RGBA format. This is only used when the live.slider object does not have the focus.

tricolor [4 floats]

Sets the triangle color in RGBA format. This is only used when the live.slider object does not have the focus.

trioncolor [4 floats]

Sets the triangle color in RGBA format. This is only used when the live.slider object does have the focus.

Common Box Attributes

Parameter Attributes

Messages

bang

Sends the current value out the outlet.

int

Arguments

input [int]
The number received in the inlet is stored and displayed by the live.slider object and sent out the outlet.

float

Arguments

input [float]
The number received in the inlet is stored and displayed by the live.slider object and sent out the outlet.

assign

Arguments

assign-input [float]
The word assign, followed by a floating point value, causes that value to be stored and displayed and sent out the live.slider object's outlet. If the Parameter Visibility attribute is set to Stored Only, the assign message will not add the new value to the Live application’s undo chain.

init

Restore and output the initial value.

(mouse)

Click and drag in the slider to change the value. Hold down the Shift key for more precise mouse control.

outputvalue

Sends the current value out the outlet.

rawfloat

Arguments

input [float]
A raw normalized value (between 0. and 1.) received in the inlet is converted to a real value, stored, displayed by live.slider, and the current value is sent out the outlet.

set

Arguments

set-input [float]
Sets and displays the current value without triggering any output.

Output

float

Out right outlet: when an output is triggered, a raw normalized value (between 0. and 1.) is sent out this outlet.

int/float

Out left outlet: Numbers received in the inlet or produced by clicking or dragging on live.slider with the mouse are sent out the outlet. The value sent is an integer if the Parameter Type is set to INT or ENUM.

See Also

Name Description
live.numbox
live.dial