GMFaderSlider

Extension

Description

GMFaderSlider is an easy to use customisable slider.

It inherits from the GMZZSlider class, and is only responsible for graphical specifications. See GMZZSlider for non-graphical properties settings.

Its color can be configured so that it becomes transparent as the value is getting lower. The transparency is independant from the selected scale mapping : it is always linear. This means the lower the color is, the lower the value is relatively to the maximum value. This visual hint is useful when using non-linear scale (a slider at the same position would display different colors on an exponential scale and a logarithmic scale). Setting the minimum transparency to 1 will disable the fading effect.

By default, the slider will display its value, truncated to a certain number.

In some certain cases, the built-in slider scales won't suit your usage, and you will need to post-process the slider value within its action function. In this case, you should also modify the displayFunction of the slider so that the displayed value is updated accordingly :( GMFaderSlider() .min_(1) .max_(10) .action_({ |value| value = value.pow(3); value.post; " was selected".postln; }) .displayFunction_({ |value| value = value.pow(3); }) .front )

Class Methods

.new

Instance Methods

Graphical settings

.minAlpha

.sliderRatio

.displayValue

.centerValue

.roundValue

.displayFunction

.fontRatio

.displayHelpers

.drawHelpers

.helpersStyle

.helpersRatio

.centerHelpers

Internal Methods

.draw

.prDrawSlider

.prDrawValue

Examples

Here's a demo of different helpers configuration :( var win = Window( "", Rect(100, 100, 600, 600) ).background_(Color.black); var slider1 = GMFaderSlider() .value_(0.333); var slider2 = GMFaderSlider() .value_(0.333) .helpersNumber_(3) .helperSubdivisions_(7) .displayHelpers_(true); var slider3 = GMFaderSlider() .value_(0.333) .helpersNumber_(3) .helperSubdivisions_(7) .displayHelpers_(true) .centerHelpers_(true); var slider4 = GMFaderSlider() .value_(0.333) .helpersNumber_(3) .helperSubdivisions_(7) .displayHelpers_(true) .helpersRatio_(1); var slider5 = GMFaderSlider() .value_(0.333) .helpersNumber_(4) .helperSubdivisions_(2) .displayHelpers_(true) .helpersStyle_(\dot) .helpersRatio_(0.25); var slider6 = GMFaderSlider() .value_(0.333) .minAlpha_(1) .helpersNumber_(4) .helperSubdivisions_(2) .displayHelpers_(true) .helpersStyle_(\dot) .helpersRatio_(0.25) .style_( GMStyle.default.deepCopy .helpersColor_(Color.yellow) ); var hSlider = GMFaderSlider() .orientation_(\horizontal) .displayHelpers_(true) .helpersNumber_(4) .helperSubdivisions_(7) .polarity_(\bi) .value_(0.333); win.layout_( VLayout() .add( HLayout() .add(slider1) .add(slider2) .add(slider3) .add(slider4) .add(slider5) .add(slider6), 6 ) .add(hSlider, 1) ); win.front; CmdPeriod.doOnce({ win.close; }); )

Copy-paste templates :

Amp :( var slider = GMFaderSlider() .min_(0) .max_(1) .scale_(\lin) .value_(0) .action_({ |value| }); slider.front; )

Freq (mapping imprecisions at certains values) :( var slider = GMFaderSlider() .min_(55) .max_(7040) .scale_(\exp) .value_(440) .helperSubdivisions_(6) .displayHelpers_(true) .action_({ |value| }); slider.front; )

Panner :( var slider = GMFaderSlider() .min_(0) .max_(1) .scale_(\lin) .value_(0) .orientation_(\horizontal) .polarity_(\bi) .displayHelpers_(true) .action_({ |value| }); slider.front; )

Exp scale (mapping imprecisions at certains values) :( var slider = GMFaderSlider() .min_(32.reciprocal) .max_(32) .scale_(\exp) .value_(1) .helpersNumber_(3) .helperSubdivisions_(4) .displayHelpers_(true) .action_({ |value| }); slider.front; )