Description

A view that allows setting two numerical values represented by the horizontal and vertical position of a handle movable in two dimensions.

The values are always within the range between 0 and 1. Scaling the output and input values to your needs can easily be achieved by using a ControlSpec with its -map and -unmap methods.

The -step variable determines the amount by which the values will change when the handle is controlled using the keyboard. By default, holding down the Shift, Ctrl, or Alt key will multiply this amount by 100, 10, or 0.1 respectively, though you can customize this by setting -shift_scale, -ctrl_scale, or -alt_scale.

Drag and drop gives and accepts a Point of which the two coordinates represent the two values of the Slider2D.

Class Methods

Inherited class methods

Undocumented class methods

Slider2D.new(parent, bounds)

Slider2D.qtClass

Instance Methods

Data

.x

.x = aFloat

.y

.y = aFloat

.activex = aFloat

.activey = aFloat

.setXY(x, y)

.setXYActive(x, y)

.incrementX(factor: 1.0)

.decrementX(factor: 1.0)

.incrementY(factor: 1.0)

.decrementY(factor: 1.0)

Appearance

.knobColor

.knobColor = color

Interaction

.step

.step = aFloat

.pixelStepX

.pixelStepY

.shift_scale

.shift_scale = aFloat

.ctrl_scale

.ctrl_scale = aFloat

.alt_scale

.alt_scale = aFloat

Actions

.action

.action = func

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

Drag and drop

.defaultGetDrag

.defaultCanReceiveDrag

.defaultReceiveDrag

Inherited instance methods

Undocumented instance methods

.background

.background = color

.randomize

Examples

( w = Window("Slider2D", Rect(100, 100, 140, 140)); t = Slider2D(w, Rect(20, 20, 80, 80)) .x_(0.5) // initial location of x .y_(1) // initial location of y .action_({|sl| [\sliderX, sl.x, \sliderY, sl.y].postln; }); w.front; ) t.x // get the x loc t.x_(0.25) // set the x loc

Drag an drop Points( w = Window("Slider2D", Rect(100, 100, 500, 300)); w.view.decorator = FlowLayout(w.view.bounds); t = Slider2D(w, Rect(20, 20, 280, 280)) .x_(0.5) // initial location of x .y_(1) // initial location of y .background_(Color.rand) .action_({|sl| [\sliderX, sl.x, \sliderY, sl.y].postln; }); t.step_(0.01); n = CompositeView.new(w, 200@300); n.decorator = FlowLayout(n.bounds); v = { |i| DragBoth.new(n, Rect(0, i * 20, 200, 20)).background_(Color.rand).align_(\center) }.dup(5); StaticText.new(n, 200@150).string_("hold down cmd and drag points from the slider to the drag slots, or reverse").stringColor_(Color.white); w.front; )

Shape a Sound( s.waitForBoot({ a = {arg mod = 0.05, index = 0.05; var r,out, out2; r = Saw.ar(8, 0.03); out = PMOsc.ar( 440, 660 * mod, 3 * index, 0, Lag.ar(r,0.01,1)); [out,Delay1.ar(out)]; }.play; w = Window("Slider2D", Rect(100,Window.screenBounds.height - 400, 300, 300)); w.view.decorator = FlowLayout(w.view.bounds); t = Slider2D(w, Rect(0, 0,292, 292)) .y_(0.05) .x_(0.05) .background_(Color.rand) .knobColor_(Color.rand) .action_({|sl| a.set(\mod,sl.x,\index,sl.y); }); w.front; CmdPeriod.doOnce({w.close}); }) )