Remote Control/ OSC

Mobile Devices - Remote Control via OSC
mapstard.com

Using mobile device Remote Control via OSC, Maps can be designed, Media playback can be started, DMX Channel Values can be set, Presets can be loaded and many other mapstard features can be remotely controlled.
Mapstard remote control is also very useful to setup complex mappings, where the projection targets are not visible from the stage direction.
One can walk around and draw the map via mobile device directly on the output.
Remote control via smart-phone or tablet is achieved by using OSC Control Surface Apps - (OSC - Open Sound Control).
Mapstard provides an easy OSC Setup mode, so that any OSC Control Surface App can be used.
Different remote Control Setups, specific for different tasks or mobile devices, can be saved- and loaded from file.

A layout for TouchOSC, an Android/ IPhone App, is available in the application installation folder.
More info about TouchOSC: http://hexler.net/software/touchosc, or in the relative App store, search for TouchOSC.

Remote Control User Interface

To create your OSC Setup

Configure the Computer IP Address and Port, then click on menu [OSC > Open Connection].
Do the same Computer IP Address and Port configuration in your mobile device OSC Control App,
then start a user interface and move a Slider/Fader, or tap a button.
If the connection is successful, the OSC Message Log displays the commands received from your mobile device.
Start Recording Commands via the [Setup] Menu and by tapping/moving the desired Button/Sliders/Faders in your OSC Control App.
Save your OSC Setup to file: different OSC Setups, specific for different tasks or mobile devices, can be saved- and loaded from file.

OSC Menu	OSC connect and Setup file save/load
New Setup	Reset current OSC Setup and create a new empty OSC Setup
Load Setup	Load OSC Setup from file
Save Setup	Save OSC Setup to file
Save Setup As	Save OSC Setup to file with different location or filename
Open Connection	Open the OSC Connection with parameters defined in Computer IP Address and Port. The same connection parameters must also be entered in your mobile device OSC control surface App.

Setup Menu Overview	The [Setup] Menu enables to record OSC commands from your mobile device OSC Control Surface App.
Record Command: Application Handling	Record OSC commands on Mapstard Application level: Play, Pause, Stop, Quit, Restart
Record Command: Project Handling	Record OSC commands on Mapstard Project level: Save, Undo, Redo, Set Time etc.
Record Command: Map Control	Map drawing and manipulation: Select Maps, move Map Points, Draw Maps etc.
Record Command: Set Media	Start Media playback on selected Map(s): Media Playback Control
Record Command: Set Map Color	Mapping Color and Alpha: Set Map and Map Point Color and Alpha
Record Command: DMX	DMX Control: Control DMX Channel Values

Mapstard Touch OSC Interface

Mapstard TouchOSC interface and OSC Setup can be found in the installation folder:

mapstard.mapstard_OSC - Mapstard OSC Setup to be loaded via menu [OSC > Load Setup]
mapstard.touchosc TouchOSC Interface to be loaded to mobile device
For more information about loading the mapstard TouchOSC interface to your mobile device please see http://hexler.net/software/touchosc documentation.

To work with Mapstard TouchOSC interface

Load the mapstard.mapstard_OSC via menu [OSC > Load Setup]
Connect OSC via menu [OSC > Open Connection]
Open TouchOSC mapstard interface on your device
Move any sliders or tap on any button on your TouchOSC mapstard interface
if no messages are received in mapstard, check Computer IP Address and Port Configuration on both sides - computer and mobile device.

Note: Some buttons in Mapstard TouchOSC interface are not yet configured, since they are end user specific.
The buttons can be configured, as any other OSC Control Surface, by using the [Setup] Menu.

Map Drawing and Editing Interface

XY panel: Cursor on Output Window

X/Y sliders: small horizontal/vertical step cursor move

move: Toggle Move mode On=move selected points, Off=move cursor only
save: Save Project File
undo/redo: changes

m: Merge Map Points

draw: Tap to add Map in Draw Mode

point: Set Map Point when in Draw Mode

line: New Map Line when in Draw Mode

sel: Select Point

all: Select All Map Points

desel: Deslect All

