robianmcd/built-in-variables.md

## built-in-variables.md

      
    Raw
  

              built-in-variables.md
            
          
Name
Description


x, input
These variables represent the input value from the an incoming message. The value taken from the incoming message is specified by the Input dropdown menu under the transformation graph. For example if the input message type is Note and the "velocity" is selected in the input dropdown then "x" or "input" will be the velocity of an incoming note. This value will be between 0 and 1.


d1, chan, channel
The first piece of data in an incoming message. For a MIDI message this will be the channel. You should use the "input" variable instead of this unless you need to use multiple types of input (e.g. velocity and channel). This value will be between 0 and 1.


d2, notenum, ccnum
The second piece of data in an incoming message. For a MIDI note message this will be the note number. You should use the "input" variable instead of this unless you need to use multiple types of input (e.g. velocity and note number). This value will be between 0 and 1.


d3, vel, velocity, ccval
The third piece of data in an incoming message. For a MIDI note message this will be the note's valocity. You should use the "input" variable instead of this unless you need to use multiple types of input (e.g. velocity and note number). This value will be between 0 and 1.


ignore
Nothing will be output when you use an equation of "ignore". This is very useful when you want to filter out in coming messages.


semitone
This is literally equal to 1/127. This is because note numbers range from 0 to 127 and when you are dealing with them in an equation the range from 0 to 1. So you transpose all notes up an octave you could select "Note Number" as the input type and set the equation to "input + semitone"


octave
Octave is equal to "semitone * 12"


pi
3.14159...
Name	Description
x, input	These variables represent the input value from the an incoming message. The value taken from the incoming message is specified by the Input dropdown menu under the transformation graph. For example if the input message type is Note and the "velocity" is selected in the input dropdown then "x" or "input" will be the velocity of an incoming note. This value will be between 0 and 1.
d1, chan, channel	The first piece of data in an incoming message. For a MIDI message this will be the channel. You should use the "input" variable instead of this unless you need to use multiple types of input (e.g. velocity and channel). This value will be between 0 and 1.
d2, notenum, ccnum	The second piece of data in an incoming message. For a MIDI note message this will be the note number. You should use the "input" variable instead of this unless you need to use multiple types of input (e.g. velocity and note number). This value will be between 0 and 1.
d3, vel, velocity, ccval	The third piece of data in an incoming message. For a MIDI note message this will be the note's valocity. You should use the "input" variable instead of this unless you need to use multiple types of input (e.g. velocity and note number). This value will be between 0 and 1.
ignore	Nothing will be output when you use an equation of "ignore". This is very useful when you want to filter out in coming messages.
semitone	This is literally equal to 1/127. This is because note numbers range from 0 to 127 and when you are dealing with them in an equation the range from 0 to 1. So you transpose all notes up an octave you could select "Note Number" as the input type and set the equation to "input + semitone"
octave	Octave is equal to "semitone * 12"
pi	3.14159...