Slider | SuperCollider 3.13.0 Help

Description

A view that allows setting a numerical value by means of moving a sliding handle. It can have horizontal or vertical orientation, meaning the direction in which the handle moves.

Class Methods

Slider.new(parent, bounds)

When a new Slider is created, its -orientation is determined by the initial size: if it is wider than high, the orientation will be horizontal, otherwise it will be vertical.

Instance Methods

.value = argVal

Numerical value between 0 and 1, represented by the handle position within the groove.

Arguments:

argVal

A Float.

.increment(factor: 1.0)

From superclass: AbstractStepValue

Increments the value by -step multiplied by 'factor'.

Arguments:

factor

Any number.

.decrement(factor: 1.0)

From superclass: AbstractStepValue

Decrements the value by -step multiplied by 'factor'.

Arguments:

factor

Any number.

.orientation = aSymbol

The orientation of the Slider - the direction in which the handle moves. The default value depends on the size of the view when created.

Arguments:

aSymbol

One of the two Symbols: \horizontal or \vertical.

.thumbSize = pixels

The size of the handle - its width or height, depending on -orientation.

Arguments:

pixels

An Integer amount of pixels.

.step = aFloat

The amount by which the value will changed when -increment or -decrement is called, or when related keys are pressed.

Arguments:

aFloat

A Float.

.pixelStep

The absolute amount by which the value would change if the handle moved by one pixel.

Returns:

A Float.

.shift_scale = aFloat

From superclass: AbstractStepValue

The factor by which -step is multiplied when incrementing or decrementing the value by keyboard while the Shift key is pressed.

Arguments:

aFloat

A Float.

.ctrl_scale = aFloat

From superclass: AbstractStepValue

The factor by which -step is multiplied when incrementing or decrementing the value by keyboard while the Ctrl key is pressed.

Arguments:

aFloat

A Float.

.alt_scale = aFloat

From superclass: AbstractStepValue

The factor by which -step is multiplied when incrementing or decrementing the value by keyboard while the Alt key is pressed.

Arguments:

aFloat

A Float.

.action = func

From superclass: View

The action object evaluated whenever the user moves the handle.

.defaultKeyDownAction(char, modifiers, unicode, keycode, key)

Implements the default effects of key presses as follows:

Key	Effect
r	valueAction_(1.0.rand)
n	valueAction_(0)
x	valueAction_(1)
c	valueAction_(0.5)
]	increment
[	decrement
up arrow	increment
down arrow	decrement
right arrow	increment
left arrow	decrement

.defaultCanReceiveDrag

Returns:

True if the current drag data is a number.

.defaultReceiveDrag

Sets -valueAction to the current drag data.

This is useful for adding things to existing frameworks that have action functions already.( w = Window.new("A Slider"); a = Slider.new(w, Rect(40, 10, 300, 30)); w.front ); // now incrementally add some action to the slider a.addAction({ |sl| sl.value.postln }); a.addAction({ |sl| w.view.background = Color.green(sl.value) }); a.addAction({ |sl| sl.background = Color.red(1 - sl.value) }); // adding and removing an action: f = { |sl| "--------*******-------".postln; }; a.addAction(f); a.removeAction(f); // or remove all, of course a.action = nil;

Use Slider for triggering sounds

Change background color of Window

helpfile source: /usr/share/SuperCollider/HelpSource/Classes/Slider.schelp
link::Classes/Slider::

Slider : QAbstractStepValue : AbstractStepValue : View : QObject : Object

Slider.new(parent, bounds)

Slider.qtClass

.value

.value = argVal

Arguments:

.valueAction = val

.increment(factor: 1.0)

Arguments:

.decrement(factor: 1.0)

Arguments:

.orientation

.orientation = aSymbol

Arguments:

.thumbSize

.thumbSize = pixels

Arguments:

.knobColor

.knobColor = color

Arguments:

.step

.step = aFloat

Arguments:

.pixelStep

Returns:

.shift_scale

.shift_scale = aFloat

Arguments:

.ctrl_scale

.ctrl_scale = aFloat

Arguments:

.alt_scale

.alt_scale = aFloat

Arguments:

.action

.action = func

.defaultKeyDownAction(char, modifiers, unicode, keycode, key)

.defaultGetDrag

Returns:

.defaultCanReceiveDrag

Returns:

.defaultReceiveDrag

.background

.background = color

.initSlider(bounds)