edit: Toggle Map Edit Mode On/Off

+/-: Increase/Decrease Map Quality (Point Count)

del: Remove selected Map(s)

R/G/B/A Color and Alpha Component of selected Map(s) and Map Point(s)

O1-O8: activate Output Window 1 trough 8

Map Selection and Media Playback Interface

select map
Configure the Map Selection Control to fit your needs
set media
Configure the Media to be set

fade
Master Output Window fade to black

DMX Control Interface

DMX channels
Control one ore multiple DMX Channels with the sliders.
DMX positions
Store and recall DMX Channel Values with one button tap.

Setup DMX Control to fit your needs

Playback Control 1

map
Control Preset or Playlist Item Loading
map
Control Map selection

media
Control Media Playback on Map

Note: This functions need to be Setup first.

R/G/B/A
Color and Alpha Components of selected Maps

show/hide
Shows/Hides selected Maps by setting Alpha Value

random
Random Color

mapstard time
Time slider - scroll playback time
fade
Master Output Window fade to black

Playback Control 2

buttons
Setup the buttons to fit your needs.
fade
Master Output Window fade to black

Setting up OSC Commands

Setup Menu
Record Command: Application Handling	Record OSC commands on Mapstard Application level	OSC App Surface
Play	Command to start playback Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Pause	Command to pause playback Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Stop	Command to stop playback Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Quit	Command to quit Mapstard Application Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Restart	Command to restart Mapstard Application Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Record Command: Project Handling	Record OSC commands on Mapstard Project level	OSC App Surface
Save Project	Command to save Mapstard Project to current file. Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Undo	Undo changes like Map or Map Point movements, Map drawing steps etc. Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Redo	Redo changes, see above Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Set Time	Set the current playback time, scroll back and forth in timeline Usage: Start recording by clicking on this menu item Move desired Slider/Fader in in your OSC Control App Recording stops automatically	Slider/Fader
Load Preset, Preview Preset, Next Preset and Previous Preset	Load Preset, Map position, Media Playback, DMX Channel Values Usage: Start recording by clicking on this menu item Load the desired Preset via the Preset Panel Tap once on the desired Button in your OSC Control App Continue with next Preset Click [ Stop Recording] when done	Button one per Preset
Preset Lock Media On (Global)	Toggle Preset Global Media Lock On Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button one per Setup
Preset Lock Media Off (Global)	Toggle Preset Global Media Lock Off Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button one per Setup
Load Playlist Item, Next Playlist Item, Previous Playlist Item	Load Playlist Item Usage: Start recording by clicking on this menu item Load the desired Playlist Item via the Playlist Editor window Tap once on the desired Button in your OSC Control App Continue with next Playlist Item Click [ Stop Recording] when done	Button one per Playlist item
Output Fade	Fade to black output windows Usage: Start recording by clicking on this menu item Move desired Slider/Fader in in your OSC Control App Click [ Stop Recording] when done	Slider/Fader one for all Output Windows
Full Screen	Full Screen Toggle for Output Windows Usage: Start recording by clicking on this menu item Tap once on the desired Button in in your OSC Control App Recording stops automatically	Button
Kill Animation	Kill Keyframe Animation in Current Project on all Map(s), DMX Channel(s) and Audio in all Layers Usage: Start recording by clicking on this menu item Tap once on the desired Button in in your OSC Control App Recording stops automatically	Button one per Setup
Record Command: Map Control	Map drawing and manipulation	OSC App Surface
Map Edit On/Off	Turn Map Edit State On/Off - show mapping grid for manipulation Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Select Output	Select output window Usage: Start recording by clicking on this menu item Select the desired Output Window by clicking on it Tap once on the desired Button in your OSC Control App Continue with next Output Click [ Stop Recording] when done	Button one per Output Window
Select Map	Remote Control Map Selection - Select map one by one or grouped. Note: This command can be used to deselect all Map(s) and Map Points: Record a Command Button with no Map(s), Map Points selected Usage: Start recording by clicking on this menu item Select the desired Map(s) Tap once on the desired Button in your OSC Control App Continue with next Map(s) Click [ Stop Recording] when done	Button one per Map or one for multiple Maps
Select Map Point	Select the Map Point underneath the mouse cursor which can also be remotely controlled by OSC Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Select All Map Points	Select all Map Points of Maps where at least one Map Point is selected. Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Mouse Position	Control mouse cursor position Usage: Start recording by clicking on this menu item Move cursor on the XY Panel in your OSC Control App Recording stops automatically	XY Panel
Move On/Off	Toggle Map Move Mode On/Off - If On, selected Maps and Map Points can be moved via Mouse Position Usage: Start recording by clicking on this menu item Tap once on the desired Toggle Button in your OSC Control App Recording stops automatically	Toggle Button (On/Off)
Move X	Small step horizontal mouse cursor and Map movement. Usage: Start recording by clicking on this menu item Move desired Slider/Fader in in your OSC Control App Recording stops automatically	Slider/Fader
Move Y	Small step vertical mouse cursor and Map movement. Usage: Start recording by clicking on this menu item Move desired Slider/Fader in in your OSC Control App Recording stops automatically	Slider/Fader
Merge Map Points	Merge selected Map Points Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Increase Map Quality	Double Map Point count for higher quality media rendering, Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Decrease Map Quality	Half Map Point count, decrease media rendering quality Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Draw Map On/Off	Add a new Map in draw mode Usage: Start recording by clicking on this menu item Tap once on the desired Toggle Button in your OSC Control App Recording stops automatically	Toggle Button (On/Off)
Draw Map Set Point	Set a Map Point in drawing mode Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Draw Map Add New Line	Add a new line to Map - see Mapping Topic for details Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
Remove Map	Remove selected Map(s) Usage: Start recording by clicking on this menu item Tap once on the desired Button in your OSC Control App Recording stops automatically	Button
		OSC App Surface
