Medical Imaging Interaction Toolkit  2023.04.00
Medical Imaging Interaction Toolkit
mitk::NDIPassiveTool Class Reference

Implementation of a passive NDI optical tool. More...

#include <mitkNDIPassiveTool.h>

Inheritance diagram for mitk::NDIPassiveTool:
Collaboration diagram for mitk::NDIPassiveTool:

Public Types

enum  TrackingPriority { Static, Dynamic, ButtonBox }
 tracking priority for NDI tracking devices More...
 

Public Member Functions

 mitkClassMacro (NDIPassiveTool, TrackingTool)
 
virtual bool LoadSROMFile (const char *filename)
 load a srom tool description file More...
 
virtual const unsigned char * GetSROMData () const
 get loaded srom file as unsigned char array More...
 
virtual unsigned int GetSROMDataLength () const
 get length of SROMData char array More...
 
virtual void SetPortHandle (const char *_arg)
 
virtual const char * GetPortHandle () const
 get port handle under which the tool is registered in the tracking device More...
 
virtual void SetTrackingPriority (TrackingPriority _arg)
 set port handle under which the tool is registered in the tracking device More...
 
virtual TrackingPriority GetTrackingPriority () const
 set tracking priority that the ndi tracking device should use More...
 
virtual void SetSerialNumber (const char *_arg)
 get tracking priority that the ndi tracking device should use More...
 
virtual const char * GetSerialNumber () const
 set serial number of the tool More...
 
virtual const char * GetFile () const
 get serial number of the tool More...
 
- Public Member Functions inherited from mitk::TrackingTool
 mitkClassMacroItkParent (TrackingTool, itk::Object)
 
Pointer Clone () const
 
void PrintSelf (std::ostream &os, itk::Indent indent) const override
 
virtual const char * GetToolName () const
 every tool has a name thatgit can be used to identify it. More...
 
virtual void SetToolName (const std::string _arg)
 Sets the name of the tool. More...
 
virtual void SetToolName (const char *_arg)
 Sets the name of the tool. More...
 
Point3D GetToolTipPosition () const
 returns the tool tip in tool coordinates, which where set by SetToolTip More...
 
Quaternion GetToolAxisOrientation () const
 returns the transformation of the tool axis with respect to the MITK-IGT main tool axis (0,0,-1) More...
 
virtual void SetToolTipPosition (Point3D toolTipPosition, Quaternion orientation, ScalarType eps=0.0)
 defines a tool tip for this tool in tool coordinates. GetPosition() and GetOrientation() return the data of the tool tip if it is defined. By default no tooltip is defined. More...
 
virtual bool IsToolTipSet () const
 returns true if a tool tip is set, false if not More...
 
virtual void GetPosition (Point3D &position) const
 returns the current position of the tool as an array of three floats (in the tracking device coordinate system) More...
 
virtual void SetPosition (Point3D position)
 sets the position More...
 
virtual void GetOrientation (Quaternion &orientation) const
 returns the current orientation of the tool as a quaternion in a mitk::Point4D (in the tracking device coordinate system) More...
 
virtual void SetOrientation (Quaternion orientation)
 sets the orientation as a quaternion More...
 
virtual bool Enable ()
 enables the tool, so that it will be tracked More...
 
virtual bool Disable ()
 disables the tool, so that it will not be tracked anymore More...
 
virtual bool IsEnabled () const
 returns whether the tool is enabled or disabled More...
 
virtual void SetDataValid (bool isDataValid)
 sets if the tracking data (position & orientation) is valid More...
 
virtual bool IsDataValid () const
 returns true if the current position data is valid (no error during tracking, tracking error below threshold, ...) More...
 
virtual float GetTrackingError () const
 returns one value that corresponds to the overall tracking error. More...
 
virtual void SetTrackingError (float error)
 sets the tracking error More...
 
virtual const char * GetErrorMessage () const
 if the data is not valid, ErrorMessage should contain a string explaining why it is invalid (the Set-method should be implemented in subclasses, it should not be accessible by the user) More...
 
virtual void SetErrorMessage (const char *_arg)
 sets the error message More...
 
virtual void SetIGTTimeStamp (double _arg)
 Sets the IGT timestamp of the tracking tool object (time in milliseconds) More...
 
virtual double GetIGTTimeStamp () const
 Gets the IGT timestamp of the tracking tool object (time in milliseconds). Returns 0 if the timestamp was not set. More...
 

Protected Member Functions

Pointer Clone () const
 
 NDIPassiveTool ()
 
 ~NDIPassiveTool () override
 
- Protected Member Functions inherited from mitk::TrackingTool
 TrackingTool ()
 
 ~TrackingTool () override
 

Static Protected Member Functions

static Pointer New ()
 get file from which this tool was loaded More...
 

Protected Attributes

unsigned char * m_SROMData
 content of the srom tool description file More...
 
unsigned int m_SROMDataLength
 length of the srom tool description file More...
 
TrackingPriority m_TrackingPriority
 priority for this tool More...
 
std::string m_PortHandle
 port handle for this tool More...
 
std::string m_SerialNumber
 serial number for this tool More...
 
std::string m_File
 the original file from which this tool was loaded More...
 
