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 id whose value will be mapped to the led's color opacity

range

  • type: object
  • default: {"min":0,"max":1}
  • usage: defines the min and max value 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's id whose multiple values will be displayed on the y axis, evenly spaced on the x axis (only matrices and pads will work)
    • as an array: each element must be an array of [x,y] coordinates, where x and y can either be a:
      • number: constant values
      • string: a widget's id whose value will be used

range

  • type: object
  • default: { x:{"min":0,"max":1}, y:{"min":0,"max":1} }
  • usage: defines the min and max values for the x and y axis

logScaleX

  • type: boolean
  • default: false
  • usage: set to true to use logarithmic scale for the x axis (log10)

logScaleY

  • type: boolean
  • default: false
  • usage: set to true to use logarithmic scale for the y axis (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 false to 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 min and max values for the y axis (dB level)

logScaleX

  • type: boolean
  • default: false
  • usage: set to true to use logarithmic scale for the x axis (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 false to 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 id whose 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 min and max values for the y axis

logScale

  • type: boolean
  • default: false
  • usage: set to true use 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 false to 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 id whose value will be displayed

vertical

  • type: boolean
  • default: false
  • usage: set to true display 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 id whose value will be displayed

horizontal

  • type: boolean
  • default: false
  • usage: set to true to display the meter horizontally

range

logScale