Record Command: Set Media	Start Media playback on selected Map(s) Usage: Start recording by clicking on this menu item Select the desired Media in Layer Media Panel Tap once on the desired Button in your OSC Control App Continue with next Media Click [ Stop Recording] when done	Button one per Media Item (Video/ Image/ Audio etc.)
Record Command: Set Map Color	Mapping Color and Alpha	OSC App Surface
Red	Set red color component Usage: Start recording by clicking on this menu item Move desired Slider/Fader in your OSC Control App Recording stops automatically	Slider/Fader
Green	Set green color component Usage: Start recording by clicking on this menu item Move desired Slider/Fader in your OSC Control App Recording stops automatically	Slider/Fader
Blue	Set blue color component Usage: Start recording by clicking on this menu item Move desired Slider/Fader in your OSC Control App Recording stops automatically	Slider/Fader
Alpha	Set alpha Usage: Start recording by clicking on this menu item Move desired Slider/Fader in your OSC Control App Recording stops automatically	Slider/Fader
Random	Randomize Color Usage: Start recording by clicking on this menu item Move desired Slider/Fader or Tap on desired Button in your OSC Control App Recording stops automatically	Slider/Fader or Button
Record Command: DMX	DMX Control	OSC App Surface
Change Channel Values	Change DMX channel value real-time Usage: Start recording by clicking on this menu item Select the desired DMX Channel(s) in Layer DMX Panel Move desired Slider/Fader or Tap on desired Button or Toggle Button in your OSC Control App Continue with next DMX Channel(s) Click [ Stop Recording] when done	Slider/Fader one per DMX Channel or one for multiple DMX Channels Button or Toggle Button to set DMX Channel Value 0 or 255
Set Channel Values	Set DMX channel value to defined values Usage: Start recording by clicking on this menu item Select the desired DMX Channel(s) in Layer DMX Panel Set DMX Channel Values to desired value Tap on desired Button in your OSC Control App Continue with next DMX Channel(s) Click [ Stop Recording] when done	Button one per selected DMX Channel multiple DMX channels possible

Stop Recording	Stop Recording Commands (see above)
Remove Current Command	Remove Current OSC command from Setup Usage: Tap/Move desired Button/Slider/Fader in your OSC Control App Tap/Move desired Button/Slider/Fader in your OSC Control App Click on this menu item