Global Array DATA OSC

Module to automatically receive or send global arrays with OSC messages. See global-array-tutorial to learn how to use global arrays.

Typology of OSC messages

If you define an OSC address /usine/ this module will catch all messages /usine/1..N/ ,f with 1..N the index of the global array's value. For example /usine/1/ ,f for the first index (value 0), /usine/2/ ,f for the second index (value 1), etc.

But the module will also catch all messages with the typology /usine/ ,fffff, each value of the message corresponding to its respective index in the global array. A particular case is the message /usine/ ,f which affects the first value of the global array.

On emission (sending OSC), the module will send all values as separated OSC messages /usine/1/ ,f for the first value, /usine/2/ ,f for the second, etc.

Settings

name

Name of the global array.

name suffix

Defines if a suffix is added automatically at the end of the name to produce names like MYARRAY-1, MYARRAY-2,etc.

  • no suffix
  • poly voice num - 1: number of the voice in a poly sub-patch.
  • rack num - 1: number of the current rack.
  • patch num - 1: number of the current patch.

old names

List of alternate names for the global-array as a comma-text. Use this field if the global-array has been renamed and you want to ensure a backward compatibility of files and presets. If the global-array values can't be retrieved during the loading procedure (because its name has changed), Usine will lookup into the list of old names.

address

Osc address string of the message.

Be careful, the OSC address string is key sensitive. It mean that /USINE/ is not equal to /usine/.

type

Type tag of the OSC messages.

  • f : float values
  • i : integer values
  • i trigger : the incoming integer value is considered as a trigger. It means that when a 1 value is received, it will be reset to 0 at the next calculation cycle of Usine.

    osc tag size

    Size (number of values) expected to fill the global array. For example if the global-array is a X-Y-Z array the expected tag is ,fff so the osc-tag-size is 3.

host

IP address of the remote computer (to send data).

Active only if the broadcast option is OFF.

host port

Remote Port destination number of the message.

broadcast

  • If this option is activated, the OSC message is sent to all the computers connected to the local network.
  • If not activated the message is sent at the address specified in the ip name field.
broadcast or not ?

In OSC when you want to send a data to another computer you normally have to know the network (IP) address of the destination. Something like 192.168.1.5.

The problem is that, by default, routers are configured to allocate IP addresses dynamically. In other word their IP aren't fixed and can change if, for example, you have to reboot one of your computer or your router. When broadcast is ON data's are sent to all the computers of the network at the same time whatever their IP address. So you don't have to deal with IP addresses and you're sure that all the computers will receive the message.

The main drawback is that if you have 20 computers connected you'll probably overload the network.

So if we resume broadcast ON is cool for small networks, let say, less than 10 computers. For larger networks, disable this option (OFF) and use the IP address field to set the destination of the message.

receive OSC active

Enables the reception of OSC messages for the global array.

base index

Global array start index which receives the OSC values.

data received

Sends 1 value when a valid OSC messages is received for the global array.

index received

List of received values indexes as an array of integers.

values received

List of received values as an array.

send OSC active

Enables the sending of OSC messages for the global array.

resend all

Forces to resend all OSC messages.

inverse value (1-value)

The value is inverted on receive and send by a 1-VALUE operation. For example, if the value received is 0.3 the final value of the global array will be 1 - 0.3 = 0.7

See also

version 5.2.221206

Edit All Pages