This wiki is intended for older versions of Motive. For the latest documentation, please refer to
docs.optitrack.com

Difference between revisions of "Data Streaming Pane"
 
(27 intermediate revisions by the same user not shown)
Line 3: Line 3:
  
  
−
In Motive, the Data Streaming pane can be accessed under the [[Command_Bar#View tab|View tab]] or by clicking [[File:Tb17.png]] icon on the main toolbar.
+
In Motive, the Data Streaming pane can be accessed under the [[Command_Bar#View tab|View tab]] or by clicking [[Image:Toolbar Stream 20.png]] icon on the main toolbar.
  
 
For explanations on the streaming workflow, read through the [[Data Streaming]] page.
 
For explanations on the streaming workflow, read through the [[Data Streaming]] page.
Line 11: Line 11:
 
=OptiTrack Streaming Engine=
 
=OptiTrack Streaming Engine=
 
----
 
----
−
[[Image:DataStreaming_Pane_111.png|thumb|Data Streaming pane in Motive]]
+
[[Image:DataStreaming_Pane_21.png|thumb|Data Streaming pane in Motive]]
 
The OptiTrack Streaming Engine allows you to stream tracking data via Motive's free streaming plugins or any custom built NatNet interfaces. To begin streaming, select ''Broadcast Frame Data''. Select which types of data (e.g. markers, rigid bodies, or skeletons) will be streamed, noting that some third party applications will only accept one type of data. Before you begin streaming, ensure that the network type and interface are consistent with the network you will be streaming over and the settings in the client application.
 
The OptiTrack Streaming Engine allows you to stream tracking data via Motive's free streaming plugins or any custom built NatNet interfaces. To begin streaming, select ''Broadcast Frame Data''. Select which types of data (e.g. markers, rigid bodies, or skeletons) will be streamed, noting that some third party applications will only accept one type of data. Before you begin streaming, ensure that the network type and interface are consistent with the network you will be streaming over and the settings in the client application.
−
 
  
 
<div class="padded">
 
<div class="padded">
 
====Broadcast Frame Data====
 
====Broadcast Frame Data====
−
:(Default: False) Enables/disables broadcasting, or live-streaming, of the frame data. ''This box must be checked in order to start the streaming.''
+
:(Default: False) Enables/disables broadcasting, or live-streaming, of the frame data. ''This must be set to true in order to start the streaming.''
  
 
====Local Interface====
 
====Local Interface====
−
:(Default: loopback) Sets the network address which the captured data is streamed to. When set to local loopback (127.0.0.1) address, the data is streamed locally within the computer. When set to a specific network IP address under the dropdown menu, the data is streamed over the network and other computers that are on the same network can receive the data.
+
:(Default: loopback) Sets the network address which the captured frame data is streamed to. When set to local loopback (127.0.0.1) address, the data is streamed locally within the computer. When set to a specific network IP address under the dropdown menu, the data is streamed over the network and other computers that are on the same network can receive the data.
  
 
====Labeled Markers====
 
====Labeled Markers====
−
:(Default: True) Enables/disables, streaming of ''labeled'' Marker data in the frame. The markers are either point cloud solved or model filled.
+
:(Default: True) Enables, or disables, streaming of ''labeled'' Marker data. These markers are point cloud solved markers.
  
 
====Unlabeled Markers====
 
====Unlabeled Markers====
−
:(Default: True) Enables/disables streaming of all of the ''unlabeled'' Marker data in the frame. The markers are either point cloud solved or model filled.
+
:(Default: True) Enables/disables streaming of all of the ''unlabeled'' Marker data in the frame.
  
−
====Solver Replaces Occlusion====
+
====Asset Markers====
−
:(Default: True) Enables/disables streaming of named collections of identified markers and their positions (X, Y, Z). In other words, this includes markers that are associated with any of the assets (MarkerSet, Rigid Body, Skeleton). The streamed list also contains a special marker set named ''all'' which is a list of labeled markers in all of the assets in a''Take''
+
:(Default: True) Enables/disables streaming of the markerset markers, which are named collections of all of the labeled markers and their positions (X, Y, Z). In other words, this includes markers that are associated with any of the assets (MarkerSet, Rigid Body, Skeleton). The streamed list also contains a special marker set named ''all'' which is a list of labeled markers in all of the assets in a''Take''. In this data, skeleton and rigid body markers are point cloud solved and model-filled on occluded frames.
  
 
====Rigid Bodies====
 
====Rigid Bodies====
 
:(Default: True) Enables/disables streaming of rigid body data, which includes the name of rigid body assets as well as positions and orientations of their [[Rigid Body Tracking#Tracking Rigid Body|pivot points]].
 
:(Default: True) Enables/disables streaming of rigid body data, which includes the name of rigid body assets as well as positions and orientations of their [[Rigid Body Tracking#Tracking Rigid Body|pivot points]].
−
 
−
====Rigid Body Model Markers====
 
−
:(Default: True) Enables/disables streaming of ''Model Markers'' which represent the expected marker positions of rigid body assets in the scene.
 
  
 
====Skeletons====
 
====Skeletons====
−
:(Default: Skeletons) Enables/disables streaming of skeleton assets, if present.
+
:(Default: Skeletons) Enables/disables streaming of skeleton tracking data from active skeleton assets. This includes the total number of bones and their positions and orientations in respect to global, or local, coordinate system.
  
 
====Skeleton Coordinates====
 
====Skeleton Coordinates====
Line 44: Line 40:
  
 
====Skeleton as Rigid Bodies====
 
====Skeleton as Rigid Bodies====
−
:(Default: False) When set to true, skeleton assets are streamed as a series of rigid bodies that represent each skeleton segment.
+
:{{Advanced}} (Default: False) When set to true, skeleton assets are streamed as a series of rigid bodies that represent respective skeleton segments.
  
 
====Bone Naming Convention====
 
====Bone Naming Convention====
−
:(Default: FBX) Determines the bone naming convention of the streamed data among Motive, FBX, and BVH. The naming convention must match with the format used in the streaming destination.
+
:(Default: FBX) Sets the bone naming convention of the streamed data. Available conventions include Motive, FBX, and BVH. The naming convention must match the format used in the streaming destination.
 +
 
 +
:''Note:'' The default setting for this has been changed to ''FBX'' in Motive 2.0.
  
 
====Up Axis====
 
====Up Axis====
Line 53: Line 51:
  
 
====Remote Trigger====
 
====Remote Trigger====
−
:(Default: False) Allows using the remote trigger for the streaming.
+
:(Default: False) Allows using the remote trigger for recording using XML commands. See more: [[Data_Streaming#Remote_Triggering|Remote Triggering]]
  
 
====Type====
 
====Type====
Line 59: Line 57:
  
 
====Stream Subject Prefix====
 
====Stream Subject Prefix====
−
:{{Advanced}} (Default: True) When set to true, each marker label includes a subject prefix, which is the name of associated asset.
+
:{{Advanced}} (Default: True) When set to true, associated asset name is added as a subject prefix to each marker label in the streamed data.
  
 
====Stream Visual3D Compatible====
 
====Stream Visual3D Compatible====
−
:{{Advanced}} Enables streaming to Visual3D.  Normal streaming is not compatible with Visual3D, and this feature must be enabled in order to stream tracking data to Visual3D.  
+
:{{Advanced}} Enables streaming to Visual3D.  Normal streaming configurations may be not compatible with Visual3D, and this feature must be enabled for streaming tracking data to Visual3D.
  
 
====Scale====
 
====Scale====
−
:{{Advanced}} Sets the scaling for streamed skeletal data.
+
:{{Advanced}} Applies scaling to all of the streamed position data.
  
 
====Command Port====
 
====Command Port====
Line 75: Line 73:
 
====Multicast interface====
 
====Multicast interface====
 
:{{Advanced}}  Specifies the multicast broadcast address.  (Default: 239.255.42.99). '''Note:''' When streaming to clients based on NatNet 2.0 or below, the default multicast address should be changed to 224.0.0.1 and the data port should be changed to 1001.
 
:{{Advanced}}  Specifies the multicast broadcast address.  (Default: 239.255.42.99). '''Note:''' When streaming to clients based on NatNet 2.0 or below, the default multicast address should be changed to 224.0.0.1 and the data port should be changed to 1001.
 +
 +
====Multicast as Broadcast ====
 +
:{{Advanced}} '''Warning: This mode is for testing purposes only and it can overflood the network with the streamed data.''' When enabled, Motive streams out the mocap data via ''broadcasting'' instead of sending to Unicast or Multicast IP addresses. This should be used only when the use of Multicast or Unicast is not applicable. This will basically spam the network that Motive is streaming to with streamed mocap data which may interfere with other data on the network, so a dedicated NatNet streaming network may need to be set up between the server and the client(s).
 +
 +
:To use the broadcast set the streaming option to Multicast and have this setting enabled on the server. Once it starts streaming, set the NatNet client to connect as Multicast, and then set the multicast address to ''255.255.255.255''. Once Motive starts broadcasting the data, the client will receive broadcast packets from the server.
 
</div>
 
</div>
  

Latest revision as of 23:08, 8 August 2018

Back To Page References


In Motive, the Data Streaming pane can be accessed under the View tab or by clicking Toolbar Stream 20.png icon on the main toolbar.

For explanations on the streaming workflow, read through the Data Streaming page.

Info2.png

Advanced Settings

The Data Streaming Pane contains advanced settings that are hidden by default. Access these settings by going to the menu on the top-right corner of the pane and clicking Show Advanced and all of the settings, including the advanced settings, will be listed under the pane.

The list of advanced settings can also be customized to show only the settings that are needed specifically for your capture application. To do so, go the pane menu and click Edit Advanced, and uncheck the settings that you wish to be listed in the pane by default. One all desired settings are unchecked, click Done Editing to apply the customized configurations.

ShowAdvancedSettings.png EditAdvancedSettings.png EditAdvancedSettings Done.png

OptiTrack Streaming Engine

Data Streaming pane in Motive

The OptiTrack Streaming Engine allows you to stream tracking data via Motive's free streaming plugins or any custom built NatNet interfaces. To begin streaming, select Broadcast Frame Data. Select which types of data (e.g. markers, rigid bodies, or skeletons) will be streamed, noting that some third party applications will only accept one type of data. Before you begin streaming, ensure that the network type and interface are consistent with the network you will be streaming over and the settings in the client application.

Broadcast Frame Data

(Default: False) Enables/disables broadcasting, or live-streaming, of the frame data. This must be set to true in order to start the streaming.

Local Interface

(Default: loopback) Sets the network address which the captured frame data is streamed to. When set to local loopback (127.0.0.1) address, the data is streamed locally within the computer. When set to a specific network IP address under the dropdown menu, the data is streamed over the network and other computers that are on the same network can receive the data.

Labeled Markers

(Default: True) Enables, or disables, streaming of labeled Marker data. These markers are point cloud solved markers.

Unlabeled Markers

(Default: True) Enables/disables streaming of all of the unlabeled Marker data in the frame.

Asset Markers

(Default: True) Enables/disables streaming of the markerset markers, which are named collections of all of the labeled markers and their positions (X, Y, Z). In other words, this includes markers that are associated with any of the assets (MarkerSet, Rigid Body, Skeleton). The streamed list also contains a special marker set named all which is a list of labeled markers in all of the assets in aTake. In this data, skeleton and rigid body markers are point cloud solved and model-filled on occluded frames.

Rigid Bodies

(Default: True) Enables/disables streaming of rigid body data, which includes the name of rigid body assets as well as positions and orientations of their pivot points.

Skeletons

(Default: Skeletons) Enables/disables streaming of skeleton tracking data from active skeleton assets. This includes the total number of bones and their positions and orientations in respect to global, or local, coordinate system.

Skeleton Coordinates

(Default: Global) When set to Global, the tracking data will be represented according to the global coordinate system. When this is set to Local, the streamed tracking data (position and rotation) of each skeletal bone will be relative to its parent bones.

Skeleton as Rigid Bodies

[Advanced] (Default: False) When set to true, skeleton assets are streamed as a series of rigid bodies that represent respective skeleton segments.

Bone Naming Convention

(Default: FBX) Sets the bone naming convention of the streamed data. Available conventions include Motive, FBX, and BVH. The naming convention must match the format used in the streaming destination.
Note: The default setting for this has been changed to FBX in Motive 2.0.

Up Axis

(Default: Y Axis) Selects the upward axis of the right-hand coordinate system in the streamed data. When streaming onto an external platform with a Z-up right-handed coordinate system (e.g. biomechanics applications) change this to Z Up.

Remote Trigger

(Default: False) Allows using the remote trigger for recording using XML commands. See more: Remote Triggering

Type

(Default: Multicast) Selects the mode of broadcast for NatNet. Valid options are: Multicast, Unicast.

Stream Subject Prefix

[Advanced] (Default: True) When set to true, associated asset name is added as a subject prefix to each marker label in the streamed data.

Stream Visual3D Compatible

[Advanced] Enables streaming to Visual3D. Normal streaming configurations may be not compatible with Visual3D, and this feature must be enabled for streaming tracking data to Visual3D.

Scale

[Advanced] Applies scaling to all of the streamed position data.

Command Port

[Advanced] (Default: 1510) Specifies the port to be used for negotiating the connection between the NatNet server and client.

Data Port

[Advanced] (Default: 1511) Specifies the port to be used for streaming data from the NatNet server to the client(s).

Multicast interface

[Advanced] Specifies the multicast broadcast address. (Default: 239.255.42.99). Note: When streaming to clients based on NatNet 2.0 or below, the default multicast address should be changed to 224.0.0.1 and the data port should be changed to 1001.

Multicast as Broadcast

[Advanced] Warning: This mode is for testing purposes only and it can overflood the network with the streamed data. When enabled, Motive streams out the mocap data via broadcasting instead of sending to Unicast or Multicast IP addresses. This should be used only when the use of Multicast or Unicast is not applicable. This will basically spam the network that Motive is streaming to with streamed mocap data which may interfere with other data on the network, so a dedicated NatNet streaming network may need to be set up between the server and the client(s).
To use the broadcast set the streaming option to Multicast and have this setting enabled on the server. Once it starts streaming, set the NatNet client to connect as Multicast, and then set the multicast address to 255.255.255.255. Once Motive starts broadcasting the data, the client will receive broadcast packets from the server.

Trackd Streaming Engine

DatastreamingPane Trackd 111.png

For information on streaming data via the Trackd Streaming Engine, please consult the Trackd documentation or contact Mechdyne. Note that only 6 DOF rigid body data can be streamed via Trackd.

TrackD Streaming Engine

(Default: False) Streams rigid body data via the Trackd protocol.

VRPN Streaming Engine

DatastreamingPane VRPN 111.png

For information on streaming data via the VRPN Streaming Engine, please visit the VRPN knowledge base. Note that only 6 DOF rigid body data can be streamed via VRPN.

VRPN Streaming Engine

(Default: False) Streams rigid body data via the VRPN protocol.

VRPN Broadcast Port

[Advanced] (Default: 3883) Specifies the broadcast port for VRPN streaming. (Default: 3883).
Retrieved from "https://v21.wiki.optitrack.com/index.php?title=Data_Streaming_Pane&oldid=15204"