(Formatting and Numbering improved)
Line 1: Line 1:
== Controlling Unity with IanniX ==
 
 
 
This is a step by step tutorial on how to use IanniX to control 100 objects in Unity using 50 cursors and 50 triggers in Unity 3D.
 
This is a step by step tutorial on how to use IanniX to control 100 objects in Unity using 50 cursors and 50 triggers in Unity 3D.
  
=== Overview ===
+
In this tutorial we will set up IanniX on one computer (the sender) and Unity on another computer (the receiver). We will then use IanniX to play a musical score, which will be interpreted and performed by Unity 3D.
 
 
In this tutorial we will set up IanniX on one computer (the sender) and Unity on another computer (the receiver).
 
We will then use IanniX to play a musical score, which will be interpreted and performed by Unity 3D.
 
  
=== PART 1: Preparations ===
+
== Preparations ==
 
# Make sure Iannix is installed on the sender.
 
# Make sure Iannix is installed on the sender.
 
# Make sure Unity is installed on the receiver.
 
# Make sure Unity is installed on the receiver.
 
# Make sure that both computers can connect (use ping)
 
# Make sure that both computers can connect (use ping)
  
=== PART 2: Setting up the Sender ===
+
== Setting up the Sender ==
 +
=== Open the Rosette Example in IanniX ===
  
==== STEP 1 on the Sender:<br>Open the Rosette Example in IanniX ====
+
'''On the sender:'''
 
# In the IanniX inspector open the <code>FILES</code> tab, pick <code>Examples</code> > <code>Rosette</code> (double click)
 
# In the IanniX inspector open the <code>FILES</code> tab, pick <code>Examples</code> > <code>Rosette</code> (double click)
 
# Click OK, to create the default rosette with 50 circles.
 
# Click OK, to create the default rosette with 50 circles.
 
# You can play the example (hit space bar) and reset it (press F)
 
# You can play the example (hit space bar) and reset it (press F)
  
==== STEP 2 on the Sender:<br> Configure Yannix to send messages to Unity ====
+
=== Configure Yannix to send messages to Unity ===
 +
'''On the sender:'''
 
# In Iannix, go to the inspector, pick the <code>CONFIG</code> tab, and the <code>NETWORK</code> tab below it.
 
# In Iannix, go to the inspector, pick the <code>CONFIG</code> tab, and the <code>NETWORK</code> tab below it.
 
# Make sure that <code>enable OSC</code> is checked
 
# Make sure that <code>enable OSC</code> is checked
Line 26: Line 23:
 
# Make sure the remote port is set to `57120`, which is the default port used by IanniX.<br>This is the port where IanniX will send its OSC messages.
 
# Make sure the remote port is set to `57120`, which is the default port used by IanniX.<br>This is the port where IanniX will send its OSC messages.
  
=== PART 3: Setting up the Receiver ===
+
== Setting up the Receiver ==
  
==== STEP 1 on the Receiver:<br>Install the Iannix-Unity Patch ====
+
=== Install the Iannix-Unity Patch ===
 +
'''On the receiver:'''
 
# Create a new Unity Project
 
# Create a new Unity Project
 
# On the receiver, download the [https://github.com/bitcraftlab/iannix-unity/archive/master.zip zip file] with the Iannix-Unity Scripts and extract it.
 
# On the receiver, download the [https://github.com/bitcraftlab/iannix-unity/archive/master.zip zip file] with the Iannix-Unity Scripts and extract it.
 
# Add the scripts and plugins folder to project assets in Unity
 
# Add the scripts and plugins folder to project assets in Unity

Revision as of 10:26, 4 May 2016

This is a step by step tutorial on how to use IanniX to control 100 objects in Unity using 50 cursors and 50 triggers in Unity 3D.

In this tutorial we will set up IanniX on one computer (the sender) and Unity on another computer (the receiver). We will then use IanniX to play a musical score, which will be interpreted and performed by Unity 3D.

Preparations

  1. Make sure Iannix is installed on the sender.
  2. Make sure Unity is installed on the receiver.
  3. Make sure that both computers can connect (use ping)

Setting up the Sender

Open the Rosette Example in IanniX

On the sender:

  1. In the IanniX inspector open the FILES tab, pick Examples > Rosette (double click)
  2. Click OK, to create the default rosette with 50 circles.
  3. You can play the example (hit space bar) and reset it (press F)

Configure Yannix to send messages to Unity

On the sender:

  1. In Iannix, go to the inspector, pick the CONFIG tab, and the NETWORK tab below it.
  2. Make sure that enable OSC[[OSC|Open Sound Control]] is checked
  3. Below set DEFAULT IP1. Internet Protocol 2. Intellectual property to the IP1. Internet Protocol 2. Intellectual property of your target machine
    (Use 127.0.0.1 if you run both programs on the same machine)
    This is the machine where IanniX will send its OSC[[OSC|Open Sound Control]] messages
  4. Make sure the remote port is set to `57120`, which is the default port used by IanniX.
    This is the port where IanniX will send its OSC[[OSC|Open Sound Control]] messages.

Setting up the Receiver

Install the Iannix-Unity Patch

On the receiver:

  1. Create a new Unity Project
  2. On the receiver, download the zip file with the Iannix-Unity Scripts and extract it.
  3. Add the scripts and plugins folder to project assets in Unity