Isadora Manual v1.3 - TroikaTronix

If you are transmitting data between two programs running on the same computer,
you can use the special address localhost (which translates to an IP address of
127.0.0.1) to indicate that the data will be transmitted locally. This should work
even if you computer is not connected to a router or switch via a built-in Ethernet
interface or via a wireless interface.
If you intend to send Open Sound Control packets between two computers, the first
step is to ensure that both computers have been assigned a valid TCP/IP address.
On MacOS X, you can find the TCP/IP address of your computer by opening the
System Preferences and clicking on Network. You will then see the active TCP/IP
interfaces on your computer (e.g., built-in Ethernet, AirPort, etc.) and their IP
Addresses. Any of these addresses may be used to receive data.
Receiving Open Sound Control Packets
Generally speaking, when sending messages from another computer, you will
specify three pieces of information to define where the information will go: the
target machine’s IP address (i.e. an internet address like 123.234.555.121), a UDP
port number between 1 and 65535, and the OSC address (i.e. /isadora/1). You also
usually need able to specify whether or not to send “type tag” information with the
OSC packet – this must be turned on for Isadora to receive the packets and
interpret them correctly.
Isadora has 100 Open Sound Control addresses to which data may be sent. They
range from /isadora/1 through /isadora/100. Isadora expects receive either floating
point or integer numbers on these inputs. The type tag must be sent with the data,
or the message will be ignored. The OSC Listener actor will receive values sent to
these channels based on the channel setting, e.g., a value sent to /isadora/5 will be
received by the OSC Listener with its channel set to 5. (For more information on
the OSC Listener, see Page 339).
In addition, there are four “multi” inputs – /isadora-multi/1 through /isadoramulti/4.
On these four ports, you can send a message with a list of multiple floats
and/or integers. Again, the type tag must be sent with these messages, or the
message will be ignored. The individual values will be sent sequentially to a range
of OSC inputs. For example, if a message consisting of two integers and two floats
Isadora Manual
5 525 1.234 5.869 (type tags = iiff)
were sent to /isadora-multi/1, the OSC Listener actors with their channels set to 1,
2, 3 and 4 will receive 5, 525, 1.234, and 5.869 respectively. If the same message
were sent to /isadora-multi/2, the values would appear on channels 100-103.
The TCP/IP “Port Number” used to receive OSC messages can be set in the
Preferences. (See Page 128 for more information.) When receiving values from
another application, the port number specified when transmitting the data must
match the one set in Isadora’s Preferences.
174