OSC MESSAGE REFERENCE


PERFORMER sends out a large number of OSC messages describing every change in the object & nodes. This enables completely novel ways of controlling your audio. For example, moving a single node sends out a total of ten messages:

  • Vector coordinates (angle and length from centre)
  • Cartesian coordinates (x and y position on screen)
  • Node touched yes/no
  • Overall object perimeter length
  • Angle and distance to next node
  • Angle and distance to previous node

Some of the parameters are completely independent (e.g. vector coordinates) and some are dependent on the other nodes (e.g. perimeter). Rotation and pinch gestures allow simultaneous adjustment of these independent and dependent parameters. Experimenting with new ways of mapping these flexible parameters is part of the PERFORMER creative process!

 

OSC MESSAGE LIST


[/x/x/x] = OSC string name. 
n1 = node1, n2= node2, etc.
The parameter values sent are scaled between 0.0 and 1.0
Individual Nodes (n1 to n10):
  • Angle [/1/n1/a] — Angle of node to object centre’s 9 o’clock
  • Length [/1/n1/l] — Distance to object centre
  • Touch [/1/n1/touch] — issues a 1 when touching a node
  • Node X [/1/n1/x] — absolute horizontal position of node on the screen
  • Node Y [/1/n1/y] — absolute vertical position of node on the screen
  • Angle to next node [/1/n1next/a]
  • Distance to next node [/1/n1next/d]
Whole Object:
  • Object-centre touch [/1/trigger] — issues a 1 when touching the centre
  • Object X [/1/x] — absolute horizontal position on screen
  • Object Y [/1/y] — absolute vertical position on screen
  • Perimeter [/1/peri] — length of object’s continuous outline
Ribbon:
  • 5 x Ribbon touch [/1/r1-5/on] – issues a 1 when touch is present
  • 5 x Ribbon touch position [/1/r1-5/x] – the touch’s absolute horizontal position on screen

Bank buttons:

  • Bank up [/bank/up] – issues a 1 when bank up button is touched
  • Bank down [/bank/down] – issues a 1 when bank up button is touched
  • Bank value [/bank/value] – the absolute bank number from 1 to 8

Tips for mapping the bank buttons: here