OSC Device
このコンテンツはまだ日本語訳がありません。
The OSC Device sends and receives Open Sound Control (OSC) messages for flexible, network-based control.
Creating OSC Devices
Section titled “Creating OSC Devices”An OSC Device is created in the same way as any other device type. Please see Creating device for step-by-step instructions on how to create a device, and select OscDevice from the menu of different device types. Alternatively, by default Disguise contains an OSC Device called osc 1, which can be selected from the Devices manager.
OSC Device properties
Section titled “OSC Device properties”
Receive
Section titled “Receive”The OSC Device can receive incoming messages on one port, from any number of devices.
Receive port
Section titled “Receive port”This property specifies the port number for incoming messages. By default this is port 7401.
For more information on setting the IP address, please see Set up IP addresses.
IP Filter
Section titled “IP Filter”This property filters incoming OSC messages by IP address; if set only messages from the given address will be processed. If left blank no filtering is performed.
The OSC Device can send to any number of devices, which can be specified via the Send Targets widget. Messages are queued and sent once per frame.
Supports Message Bundles
Section titled “Supports Message Bundles”If set, the Device will send all queued messages in one bundle instead of sending them separately.
Verbose Sending
Section titled “Verbose Sending”If set, the Device will log every outgoing message to the console. It is recommended that you turn this off for Devices which you expect to send on most or every frame.
Send Targets
Section titled “Send Targets”This table lets you specify one or more targets to send OSC messages to.
This is a human-readable name for convenience; it is not a hostname and is not used for addressing.
Address
Section titled “Address”The IP address of the machine to send messages to.
The port of the machine to send messages to. By default this is set to 7400.
Enabled
Section titled “Enabled”When checked, this target will be sent messages.
This column lets you delete a send target from the Device.
Network Info
Section titled “Network Info”This table shows the adapter name and IP addresses of all connected Network Interface Cards on the local machine for reference.
OSC Transport Control
Section titled “OSC Transport Control”For information how to use OSC expressions on the timeline please see the OSC Transport Control page.
OSC Applications
Section titled “OSC Applications”There are several applications available for iOS that are capable of sending OSC messages. Two applications that we recommend are Liine by Lemur and TouchOSC by hexler.net.
To download examples of TouchOSC and Lemur layouts please go to the OSC Downloads page.
Controlling layer properties with OSC
Section titled “Controlling layer properties with OSC”For information on how to use OSC expressions to control layer properties please see the Controlling layer properties with OSC page.
Example Workflow
Section titled “Example Workflow”Setting up a device to control Disguise through OSC
Section titled “Setting up a device to control Disguise through OSC”- Download the example Lemur layout from the Disguise Resources page.
- Download the Lemur application to the iPhone device that will be sending commands to Designer.
- Import the Lemur layout to your iPhone. If you are using a Mac computer you can AirDrop the layout to the iPhone and it will automatically import to Lemur. Otherwise, you can do it manually from the Lemur app settings.
- If you are using a Disguise server, configure your network settings to assign the IP of the server the OSC device will send commands to. If you are using a Designer machine, you can have it connected to a WiFi connection.
- Run your Disguise project.
- Right-click on the Devices editor.
- Press the + icon to create a new device, or to add the default loaded osc 1 device.
- Right-click on the device name to open its network configuration settings.
- Under the Send tab, add a Send Target for Disguise to send commands to. In the Lemur application, this IP can be accessed through the app’s settings as the “Lemur IP”.
- In the Lemur settings, set the OSC host as the IP address of your machine. This will be reflected under the Adapter tab in the OSC device window.
- Under the Receive tab’s Port field, assign the port number the Lemur app will send commands to. This is the number reflected in the Lemur OSC settings.
- Toggle an OSC command from the Lemur profile to see if the OSC device indicator turns green. That will verify the connection has been made.
- You can also create an OSC Tester device linked to your OSC device to verify the connection has been made.