List of all members | Public Member Functions | Public Attributes
Slider Class Reference

horizontal or vertical slider widget. More...

+ Inheritance diagram for Slider:

Public Member Functions

void setRange (number min, number max)
 
void setStripImage (string imagePath, int numImages)
 
void setValue (number value, bool callChangedCallback=true)
 
 Slider (string name, number def, number min, number max, bool integer, bool vertical)
 creates a slider widget on the user inteface. More...
 

Public Attributes

number alpha
 transparency value between 0.0 and 1.0
 
string backgroundColour
 background colour. It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format
 
string backgroundImage
 path to background image
 
table bounds
 widget bounding rect {x,y,width,height}
 
function changed
 callback function used by child widgets to be notified of changes
 
number default
 the widget's default value
 
string displayName
 widget display name
 
string displayText
 custom text to display in place of the standard value display. To revert to the standard behaviour, leave it empty.
 
bool enabled
 boolean flag to enable / disable the widget
 
string fillColour
 fill colour. It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format
 
string handleImage
 path to handle image
 
int height
 widget height in pixels
 
bool interceptsMouseClicks
 boolean flag to toggle mouse handling on widget
 
Mapper::Type mapper
 Mapper type, default is Mapper.Linear.
 
number max
 the widget's maximum value
 
number min
 the widget's minimum value
 
string name
 widget name
 
int paramId
 parameter id
 
bool persistent
 flag to tell if the widget values should be serialized when saving. True by default. Persistent widgets will call their changed function on reload
 
table position
 widget position {x,y}
 
bool showLabel
 show widgets label if any
 
bool showPopupDisplay
 show/hide the value popup display (if any)
 
table size
 widget size {width, height}
 
string thumbColour
 thumb colour. It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format
 
string tooltip
 widget tooltip, default is name
 
string trackColour
 track colour. It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format
 
Unit::Type unit
 Unit type, default is Unit.Generic.
 
number value
 the widget's value
 
bool visible
 boolean flag to toggle widget visibility
 
int width
 widget width in pixels
 
int x
 x position in pixels
 
int y
 y position in pixels
 

Detailed Description

horizontal or vertical slider widget.

creates a slider widget on the user inteface.

s = Slider("slider", 0.5, 0.0, 1.0, false, false)
s.changed = function(self)
print("slider changed", self.value)
end

Constructor & Destructor Documentation

Slider::Slider ( string  name,
number  def,
number  min,
number  max,
bool  integer,
bool  vertical 
)

creates a slider widget on the user inteface.

Parameters
namethe name to give to the widget
defdefault and initial value
minminimum value
maxmaximum value
integeroptional default is false
verticaloptional default is false

Member Function Documentation

void Slider::setValue ( number  value,
bool  callChangedCallback = true 
)
Parameters
valuethe new widget's value
callChangedCallbackcall the changed callback function if true
void Slider::setRange ( number  min,
number  max 
)
Parameters
minminimum value
maxmaximum value
void Slider::setStripImage ( string  imagePath,
int  numImages 
)
Parameters
imagePathpath to knob strip image
numImagesnumber of images in strip