Skip to main content

UDP Settings

These appear when a tracking row's provider is set to UDP. Expand the row's foldout to see them.

They fall into three groups: where the data arrives, how to read it, and where it goes in space.

Connection

SettingWhat it does
PortThe UDP port LABO listens on. Default 9750. Your sender must target this machine's IP and this port.

Tracking reads as lost 1.5 seconds after the last packet, so the row turning red mid-session means the sender stopped or the network dropped — not that the pose was bad.

Reading the packet

SettingWhat it does
Packet formatCsvText for comma-separated ASCII rows, BinaryFloat32 for a raw little-endian float array.
First value is timeOn when the first value of each sample is a timestamp in seconds and pose data starts at the second value.
Quaternion orderThe order of the four components of each rotation: XYZW or WXYZ.
Quaternion channels (stream order)Which body joint each group of four values drives. Add and remove channels with Add / Remove; each row is labelled Ch 0, Ch 1 and so on.

These are covered in full, with what a packet has to look like, in Wire format.

Quaternion order is not a cosmetic preference

Both conventions are in wide use and a packet gives no clue which one it holds — the four numbers look identical either way. Read them in the wrong order and rotations are scrambled rather than merely tilted. If a pose looks like nonsense rather than like a plausible body in a wrong orientation, check this setting first.

Placing the pose in space

SettingWhat it does
Axis conversionWhich coordinate convention your sender uses, so LABO can convert it to Unity's.
Heading offsetYaw correction — which way the participant was facing when the recording or session started.
Neutral referenceExpress every rotation relative to a captured static reference pose, instead of using raw orientations.
Calibration poseWhich static pose the participant was holding when that reference was captured.
Reference average (s)How many seconds of packets to average into the reference.
RecaptureCapture a fresh reference now. Only available in Play mode.

These four decide whether a correct stream lands as a correct pose, and they are where most UDP problems live. They get their own page: Coordinate frames.

Shared row settings

The UDP row also has the settings every tracking row has — Emit, Data Capture, Confidence, Bone length, Gizmos, and Joint rotation overrides. See Providers.

Defaults

Out of the box the row is set up for a full-body inertial suit sending processed data:

SettingDefault
Port9750
Packet formatCsvText
First value is timeOn
Quaternion orderXYZW
Axis conversionNedToUnity
Heading offset117
Neutral referenceOn
Calibration poseNPose
Reference average1 s
Quaternion channelsThe full-body 17-segment map

The bundled sample runs on these defaults unchanged, which is what makes it a useful baseline — see Running the sample.