Draft - Winter 2021 - TouchOSC Reference guide

Function:

TouchOSC is a third party application, designed by Hexler, that allows the configuration of layouts to control applications via the OSC protocol.
A layout is a collection of pages that contain different interactive pieces, such as push and toggle buttons, and sliders, allowing messages to be sent with a variety of argument types.
IglooWarper ships with a default TouchOSC layout for basic control of the Igloo and peripheral systems.

Layout - For Warper version 1.17.0

The Playback tab contains settings specific to movie playback; the current movie bar shows the filename of currently playing movie.

Restart restarts the playback of the currently playing movie.

Pause is a toggle that pauses/unpauses the currently playing movie.

Play plays the currently selected movie after it’s been stopped.

Stop stops the playback of the currently playing movie, changing to the canvas background colour and playing no audio.

Loop is a clip based setting and sets the currently playing movie to loop, restarting playback after reaching the end of the movie.

Prev/next frame allows a user to move through the individual frames of a movie.

Volume is a clip based setting that allows the volume to be changed. Normalised values sent 0->1. Mute cuts audio playback.

Chapter settings:

Movies can be split into chapters, allowing certain sections to hold a frame, loop, playback, or have different volumes to other sections of the same movie.

The Playhead bar updates with the playhead position of the movie, and acts as an indicator of how close to the end the movie is.

Prev chapter/ Next chapter: allow the current chapter to play out before moving on to the next chapter.

Force next chapter immediately jumps to the next chapter of a movie.

The Clips page emulates the clip banks put together on Igloo Control. Click on a Bank button to update clip names/change which clip bank is being viewed.

The Effects tab handles canvas-based settings.
Mask buttons turn on/off mask layers. A mask is a portion of the canvas that projects no colour, instead of the content.
Stretch Movie stretches the movie to fit the canvas width
Tile Movie repeats a movie on each projector. Movie must be the same width and height of the projectors.
Autoscale movie automatically scales the movie based on the defined canvas width and height. Used on out of aspect content like 4k/8k equirectangular content.
Start recording, Stop Recording and Screenshot can be used to generate movie and image files based on the content on the warper canvas
Annotation mode enables/disables annotation mode on the warper.
Image Position Y allows a movie to be moved up and down the warper canvas.
Image stretch amount stretches the movie on the Y axis
Wrap rotates the image around the space
Zoom stretches or squishes a movie in both the x & y axes
Tilt allows an equirectangular image to be “tilted” up and down, emulating looking up and down on equirectangular images
Gyro buttons allow the passed gyro data to affect either the wrap or tilt respectively

The Warping tab represents the different ways to manipulate the projected image.
To select a screen for warping, use the bar of red buttons at the top (Screen 1->6).
Each screen, by default has 12 control points:

The buttons at the edges of the central portion of the screen allow a user to select which control point is being manipulated. The central Nudge buttons move the control point in the specified direction. Nudging points has a direct impact on the content being displayed:

Small, medium and large change the number of pixels a point moves each nudge
Info loads the info panels displaying framerate information and defining the screen numbers.
Points shows and hides the control points
TCards shows and hides the test cards. Next cycles between the available test cards.
Overlap, Width and Gamma change the overlap percentage, area of gamma correction and gamma correction intensity on each screen uniformly
Blending, Warp On/Off and Movie player enable and disable gamma correction, warping and the movie player respectively.

The Load/Save tab allows the loading and saving of up to 3 sets of warps. Auto save saves only to the default warp set (last used warps, not stored in a save bank)

The projector tab allows the control of projectors from TouchOSC if the Warper is configured for projector control.
3D Mode On and Off turns 3D displays on and off on the projectors respectively.
3D Sync Invert On and Off swaps which eye’s worth of content is being shown each frame
DLP-Link and IR change the 3D Sync format
Frame Sequential, Top/Bottom, SBS (Side by side) and Frame Packing change the 3D Content format
Projector On/Off powers the projectors.

The capture inputs tab has settings related to spout channels from Igloo Capture and Igloo Web
The central grid represents the available capture inputs and will populate as inputs become available. Select an input and any effects will affect only that input.

Size scales the input in both axes, y-scale and x-scale scales in their respective axis..
The x/y grid in the top right changes the draw position of the input on the canvas.
Invert mirrors the input on the X-axis. Flip on the Y-axis
Stretch stretches the input to match the Warper Canvas.
Enabled shows/hides the input on the canvas.
Play and pause are video controls for the Video input.
Auto Scale automatically scales the input to match the aspect ratio of the Warper Canvas.
Bring to Front/Send to back changes the order of the Capture inputs on the warper canvas.
The bottom grid contain Bookmarks from Igloo Web. Clicking on one will load it. Youtube Play/Pause are video controls for Youtube videos viewed through Igloo Web

External inputs refer to spout channels that are not configured as capture inputs, such as those originating from the Unity/Unreal Camera package.
The bottom grid shows all available inputs. Select an input and any effects will affect only that input.
Y Position and Y Scale change the start draw position on the canvas and stretch the specific input respectively

Wrap rotates the input on the canvas.
Zoom scales the input on both axes.
Invert mirrors the input on the x-axis.