Two Axis Centred
Two Axis Centred controls provide simultaneous values for X and Y. Commands are sent when the value of the control is changed.
The range of values can be defined within control properties to be either positive or negative.
-
Two Axis controls with MIDI control methods can output up to 2 velocity ranges between 0 and 127.
-
Two Axis controls with sACN control methods can output up to 2 value ranges between 0 and 255.
-
The Multiplier Value will act as the range multiplier.
-
Two Axis controls declare the lower value to be the top/left position and upper value the bottom/right position of the slider handle.
-
Centred types declare the central position as 0,0.
When using MIDI for position co-ordinates the first two output methods defined will populate with the X and Y axis.
Action Map
The action map below details the point at which commands are sent
Touch Ready | Touch Begin | Touch Move (Two Axis) | Touch Release | Touch End |
X | X | On Mode | X | X |
Note: Double tapping the control will return it to it's default position. |
Control Methods
Type | On Mode | Example |
---|---|---|
MIDI | 2x MIDI Channel, Note, Velocity | 2x Channel:1 - Note:60 - Velocity:0 to 127 |
OSC | OSC Message [Double] [Double] , Patch | /ctrl/slider (Values auto added) |
HTTP | HTTP Address [Double] [Double] use $1 $2 , Patch | /ctrl.php?x=$1&y=$2 (Values $1, $2) |
TCP | TCP String [Double] [Double] use $1 $2 , Patch | /ctrl/tcp $1 $2 (Values $1, $2) |
UDP | UDP String [Double] [Double] use $1 $2 , Patch | /ctrl/udp $1 $2 (Values $1, $2) |
sACN | 2x sACN Channel - use $1 $2 | 2x Channel:1 - Level:0 to 255 |
OSC API Methods
Use external applications to operate this control using the OSC API.
Send the string /ctrl/control/[uid]/[command]
with the control's UID and selected command.
The default port for Ctrl for iPads OSC API is 53000
. This can be modified by navigating to the settings menu and modifying the global OSC input port. The list of commands for this control are shown below:
Command | |
---|---|
/enabled [Int] | Enable or disable the control (0 - Disabled, 1 - Enabled) |
/theme [Int] | Change the theme of the control (Int 1 to 14) |
/theme [Int] [String] | Change the theme of the control using custom palette name (Int 1 to 14) |
/label [String] | Change the label on the control for the session |
/flash [Int] | Set the control to flash to indicate attention is required (0 - Off, 1 - On) |
Alternatively, you can create a Custom OSC Binding for this control for any of the attributes listed above.