Difference between revisions of "OpenIGTLink/ProtocolV2/Type/QTrackingData"

From NAMIC Wiki
Jump to: navigation, search
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[OpenIGTLink/ProtocolV2/Draft | << Version 2 Draft Page]]
+
[[OpenIGTLink/ProtocolV2/Index | << Version 2 Index Page]]
  
 
=Summary=
 
=Summary=
Line 15: Line 15:
 
|-
 
|-
 
| align="left" | NAME_1
 
| align="left" | NAME_1
| align="left" | char[20]
+
| align="left" | char[32]
 
| align="left" | Name (=Id) of the instrument/tracker
 
| align="left" | Name (=Id) of the instrument/tracker
 
|-
 
|-
Line 37: Line 37:
 
|-
 
|-
 
| align="left" | NAME_N
 
| align="left" | NAME_N
| align="left" | char[20]
+
| align="left" | char[32]
 
| align="left" | Name (=Id) of the instrument/tracker
 
| align="left" | Name (=Id) of the instrument/tracker
 
|-
 
|-
Line 57: Line 57:
 
|-
 
|-
 
|}
 
|}
 +
 +
<font color="red">Feb 2, 2011: The length of the coordinate system field was corrected. (It should be the same as TDATA.) </font>
  
 
==GET_QTDATA==
 
==GET_QTDATA==
Line 68: Line 70:
 
|}
 
|}
  
==STT_TDATA==
+
==STT_QTDATA==
  
 
{| border="1" cellpadding="5" cellspacing="0" align="center"
 
{| border="1" cellpadding="5" cellspacing="0" align="center"
Line 81: Line 83:
 
|-
 
|-
 
| align="left" | Coordinate system name
 
| align="left" | Coordinate system name
| align="left" | char[20]
+
| align="left" | char[32]
 
| align="left" | Coordinate system to use. Can be empty for default coordinate system. (not included if action = 2)
 
| align="left" | Coordinate system to use. Can be empty for default coordinate system. (not included if action = 2)
 
|-
 
|-
 
|}
 
|}
  
==STP_TDATA==
+
==STP_QTDATA==
  
 
{| border="1" cellpadding="5" cellspacing="0" align="center"
 
{| border="1" cellpadding="5" cellspacing="0" align="center"
Line 96: Line 98:
 
|}
 
|}
  
==RTS_TDATA==
+
==RTS_QTDATA==
  
 +
{| border="1" cellpadding="5" cellspacing="0" align="center"
 +
|-
 +
| align="left style="background:#e0e0e0;" | Data
 +
| align="left style="background:#e0e0e0;" | Type
 +
| align="left style="background:#e0e0e0;" | Description
 +
|-
 +
| align="left" | Status
 +
| align="left" | 8 bit unsigned
 +
| align="left" | 0: Success 1: Error
 +
|-
 +
|}
  
 
=Implementations=
 
=Implementations=
The TDATA message type is implemented in the following source code.
 
*[http://svn.na-mic.org/NAMICSandBox/trunk/OpenIGTLink/Source/igtlTrackingDataMessage.h igtlTrackingDataMessage.h]
 
*[http://svn.na-mic.org/NAMICSandBox/trunk/OpenIGTLink/Source/igtlTrackingDataMessage.cxx igtlTrackingDataMessage.cxx]
 
  
 
=Contributors=
 
=Contributors=

Latest revision as of 04:43, 30 November 2011

Home < OpenIGTLink < ProtocolV2 < Type < QTrackingData

<< Version 2 Index Page

Summary

The QTDATA message type is intended for transferring 3D positions of surgical tools, markers etc. Its role is almost identical to TDATA, except that QTDATA describes orientation by using quaternion.

Message Types

QTDATA

Data Type Description
NAME_1 char[32] Name (=Id) of the instrument/tracker
TYPE_1 8 bit unsigned 1: tracker, 2: 6D instrument (regular instrument), 3: 3D instrument (only tip of the instrument defined), 4: 5D instrument (tip and handle are defined, but not the normal vector)
-- 8 bit unsigned Reserved
POSITION_1 float32[3] (X, Y, Z)
QUATERNION_1 float32[4] Quaternion (QX, QY, QZ, W)
...
NAME_N char[32] Name (=Id) of the instrument/tracker
TYPE_N 8 bit unsigned 1: tracker, 2: 6D instrument (regular instrument), 3: 3D instrument (only tip of the instrument defined), 4: 5D instrument (tip and handle are defined, but not the normal vector)
-- 8 bit unsigned Reserved
POSITION_N float32[3] (X, Y, Z)
QUATERNION_N float32[4] Quaternion (QX, QY, QZ, W)

Feb 2, 2011: The length of the coordinate system field was corrected. (It should be the same as TDATA.)

GET_QTDATA

Data Type Description

STT_QTDATA

Data Type Description
Resolution 32 bit unsigned Minimum time between two frames. Use 0 for as fast as possible. If e.g. 50 ms is specified, the maximum update rate will be 20 Hz.
Coordinate system name char[32] Coordinate system to use. Can be empty for default coordinate system. (not included if action = 2)

STP_QTDATA

Data Type Description

RTS_QTDATA

Data Type Description
Status 8 bit unsigned 0: Success 1: Error

Implementations

Contributors

Alexander Schaal

Comments

See OpenIGTLink/ProtocolV2/Type/TrackingData.