Chapter 8
Application messages

Application messages are accepted by the static OSC address /ITL.

8.1 Application management

ITLMsg PICT

EXAMPLE
when sending the message:

/ITL hello;

  the application will answer with the following message:

/ITL 192.168.0.5 7000 7001 7003

  when it runs on a host which IP number is 192.168.0.5 using the default port numbers.

8.2 Ports management

ITLPortsMsg PICT

Changes the UDP port numbers:

The int32 parameter should be a positive value in the range [1024-49150].
The default port, outport and errport values are 7000, 7001 and 7002.

NOTE
Error messages are sent as a single string.

8.3 System support

ITLSystem PICT

8.4 Application level queries

The application supports the get messages for its parameters (see section 6 p.52). In addition, it provides the following messages to query version numbers.

ITLRequest PICT

EXAMPLE
Querying INScore version:

/ITL get version;

  will give the following as output:

/ITL version 1.00

8.5 Application static nodes

The application level provides the static nodes - stats, debug and log, available at /ITL/stats/ITL/debug and /ITL/log to help debugging communication and INScore scripts design.

8.5.1 The ’stats’ nodes

ITLStats PICT

EXAMPLE
Answer to a get message addressed to /ITL/stats

/ITL/stats osc 15 udp 10

8.5.2 The ’debug’ nodes

The debug node is used to activate debugging information.

ITLdebug PICT

EXAMPLE
Error messages generated on error port in debug mode:

error: incorrect OSC address: /ITL/stat
error: incorrect parameters: /ITL/scene/foo unknown 0.1
error: incorrect parameters: /ITL/scene/foo x "incorrectType"

8.5.3 The ’log’ nodes

The log node controls a console window that display all the messages sent to the OSC error port. Typical content is given by the example above.

ITLLog PICT

8.5.4 The ’plugins’ nodes

The plugins node controls the search path for plugins. See section 20 p.211 for more information on plugins and search strategies.

ITLPlugin PICT