Skip to main content

Guarded Button

Guarded Buttons are special types that require positive action for three seconds before triggering an output.

Action Map

The action map below details the point at which commands are sent

Touch ReadyTouch BeginTouch Hold (after 3 secs)Touch ReleaseTouch End
XXOn ModeXX

Control Methods

TypeOn ModeOff Mode
MIDIMIDI Channel, Note, VelocityN/A
OSCOSC Message, PatchN/A
HTTPHTTP Address, PatchN/A
TCPTCP String, PatchN/A
UDPUDP String, PatchN/A
sACNsACN Patch, Channel, ValueN/A
AudioAudio ID, VolumeN/A
VideoVideo, Layer, Volume, Scale X, Scale Y, Position X, Position Y, OpacityN/A

API Methods

Use external applications to operate this control with the API via OSC.

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.

OSC Commands

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
/label [String]Change the label of the control for the session name (Int 1 to 14)
/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.