The main interface of TouchOSC can be in one of two modes, Editor and Control Surface mode.
Switch to control surface mode by pressing the play button in the editor Toolbar, and the circle icon button in the control surface to switch back. On desktop platforms the CTRL/CMD+E keyboard shortcut can be used to toggle between both modes.
The position of the circle button in the control surface can be configured in the preferences.
The main control surface editing area is where most editing actions take places.
Right-clicking on an empty area of the document (or long-pressing on mobile platforms) will bring up the Create context menu for adding new controls.
Controls can be selected, either by directly pressing on a control's frame or using a lasso selection by pressing and dragging from an empty area of the document. With controls selected, the panel on the right will display context-sensitive information and properties depending on the type of selection and number of selected controls.
When resizing controls using the handles placed around the edges of the control's frame, on desktop platforms the following modifier keys can be held down to restrict the re-sizing behavior:
Right-clicking on the selection (or long-pressing on mobile platforms) will bring up the Edit context menu.
When a control is locked, it cannot be selected. A locked control can be unlocked using the document tree view.
Some types of controls are containers for other controls, selecting Edit container from the Edit context menu will descend into the container and display the contents for editing.
To exit editing a container, use the additional Exit container menu item of the Create menu, or double-click outside of the container's frame bounds in the editor.
The editor panel on the right will display a navigator view of the whole document, the document properties, a hierarchical document tree view of all controls, and, if any controls are currently selected, the control properties, values and messages of the current selection.
All sections of the editor panel can be collapsed and expanded using the section header bar.
On mobile platforms, the top of the panel holds an additional toolbar with functions that would usually be found in the window menu on desktop platforms.
From left to right, the functions are as follows:
The editor toolbar holds buttons and menus for various control surface editor functions.
NOTE that on mobile platforms with small screens there might not be enough horizontal space to display all toolbar buttons, in which case the toolbar can be scrolled by touch and slightly transparent, white overlays will be displayed at either end to indicate this.
From left to right, the functions are as follows:
The log view provides a way for various systems of the application to print information about the internal state. This can be helpful when troubleshooting problems or for confirming that configured connections or scripts are working correctly.
The log view will display:
Note: When the log view is opened, the application will enable a slower code path to print and format information about its internal state. This will cause a lot of additional processing to take place and will cause reduced run-time performance. We advise to only open the log view when troubleshooting problems during development.
The additional buttons in the top right provide the following functions, from left to right:
On desktop platforms, it is possible to open the log view in a separate window using an option in the preferences.
The Message Mapping dialog displays a sortable table of all MIDI, OSC, LOCAL and GAMEPAD messages configured for the current document.
Messages can be sorted by each column in the table by clicking/tapping on the table header and exported to a comma-separated format (CSV) using the Export button.
Double-clicking or tapping any row in the table will close the dialog and select the control that the message is owned by in the control surface editor view.
The columns for each type of message are as follows:
The Font Viewer provides a way to browse all characters of the typefaces included with the application.
The application embeds a number of fonts available in all versions for all platforms, to guarantee that any document shared between operating systems and platforms will be rendered exactly the same - without errors or missing symbols.
At the top there is a choice of two styles of typefaces, Default and Monospaced, analogous to the font property of TouchOSC's Label and Text controls.
Clicking or tapping any character in the font viewer will copy that character to the clipboard.
When rendering any character, TouchOSC will search for it in a series of fallback typefaces:
Unchecking the Include fallback fonts option will limit the display of characters to the first font in the fallback chain only.
Note that this option only affects the display in the font viewer and not the rendering of Label and Text controls.