LPVISION HeadPose

Node ID: lpvisionHeadPose · Role: Source · Realtime config: no

Description

LPVISION head pose tracking using a Stereolabs ZED camera over UVC. Runs the HeadPoseTracker internally and outputs 6-DOF optical pose. No ZED SDK or CUDA required. For the camera IMU, add a separate ZED IMU node.

Inputs / Outputs

Inputs: (none)
Outputs: Optical

Config aliases

LpvisionSource, lpvisionHeadPose, lpvisionZedSdk

Properties

Each row shows the setting’s label in the node’s Properties panel and, in code, its key in the node’s settings object in the config file. A setting omitted from the config file uses the default shown here.

ZED Camera

Property	Type	Default	Description
Resolution `resolution`	select	`HD720`	ZED capture resolution. Higher resolutions cost more GPU and yield fewer FPS. Options: `VGA`, `HD720`, `HD1080`, `HD2K`.
FPS `fps`	number	`60`	Camera frame rate
Grayscale `grayscale`	toggle	`false`	Run the tracker on grayscale frames. Faster but reduces robustness in low-texture scenes.
Camera Interface `cameraInterface`	number	`0`	OS video capture index of the ZED UVC device
Baseline `baseline`	number	`120.0`	Stereo baseline in millimetres

Head Pose Tracker

Property	Type	Default	Description
Show Poses `showPoses`	toggle	`true`	Overlay the estimated poses on a debug window for visual inspection.
Filter Pose `filterPose`	toggle	`true`	Apply a smoothing filter to the output pose.
Filter Landmarks `filterLandmarks`	toggle	`true`	Apply smoothing to the detected 2D landmarks before pose estimation.

Head Tracking Output

Property	Type	Default	Description
Sender ID `senderId`	string	`headTracking`	Stream identifier for the optical pose output
Axis Preset (Optical) `axisPresetOptical`	select	`steamvr`	Coordinate-system preset applied to the optical pose output. ‘steamvr’ matches SteamVR’s convention; ‘identity’ leaves the raw frame. Options: `identity`, `steamvr`.
Position Offset X `positionOffsetX`	number	`0.0`	metres
Position Offset Y `positionOffsetY`	number	`0.0`	metres
Position Offset Z `positionOffsetZ`	number	`0.0`	metres

Advanced

Property	Type	Default	Description
Log Level `logLevel`	select	`error`	Options: `debug`, `info`, `warn`, `error`.
Auto Calibration `autoCalibration`	toggle	`true`
Camera Serial `cameraSerial`	string	`""`	Optional ZED serial number. Empty = auto-detect from local Stereolabs SDK cache.
Config File `configFile`	filepath	`""`	Path to an LPVISION JSON config file. When set, all settings above are ignored.

Example node definition

A minimal entry in config.json looks like the block below. Paste it under the sources key, keyed by an instance name of your choice. All settings are optional: anything not listed under settings uses the default from the Properties table above. See The configuration file for how the sections and endpoint wiring work.

{
  "sources": {
    "lpvisionHeadPose": {
      "outEndpoint": "inproc://lpvisionHeadPose_data",
      "settings": {}
    }
  }
}

Loading documentation…