Plots¶
Plots are tools that display other widgets' state or incomming osc messages. They are not sensitive to mouse and touch interactions.
Led¶
{ type:'led', // etc }
widgetId¶
- type:
string - default:
empty - usage: a widget's
idwhose value will be mapped to the led's color opacity
range¶
- type:
object - default:
{"min":0,"max":1} - usage: defines the
minandmaxvalue the led's intensity will be mapped to
logScale¶
- type:
boolean - default:
false - usage: set to true to use logarithmic scaling
RgbLed¶
{ type:'rgbled', // etc }
This one is like the led except it takes either three arguments (red, green and blue values between 0 and 255) with an optionnal forth argument (alpha, between 0 and 1), or one argument (a valid css color name).
Plot¶
The plot receives an array of [x,y] coordinates and draws them on a chart with linear or logarithmic interpolation.
{ type:'plot', // etc }
points¶
- type:
array|string - default:
[] - usage:
- as a
string: a widget'sidwhose multiple values will be displayed on theyaxis, evenly spaced on thexaxis (only matrices and pads will work) - as an
array: each element must be anarrayof[x,y]coordinates, wherexandycan either be a:number: constant valuesstring: a widget'sidwhose value will be used
- as a
range¶
- type:
object - default:
{ x:{"min":0,"max":1}, y:{"min":0,"max":1} } - usage: defines the
minandmaxvalues for thexandyaxis
logScaleX¶
- type:
boolean - default:
false - usage: set to
trueto use logarithmic scale for thexaxis (log10)
logScaleY¶
- type:
boolean - default:
false - usage: set to
trueto use logarithmic scale for theyaxis (log10)
smooth¶
- type:
boolean - default:
false - usage: set to true to make the line smooth. Float values are also acceptable (works fine between 0 and 0.5)
origin¶
- type:
number - default:
auto - usage: defines the y-axis origin. Set to
falseto disable it.
Eq¶
The Eq receives an array of filter objects and draws their frequency response between 20Hz and 22050Hz.
{ type:'eq', // etc }
filters¶
- type:
array - default:
[] - usage:
- each item must be an object of the form below
- all filters parameters can be filled with widget ids, whose value will be used
{
type:[string], // "highpass", "highshelf", "lowpass", "lowshelf", "peak", "notch"
freq:[number], //
q:[number], //
gain:[number], //
on:[bool] // 1 or true = active, 0 or false = bypassed
}
resolution¶
- type:
number - default:
128 - usage: defines the number of points used to compute the frequency response
rangeY¶
- type:
object - default:
{"min":-20,"max":20} - usage: defines the
minandmaxvalues for theyaxis (dB level)
logScaleX¶
- type:
boolean - default:
false - usage: set to
trueto use logarithmic scale for thexaxis (log10)
smooth¶
- type:
boolean - default:
false - usage: set to true to make the line smooth. Float values are also acceptable (works fine between 0 and 0.5)
origin¶
- type:
number - default:
auto - usage: defines the y-axis origin. Set to
falseto disable it.
Visualizer¶
The visualizer displays the evolution in time of a received value (through osc) or another widget's value.
{ type:'visualizer', // etc }
widgetId¶
- type:
string - default:
empty - usage: a widget's
idwhose value will be displayed (thus bypassing the incoming osc)
duration¶
- type:
number - default:
1 - usage: window size in seconds
range¶
- type:
object - default:
{"min":0,"max":1} - usage: defines the
minandmaxvalues for theyaxis
logScale¶
- type:
boolean - default:
false - usage: set to
trueuse logarithmic scaling (log10)
smooth¶
- type:
boolean - default:
false - usage: set to true to make the line smooth. Float values are also acceptable (works fine between 0 and 0.5)
origin¶
- type:
number - default:
auto - usage: defines the y-axis origin. Set to
falseto disable it.
Text¶
Text displays incoming values (via osc) as text. Sending a message with no argument to the widget will reset it to its default text.
{ type:'text', // etc }
widgetId¶
- type:
string - default:
empty - usage: a widget's
idwhose value will be displayed
vertical¶
- type:
boolean - default:
false - usage: set to
truedisplay vertically
Meter¶
Meter displays incoming numerical values (via osc) as a gauge level
{ type:'meter', // etc }
widgetId¶
- type:
object - default:
empty - usage: a widget's
idwhose value will be displayed
horizontal¶
- type:
boolean - default:
false - usage: set to
trueto display the meter horizontally
range¶
- see fader's
range
logScale¶
- see fader's
logScale