コンテンツにスキップ

RTTrPM Driver

このコンテンツはまだ日本語訳がありません。

RTTrPM (Real-Time Tracking Protocol – Motion) is an open-source protocol used to transmit real-time tracking information. It is the protocol used by BlackTrax and several other tracking systems.

Disguise systems can use RTTrPM data to drive real-time positional information inside a project, enabling content to follow performers, props, cameras or other tracked objects.

The RTTrPM Driver is a type of Position Receiver and is added through the standard workflow for a Position Receiver device.

Once an RTTrPM Position Receiver has been added to the project, Disguise can receive tracking data from any third-party manufacturer that supports the RTTrPM specification.

For a current list of devices that support RTTrPM, visit:
https://rttrp.github.io/RTTrP-Wiki/index.html

RTTrPM provides a structured set of motion-related values. Depending on the tracking system, an RTTrPM stream may include:

  • 3D position (X, Y, Z coordinates)
  • Orientation (directional facing or rotation of the tracked object)
  • Tracking confidence or quality metrics
  • Unique object identifiers
  • Timestamps for synchronising data across systems

Not all devices output every field, but all RTTrPM-compatible systems provide core 3D positional data.

  • Performer and Object Tracking

    RTTrPM can drive content that needs to follow a moving performer, prop or scenic element. This is commonly used for interactive media, spatial content alignment and dynamic projection mapping.

  • Camera Tracking

    When used with compatible tracking systems, RTTrPM can feed positional data into Disguise for virtual production or AR workflows that require accurate camera movement.

  • Multi-Object Support

    RTTrPM streams may include several tracked objects at once. These appear in Disguise as individual axes or tracked points, enabling multi-character or multi-prop workflows.

  • Confidence Handling

    Some systems provide tracking confidence values. These can be used within Disguise to influence logic, blending, or fallback behaviour.

  • Coordinate Alignment

    Ensure the tracking system’s coordinate space matches the Disguise stage space. Adjustments may be made within the Position Receiver or via project calibration.


Port

The UDP port on which the driver receives data. Set this to match the port configured on the sending device or controller.

IP filter (optional)

Restricts incoming data to a specific source IP address. Useful when several sources are present on the network, or to isolate a single sender. Leave blank to accept data from any IP.

Multicast address (optional)

The multicast group address used by your system. Only required when the sender is configured for multicast — enter the exact multicast address used by the emitter. Leave empty for unicast or broadcast configurations.


Developer Documentation