What is OSC?
"Open Sound Control (OSC) is a protocol for communication among computers, sound synthesizers, and other multimedia devices that is optimized for modern networking technology. Bringing the benefits of modern networking technology to the world of electronic musical instruments, OSC's advantages include interoperability, accuracy, flexibility, and enhanced organization and documentation." Read more here.
How does TouchOSC work with Lightform Creator?
You can communicate with the Lightform device using OSC messages. Each effect has various exposed parameters that you can adjust (e.g., speed and size). To get Lightform Creator ready for OSC messages:
- go to the Help menu and enable Labs in Lightform Creator
- when an effect or generator has been applied to a surface, in its properties enable Live
Now the effect/generator will be computed in real-time during project playback by the Lightform device and you can adjust the effect's parameters using OSC messages simultaneously during playback.
Learn more about Editing OSC Mappings in Lightform Creator.
Using the TouchOSC Mobile App
Step 1 Download the TouchOSC Mobile App
To learn more about TouchOSC visit their website.
Step 2 Configure TouchOSC
Once you have the TouchOSC app downloaded and installed on your mobile device
- Connect your mobile device to the same WiFi network that your Lightform device and computer are connected to
- In the TouchOSC app, tap the OSC line under CONNECTIONS and enter the following information:
Hostname: <Your Lightform device IP address> (You can find your device's IP address in Lightform Creator on the Control Page, or by looking on the projected Testcard.)
Outgoing Port: 8000
Incoming Port: 9099
- Press < TouchOSC in the upper left to go back to the main settings page
You should now be connected to your Lightform via OSC!
The Lightform device will not show up in 'Found Hosts' but if the information has been entered correctly, it will work
Step 3 Choose Layout
You can start by using the Lightform layout which can be downloaded here:
Install this file directly by downloading it on your phone.
Download the file to your computer, then use iTunes to copy the file to your phone.
Once the file is on your device, you need to set it as the current layout by tapping the line under Layout and selecting Lightform-0.9.6.
Tap < TouchOSC to return to the main menu and tap Done.
You can create custom layouts to have more control over your projects by downloading the TouchOSC Editor. Refer to the TouchOSC documentation for layouts to learn more.
When creating your own TouchOSC layout, if using buttons (e.g., for play/stop/next slide/etc), you must turn off "Send on Release" — see this article: https://hexler.net/docs/touchosc-controls-reference#push. If you don't do this, pressing and then releasing a button will generate 2 events (e.g., pressing a button for "next slide" would actually advance you 2 slides instead of 1).
Another thing to keep in mind is that TouchOSC only lets you define 1D and 2D sliders and toggle/momentary buttons. This means that not all of our OSC controllable parameters will work with Touch OSC.
With TouchOSC, you can use a fader (or most other controls) to control 1D parameters such as 'Line Width' or 'Zoom'. However, something like 'Hue/Sat/Lum. Offset' is 3D and therefore will not work with Touch OSC. The graphic below shows some examples of different parameter types.
Step 4 Map OSC Controls in Lightform Creator
Make sure you have Labs enabled and Live turned on (refer to the beginning of this tutorial for more details).
At the moment Lightform Creator only supports one Live effect per slide. The same surface can have a different Live effect on a different slide.
- Publish your project with at least one Live effect on
- Switch to the Control Page and open the OSC Mappings Window
- Click Learn next to the parameter that you’d like to connect to a control in the TouchOSC app
- Touch one of the buttons in the app or move one of the sliders to associate that control with the parameter that your Lightform device is learning
- Now when you use that control, the parameter will change in realtime on your Lightform device
Using the TouchOSC for Slide Management
The Lightform layout in TouchOSC can be easily used to control slide management and playback in a project.
- Set up your scene and in your project make sure you have more than one slide with content. In this demo, we are mapping a 3D object that has 3 slides, each with a different effect
- Publish your project and in the Control Page, click Edit OSC Mappings
- Click Learn next to Next Slide and hit the next icon on your mobile device.
Click Learn next to Previous Slide and hit the previous icon on your mobile device.
The address path will change from '/next' to '/playback/next' and from 'prev' to '/playback/prev'
- The effect is now mapped. Every time you press the icons on your mobile device, the Lightform will move between slides.
Using the TouchOSC for Manipulating Effects
The Lightform layout in TouchOSC can be easily used to manipulate effect and generator properties. In this demo, we are mapping a 3D object that has the Voronoi generator.
- Set up your scene and in your project make sure you have more at least one 'Live' effect or generator enabled.
- Publish your project and in the Control Page, scroll to the Slide number with the Live Voronoi effect properties
- Click Learn next to Variance and drag a slider on your mobile device.
Click Learn next to Width and drag another slider on your mobile device.
The address path will change from '/Slide/variance' to '/fader1' and from '/Slide/zoom' to '/fader4'
- The properties are now mapped. Every time you drag the sliders on your mobile device, the Lightform will change the variance and zoom level of the Voronoi effect.