- Protected Attributes inherited from mitk::TrackingTool
std::string m_ToolName
 every tool has a name that can be used to identify it. More...
 
std::string m_ErrorMessage
 if a tool is invalid, this member should contain a human readable explanation of why it is invalid More...
 
double m_IGTTimeStamp
 contains the time at which the tracking data was recorded More...
 
std::mutex m_MyMutex
 mutex to control concurrent access to the tool More...
 
Point3D m_Position
 holds the position of the tool in global tracking coordinates More...
 
Quaternion m_Orientation
 holds the orientation of the tool´in global tracking coordinates More...
 
float m_TrackingError
 holds the tracking error of the tool More...
 
bool m_Enabled
 if true, tool is enabled and should receive tracking updates from the tracking device More...
 
bool m_DataValid
 if true, data in m_Position and m_Orientation is valid, e.g. true tracking data More...
 
Point3D m_ToolTipPosition
 holds the position of the tool tip in the coordinate system of the tracking sensor More...
 
Quaternion m_ToolAxisOrientation
 holds the rotation of the sensor coordinate system such that the z-axis coincides with the main tool axis e.g. obtained by a tool calibration More...
 
bool m_ToolTipSet
 

Additional Inherited Members

- Static Public Member Functions inherited from mitk::TrackingTool
static Pointer New ()
 

Detailed Description

Implementation of a passive NDI optical tool.

Documentation implements the TrackingTool interface and has the ability to load an srom file that contains the marker configuration for that tool

Definition at line 31 of file mitkNDIPassiveTool.h.

Member Enumeration Documentation

◆ TrackingPriority

tracking priority for NDI tracking devices

Enumerator
Static 
Dynamic 
ButtonBox 

Definition at line 38 of file mitkNDIPassiveTool.h.

Constructor & Destructor Documentation

◆ NDIPassiveTool()

mitk::NDIPassiveTool::NDIPassiveTool ( )
protected

◆ ~NDIPassiveTool()

mitk::NDIPassiveTool::~NDIPassiveTool ( )
overrideprotected

Member Function Documentation

◆ Clone()

Pointer mitk::NDIPassiveTool::Clone ( ) const
protected

◆ GetFile()

virtual const char* mitk::NDIPassiveTool::GetFile ( ) const
virtual

get serial number of the tool

◆ GetPortHandle()

virtual const char* mitk::NDIPassiveTool::GetPortHandle ( ) const
virtual

get port handle under which the tool is registered in the tracking device

◆ GetSerialNumber()

virtual const char* mitk::NDIPassiveTool::GetSerialNumber ( ) const
virtual

set serial number of the tool

◆ GetSROMData()

virtual const unsigned char* mitk::NDIPassiveTool::GetSROMData ( ) const
virtual

get loaded srom file as unsigned char array

◆ GetSROMDataLength()

virtual unsigned int mitk::NDIPassiveTool::GetSROMDataLength ( ) const
virtual

get length of SROMData char array

◆ GetTrackingPriority()

virtual TrackingPriority mitk::NDIPassiveTool::GetTrackingPriority ( ) const
virtual

set tracking priority that the ndi tracking device should use

◆ LoadSROMFile()

virtual bool mitk::NDIPassiveTool::LoadSROMFile ( const char *  filename)
virtual

load a srom tool description file

◆ mitkClassMacro()

mitk::NDIPassiveTool::mitkClassMacro ( NDIPassiveTool  ,
TrackingTool   
)

◆ New()

static Pointer mitk::NDIPassiveTool::New ( )
staticprotected

get file from which this tool was loaded

◆ SetPortHandle()

virtual void mitk::NDIPassiveTool::SetPortHandle ( const char *  _arg)
virtual

◆ SetSerialNumber()

virtual void mitk::NDIPassiveTool::SetSerialNumber ( const char *  _arg)
virtual

get tracking priority that the ndi tracking device should use

◆ SetTrackingPriority()

virtual void mitk::NDIPassiveTool::SetTrackingPriority ( TrackingPriority  _arg)
virtual

set port handle under which the tool is registered in the tracking device

Member Data Documentation

◆ m_File

std::string mitk::NDIPassiveTool::m_File
protected

the original file from which this tool was loaded

Definition at line 71 of file mitkNDIPassiveTool.h.

◆ m_PortHandle

std::string mitk::NDIPassiveTool::m_PortHandle
protected

port handle for this tool

Definition at line 69 of file mitkNDIPassiveTool.h.

◆ m_SerialNumber

std::string mitk::NDIPassiveTool::m_SerialNumber
protected

serial number for this tool

Definition at line 70 of file mitkNDIPassiveTool.h.

◆ m_SROMData

unsigned char* mitk::NDIPassiveTool::m_SROMData
protected

content of the srom tool description file

Definition at line 66 of file mitkNDIPassiveTool.h.

◆ m_SROMDataLength

unsigned int mitk::NDIPassiveTool::m_SROMDataLength
protected

length of the srom tool description file

Definition at line 67 of file mitkNDIPassiveTool.h.

◆ m_TrackingPriority

TrackingPriority mitk::NDIPassiveTool::m_TrackingPriority
protected

priority for this tool

Definition at line 68 of file mitkNDIPassiveTool.h.


The documentation for this class was generated from the following file: