3. JavaScript command reference
Here are listed all the commands that MXW recognizes.
Legend
The standard used to represent the available values for each command is:
FLOATS are represented with one decimal:
0.0 .. 1.0
→ all float values between 0 and 1 included
INTEGERS are represented with numbers or descriptions:
1 .. 5
→ all integers between 1 and 5 included ( 1 , 2 , 3 , 4 , 5 )
1 .. (MAX n layers)
→ all the integers between 1 and the maximum index of layers in MXW (e.g. if 6 layers are being used the values are integers between 1 and 6 included)
When only one number is indicated it means that only one option is given. This is found in addresses of buttons, checkboxes and in the options where "0" or "1" are the only significant values
STRINGS are represented between double quotation marks:
/mxw/set info
When “name”
is contained in the available string variable, then the content is to be substituted with the actual name.
E.G. : to select and play a patch called “patch_one” from its name, the address /mxw/set
with tokens "play" "name_of_patch"
has to be used, resulting in this OSC command:
/mxw/set play patch_one
When OR is found it means that two options can deliver a similar result. One of the two formats has to be used at one time.
Set Reference
OSC ADDRESS | DESCRIPTION | EXAMPLE |
---|---|---|
mxw.millis |
returns the amount of milliseconds passed since opening the software | print_console("current passed time is" + mxw.millis );
|
mxw.width |
returns the current frame width in px | print_console("frame width is" + mxw.width );
|
mxw.height |
returns the current frame height in px | print_console("frame height is" + mxw.height);
|
mxw.outwidth |
returns current output width | print_console("frame height is" + mxw.height)
|
mxw.outheight |
returns the current output height | print_console("frame height is" + mxw.height);
|
mxw.framecounter |
returns the amount of frames rendered since opening the software | print_console("total number of frames rendered is" + mxw.framecounter);
|
mxw.dmx("channel_number") |
returns the DMX value received from the specified universe and channel | print_console("DMX value in u. 1, ch. 4 is" + mxw.dmx(1,4));
|
mxw.midi( |
returns the MIDI value received from the specified device and channel | print_console("MIDI value in dev. 1, ch. 6 is" + mxw.midi(1,6));
|
/mxw/beatbutton |
Send pulse to beat-button (BPM) | 1
|
/mxw/playlist info |
return information on the state of the playback of playlist | "info"
|