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

rslider Reference

Display or change a range of numbers

rslider

Description

Set a value range from the lowest to highest value.

Examples

Output minimum and maximum values, to set the range of another object

Discussion

In the right inlet, the number is taken as one end of the range. The left inlet sets the other end. Drawing the range with the mouse always outputs the lowest value out the left outlet and the highest out the right.
Shift-clicking extends the range instead of replacing it. Command-clicking (Macintosh) or Control-double-clicking (Windows) and dragging shifts the current range values up or down. Option-clicking (Macintosh) or Alt-clicking (Windows) and dragging up or down expands or shrinks the currently selected range. Command-double-clicking (Macintosh) or Control-double-clicking (Windows) selects the entire range.

Arguments

None.

Attributes

bgcolor [4 floats]

Sets the background color of the rslider object in RGBA format.

bordercolor [4 floats]

Sets the border color of the rslider object in RGBA format.

drawline [int] (default: 1)

Toggles the drawing of a center line on the rslider display. The default value is 1 (on).

fgcolor [4 floats]

Sets the range color of the rslider object in RGBA format.

floatoutput [atom_long] (default: 0)

Toggles floating-point output from the slider object. The default is 0 (off).

listmode [int] (default: 0)

Toggles the list output mode. When it is on, the rslider object will output the min and max values as a list out the left outlet. Otherwise, the values are sent out the right and left outlets. The default value is 0 (off).

min [atom_long] (default: 0)

Sets value that will be added to the rslider object's lower value before it is sent out the outlet.

mult [float] (default: 1.)

Sets a multiplier value. The rslider object's value will be multiplied by this number before it is sent out the outlet. The default value is 1.

orientation [int] (default: 0)

Sets the rslider object to a horizontal or vertical data display.
Automatic: (the default) sets the display dependent on the size of the slider - longest side of the rectangle that describes the slider sets the orientation.
Horizontal
Vertical

Possible values:

0 = 'Automatic'
1 = 'Horizontal'
2 = 'Vertical'

parameter_enable [int]

Enables use of this object with Max for Live Parameters and allows for setting initial parameter values in the Max environment.

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.

size [float] (default: 128.)

Sets the total range of the rslider. The rslider will range from 0 to one less than the specified size. A size message smaller than 1 will be automatically set to 2. By default, the size of an rslider is 128.

style [symbol] (default: )7.0.0

Sets the style to be applied to the object. Styles can be set using the Format palette.

thickness [float] (default: 80.)

Sets the thickness of the rslider knob. The default value is 80.

Common Box Attributes

Parameter Attributes

Messages

bang

In left inlet: Sends out the minimum and maximum values of the currently displayed range.

int

Arguments

minimum [int]
In left inlet: The number sets the minimum limit of a range displayed as a colored region on the rslider, and causes the minimum and maximum values of that range to be sent out. A number that exceeds the limits of the rslider itself will be limited to stay within the rslider.

The minimum and maximum values can also be set (and sent out) by dragging with the mouse across a range in the rslider.

  (inlet1)

Arguments

maximum [int]
In right inlet: The number is stored as the maximum limit of the range displayed in color on the rslider. A number that exceeds the limits of the rslider itself will be limited to stay within the rslider.

The minimum and maximum values can also be set (and sent out) by dragging with the mouse across a range in the rslider.

float

Arguments

minimum [float]
Converted to int.

  (inlet1)

Arguments

maximum [float]
In right inlet: The number is stored as the maximum limit of the range displayed in color on the rslider. A number that exceeds the limits of the rslider itself will be limited to stay within the rslider.

The minimum and maximum values can also be set (and sent out) by dragging with the mouse across a range in the rslider.

list

Arguments

minimum [int]
maximum [int]
In left inlet: The first two numbers in the list are used to set the minimum and maximum values of the displayed range, and are sent out.

(mouse)

Clicking on the rslider object and dragging sets the minimum and maximum values and sends them out the object's outlets (or left outlet in list mode). or setting attributes.

set

Arguments

minimum [int]
maximum [int]
In left inlet: The word set, followed by two numbers, sets the minimum and maximum values of the currently displayed range, without sending them out the outlets.

setminmax

Arguments

low [int]
high [int]
The word setminmax, followed by two numbers, sets the low and high range values for the rslider object. The floatoutput attribute will automatically be set.

Output

int

The maximum value of the displayed range is sent out the right outlet, and the minimum value is sent out the left outlet. Output is triggered by a new minimum value (or a bang) received in the left inlet, or by clicking or dragging the mouse in the rslider.

See Also

Name Description
multislider
nslider
pictctrl
pictslider
slider
split
Max Basic Tutorial 13: Movie Sequencing Max Basic Tutorial 13: Movie Sequencing