Data transmission

Mocolo data transmission is based on UDP and OSC.

UDP (User Datagram Protocol) means each set of data being transmitted becomes a packet being sent on a network.

Mocolo packets are formatted using the OSC standard.

 

Each Mocolo analyzer can send data to many client application - for instance, in figure above analyzer 0 sends data to client applications A, B, C and D.

 

 

This allows, for instance, to simultaneously send data to a system creating interaction driven visuals, and to a system doing the same with audio.

 

 

Mocolo can also send data of different analyzers to the same client. This allows, for instance, to send analysis results of many cameras to a single client.

 

Note: every coordinate appearing in the packets is normalized, i.e. value ranges between 0.0 and 1.0, no matter the resolution of the camera being monitored.
All the weights are normalized too – the whole frame weights 1.0.

Packets format

Data packets are formatted using OSC (OpenSound Control) protocol.

Packets format

Mocolo packets are accomply to OSC standard, thus allowing mocolo to communicate with a wide variety of applications - find a list here.

Mocolo can send the following packets type.

 

Interactive Area Status packet format

• OSC Address: "mocolo2.0-areas"
• Integer: Analyzer ID
• Integer: Frame number
• Integer: N = number of interaction areas
• Integer: status of area 0
• Integer: status of area 1
• …
• Integer: status of area N-1

Presence Data packet format

• OSC Address: "mocolo2.0-presence"
• Integer: Analyzer ID
• Integer: Frame number
• Integer: N = number of centers
• Float: Coordinate X of center 0
• Float: Coordinate Y of center 0
• Float: Weight of center 0
• …
• Float: Coordinate X of center N-1
• Float: Coordinate Y of center N-1
• Float: Weight of center N-1

Motion Data packet format

• OSC Address: "mocolo2.0-motion"
• Integer: Analyzer ID
• Integer: Frame number
• Integer: N = number of centers
• Float: Coordinate X of center 0
• Float: Coordinate Y of center 0
• Float: Weight of center 0
• …
• Float: Coordinate X of center N-1
• Float: Coordinate Y of center N-1
• Float: Weight of center N-1

COGs packet format

• OSC Address: "mocolo2.0-cogs"
• Integer: Analyzer ID
• Integer: Frame number
• Float: Coordinate X of Presence COG
• Float: Coordinate Y of Presence COG
• Float: Weight of Presence COG
• Float: Coordinate X of Motion COG
• Float: Coordinate Y of Motion COG
• Float: Weight of Motion COG