/
Stream data using Open Sound Control

Stream data using Open Sound Control

Tracker enables you to stream data from Tracker over UDP using the Open Sound Control (OSC) format, so that you can access live data in your OSC server application.

To access the OSC data streaming options:

  1. On the View menu, ensure Connections is selected.
  2. In the Connections panel, go to the Output Settings properties to find the OSC section.
  3. At the top right of the OSC section, ensure the Advanced properties are displayed.
    The data available for output is a subset of the data available using the DSSDK.

Important:
To stream device data, you must give the device a name.

OSC stream properties

You can view or change these OSC streaming settings:

Property Description
Enabled Turns streaming on or off
Address Address used to create the outbound socket
Port Port number used to create the outbound socket
Buffer Size Size of the buffer to allocate to store a frame's worth of data
Objects, Markers, Unlabeled Markers, Centroids, Devices Turn on/off output for the specified data types
Use Object Name If a single subject is loaded, this option enables you turn on/off the subject name in the output message address (see Packet contents).
If multiple subjects are loaded, the subject name is always included as part of the message address.

Packet contents

Each packet consists of a bundle containing one or more messages. Each message has an address associated with it to identify its contents. The /vicon/frame message is always generated; other messages may or may not be present, depending on the output data types selected.

Full address
(Base in bold)
Tracker property DSSDK type Data values Description
/vicon/frame NA Output_GetFrameNumber
Output_GetFrameRate
Output_GetTimecode
long - Frame Number
float - Frame Rate
int32 - TimecodeHours
int32 - Timecode Minutes
int32 - Timecode Seconds
int32 - Timecode Frames
int32 - Timecode Subframes
int32 - Timecode Field Flag
int32 - Timecode Standard
int32 - Timecode SubframesPerFrame
int32 - Timecode UserBits
Always present in the bundle. Timecode values are only present if the application has timecode enabled.
/vicon/seg/SUBJECT/SEG_NAME
/vicon/seg/SEG_NAME
Enable Segments Output_GetSegmentGlobalTranslation
Output_GetSegmentGlobalRotationMatrix
float(3) - Translation
float(9) - Rotation matrix
SUBJECT: Subject Name
SEG_NAME: Name of the segment
If the Subject Name property is cleared and a single subject is loaded, the SUBJECT portion of the address is omitted. In all other cases it is present.
/vicon/marker/SUBJECT/MARKER_NAME
/vicon/marker/MARKER_NAME
Enable Markers Output_GetMarkerGlobalTranslation float(3) - Translation SUBJECT: Subject Name
MARKER_NAME: Name of the marker
If the Subject Name property is cleared and a single subject is loaded, the SUBJECT portion of the address is omitted. In all other cases it is present.
/vicon/unlabeled/N Enable Unlabeled Markers Output_GetUnlabeledMarkerGlobalTranslation float(3) - Translation N: A number starting at 0
Unlabeled marker numbers are arbitrary so you can't assume that the same unlabeled marker will be given the same number frame-to-frame.
/vicon/2D/CameraID Enable Centroids Output_GetCentroidPosition int32 - Number of centroids
For each centroid:
float(2) - Position
float - Radius

/vicon/device/NAME/OUTPUT/COMPONENT Enable Devices Output_GetDeviceOutputValue int32 - Number of samples
For each sample:
float - Device output value
NAME: Device name
OUTPUT: Device output name
COMPONENT: Device output component name

Related content


© Copyright Vicon Motion Systems. All rights reserved.

Vicon trademarks