Computer Assited Medical Intervention Tool Kit  version 5.0
camitk::Frame Class Reference

Represents a hierarchy of frames. More...

#include <Frame.h>

+ Inheritance diagram for camitk::Frame:
+ Collaboration diagram for camitk::Frame:

Public Member Functions

 Frame (vtkSmartPointer< vtkTransform > transform=nullptr, Frame *parentFrame=nullptr)
 Default constructor with transformation. More...
 
vtkSmartPointer< vtkAxesActor > getFrameAxisActor () override
 Gives the 3D representation of the frame (based on xyd arrows) More...
 
bool getFrameVisibility (QString) const override
 Get the Component Frame visibility for a given viewer. More...
 
void removeFrameChild (InterfaceFrame *frame) override final
 If the parent frame keeps track of its children, when a child is deleted it should warn its parent. More...
 
void setFrameVisibility (QString, bool) override
 Set the Component Frame visible for a given viewer. More...
 
 ~Frame () override
 Default Destructor. More...
 
const QString & getFrameName () const override final
 Hierarchy accessors / Modifyers. More...
 
void setFrameName (QString name) override
 Set the Frame Unique identifyer. More...
 
InterfaceFramegetParentFrame () const override
 Get the parent frame. More...
 
void setParentFrame (InterfaceFrame *parent, bool keepTransform=true) override final
 Set the parent frame to the parameter frame. More...
 
const QVector< InterfaceFrame * > & getChildrenFrame () const override
 Get the Children Frames from the current Frame in the Frame Hierarchy The Frame hierarchy may not be the same as the Component Hierarchy. More...
 
const vtkSmartPointer< vtkTransform > getTransformFromWorld () const override
 Transforms accessors / Modifyers. More...
 
const vtkSmartPointer< vtkTransform > getTransform () const override
 Get a the transformation with respect to the parent frame. More...
 
const vtkSmartPointer< vtkTransform > getTransformFromFrame (InterfaceFrame *frame) const override
 Get a COPY of the transformation with respect to another frame. More...
 
void setTransform (vtkSmartPointer< vtkTransform > transform) override final
 Set the current input frame position (according to its parent Frame) More...
 
void resetTransform () override
 Set the current frame transform to identity. More...
 
void translate (double x, double y, double z) override
 Apply a translation relative to the current position. More...
 
void rotate (double aroundX, double aroundY, double aroundZ) override
 Apply rotations relative to the current position in the alphabetical order (X, Y, Z). More...
 
void rotateVTK (double aroundX, double aroundY, double aroundZ) override
 Apply a rotation relative to the current position, using the VTK rotation order (Z, X, Y) More...
 
void setTransformTranslation (double x, double y, double z) override
 Set the translation part of the 3D space transformation of the current frame. More...
 
void setTransformTranslationVTK (double x, double y, double z) override
 Set the translation part of the 3D space transformation of the current frame. More...
 
void setTransformRotation (double aroundX, double aroundY, double aroundZ) override
 Set the rotation part of the 3D space transformation of the current frame. More...
 
void setTransformRotationVTK (double aroundX, double aroundY, double aroundZ) override
 Set the rotation part of the 3D space transformation of the current frame. More...
 
void initAttributes ()
 
- Public Member Functions inherited from camitk::InterfaceFrame
virtual ~InterfaceFrame ()=default
 empty virtual destructor, to avoid memory leak More...
 

Protected Member Functions

QVector< InterfaceFrame * > computeDescendants (InterfaceFrame *)
 Compute all the descendants of the input frame. More...
 

Protected Attributes

QVector< InterfaceFrame * > childrenFrame
 List of children Frames to keep track of Frame hierarchy. More...
 
QString frameName
 Frame unique identifier. More...
 
InterfaceFrameparentFrame
 The Parent Frame. More...
 
vtkSmartPointer< vtkTransformPolyDataFilter > representationTransformFilter
 Transform Filter to store the transformation for the Frame's 3D representation. More...
 
vtkSmartPointer< vtkTransform > transformParentToMe
 Transformation to represent my points (expressed in my frame) in my parent's frame. More...
 
vtkSmartPointer< vtkTransform > transformWorldToMe
 Transformation to represent my points (expressed in my frame) in the world's frame. More...
 

Private Member Functions

void addFrameChild (InterfaceFrame *frame) override
 When the current Frame is set to parent, it must update its children list. More...
 

Private Attributes

vtkSmartPointer< vtkAxesActor > axes
 Geometric representation of the frame (vtkAxes) More...
 
QMap< Viewer *, bool > frameViewers
 List of Viewers in which the frame is visible. More...
 

Static Private Attributes

static int nbTotalFrames = 0
 To be able to give a default unique identifier to each created frame. More...
 

Detailed Description

Represents a hierarchy of frames.

Each frame is represented by its parent frame (by default the World frame) and a linear transformation from its parent frame ; i.e. the transformation to represents my points (expressed in my frame) in my parent's frame.

Frames are in a tree hierarchy, in a top down way.

The frame hierarchy only changes the REPRESENTATION of Components, not Components themselves To obtain the real point position of child components, one should apply getWorldTransformation to them.

When a frame moves, it should move from its parent, not from the world frame (except if its parent frame is the world frame).

Constructor & Destructor Documentation

◆ Frame()

camitk::Frame::Frame ( vtkSmartPointer< vtkTransform >  transform = nullptr,
Frame parentFrame = nullptr 
)

Default constructor with transformation.

Parameters
transformis the vtk transformtation to express the current frame coordinates into its parent frame. If no transform is givent the default transform is set to the identity matrix.
parentFrameis the base frame in the begin of the hierarchical system. If no parent is given, the default parent is set to NULL and considered as the World frame.

References axes, childrenFrame, frameName, nbTotalFrames, parentFrame, representationTransformFilter, transformParentToMe, and transformWorldToMe.

◆ ~Frame()

camitk::Frame::~Frame ( )
override

Default Destructor.

Member Function Documentation

◆ addFrameChild()

void camitk::Frame::addFrameChild ( InterfaceFrame frame)
overrideprivatevirtual

When the current Frame is set to parent, it must update its children list.

Implements camitk::InterfaceFrame.

References transformWorldToMe.

◆ computeDescendants()

QVector< InterfaceFrame * > camitk::Frame::computeDescendants ( InterfaceFrame frame)
protected

Compute all the descendants of the input frame.

◆ getChildrenFrame()

const QVector< InterfaceFrame * > & camitk::Frame::getChildrenFrame ( ) const
overridevirtual

Get the Children Frames from the current Frame in the Frame Hierarchy The Frame hierarchy may not be the same as the Component Hierarchy.

Implements camitk::InterfaceFrame.

◆ getFrameAxisActor()

vtkSmartPointer< vtkAxesActor > camitk::Frame::getFrameAxisActor ( )
overridevirtual

Gives the 3D representation of the frame (based on xyd arrows)

Implements camitk::InterfaceFrame.

◆ getFrameName()

const QString & camitk::Frame::getFrameName ( ) const
finaloverridevirtual

Hierarchy accessors / Modifyers.

Get the Frame Unique identifyer (can be set by user)

Implements camitk::InterfaceFrame.

◆ getFrameVisibility()

bool camitk::Frame::getFrameVisibility ( QString  viewerName) const
overridevirtual

Get the Component Frame visibility for a given viewer.

Implements camitk::InterfaceFrame.

◆ getParentFrame()

InterfaceFrame * camitk::Frame::getParentFrame ( ) const
overridevirtual

Get the parent frame.

Implements camitk::InterfaceFrame.

References camitk::InterfaceFrame::getFrameName(), and removeFrameChild().

+ Here is the call graph for this function:

◆ getTransform()

const vtkSmartPointer< vtkTransform > camitk::Frame::getTransform ( ) const
overridevirtual

Get a the transformation with respect to the parent frame.

Implements camitk::InterfaceFrame.

◆ getTransformFromFrame()

const vtkSmartPointer< vtkTransform > camitk::Frame::getTransformFromFrame ( InterfaceFrame frame) const
overridevirtual

Get a COPY of the transformation with respect to another frame.

Implements camitk::InterfaceFrame.

◆ getTransformFromWorld()

const vtkSmartPointer< vtkTransform > camitk::Frame::getTransformFromWorld ( ) const
overridevirtual

Transforms accessors / Modifyers.

Get a the transformation with respect to the world frame

Implements camitk::InterfaceFrame.

◆ initAttributes()

void camitk::Frame::initAttributes ( )

Constructors helpers Private method to initialize private attributes (called only in constrctors but in all constructors)

References childrenFrame, frameViewers, parentFrame, camitk::InterfaceFrame::removeFrameChild(), and camitk::InterfaceFrame::setParentFrame().

+ Here is the call graph for this function:

◆ removeFrameChild()

void camitk::Frame::removeFrameChild ( InterfaceFrame frame)
finaloverridevirtual

If the parent frame keeps track of its children, when a child is deleted it should warn its parent.

Implements camitk::InterfaceFrame.

Referenced by getParentFrame().

+ Here is the caller graph for this function:

◆ resetTransform()

void camitk::Frame::resetTransform ( )
overridevirtual

Set the current frame transform to identity.

In other words, the current frame and its parent share the same 3D location.

Implements camitk::InterfaceFrame.

◆ rotate()

void camitk::Frame::rotate ( double  aroundX,
double  aroundY,
double  aroundZ 
)
overridevirtual

Apply rotations relative to the current position in the alphabetical order (X, Y, Z).

Note
Prefer using the rotateVTK method if possible, this one involves errors when retrieving rotation angles from a rotation matrix, as we use a VTK method for this.

Implements camitk::InterfaceFrame.

◆ rotateVTK()

void camitk::Frame::rotateVTK ( double  aroundX,
double  aroundY,
double  aroundZ 
)
overridevirtual

Apply a rotation relative to the current position, using the VTK rotation order (Z, X, Y)

Note
Prefer using this method if you can.

Implements camitk::InterfaceFrame.

◆ setFrameName()

void camitk::Frame::setFrameName ( QString  name)
overridevirtual

Set the Frame Unique identifyer.

Implements camitk::InterfaceFrame.

◆ setFrameVisibility()

void camitk::Frame::setFrameVisibility ( QString  viewerName,
bool  visible 
)
overridevirtual

Set the Component Frame visible for a given viewer.

Implements camitk::InterfaceFrame.

◆ setParentFrame()

void camitk::Frame::setParentFrame ( InterfaceFrame parent,
bool  keepTransform = true 
)
finaloverridevirtual

Set the parent frame to the parameter frame.

During the parent transition you have the choice to keep or not the frame transform. If you keep the frame's initial transform after the parent transition, the frame's position will change as its transform's target frame changes. If you decide not to keep the initial frame's transfor, this one is updated during the parent transition in order to keep the original frame position (in the world frame).

Caution: if the parent frame in parameter is either the current frame or one of its descendant, the parent frame is set to the world frame.

Implements camitk::InterfaceFrame.

◆ setTransform()

void camitk::Frame::setTransform ( vtkSmartPointer< vtkTransform >  transform)
finaloverridevirtual

Set the current input frame position (according to its parent Frame)

Parameters
transformThe 3D transform of the current frame to its parent.

Implements camitk::InterfaceFrame.

References transformParentToMe.

◆ setTransformRotation()

void camitk::Frame::setTransformRotation ( double  aroundX,
double  aroundY,
double  aroundZ 
)
overridevirtual

Set the rotation part of the 3D space transformation of the current frame.

Note
Reminder: A 3D space transform is a 4x4 matrix, composed of a rotation and a translation.

Implements camitk::InterfaceFrame.

◆ setTransformRotationVTK()

void camitk::Frame::setTransformRotationVTK ( double  aroundX,
double  aroundY,
double  aroundZ 
)
overridevirtual

Set the rotation part of the 3D space transformation of the current frame.

This translation uses the VTK rotation order (Z, X, Y) system.

Note
Reminder: A 3D space transform is a 4x4 matrix, composed of a rotation and a translation.

Implements camitk::InterfaceFrame.

◆ setTransformTranslation()

void camitk::Frame::setTransformTranslation ( double  x,
double  y,
double  z 
)
overridevirtual

Set the translation part of the 3D space transformation of the current frame.

Note
Reminder: A 3D space transform is a 4x4 matrix, composed of a rotation and a translation.

Implements camitk::InterfaceFrame.

◆ setTransformTranslationVTK()

void camitk::Frame::setTransformTranslationVTK ( double  x,
double  y,
double  z 
)
overridevirtual

Set the translation part of the 3D space transformation of the current frame.

This translation uses the VTK rotation order (Z, X, Y) system.

Note
Reminder: A 3D space transform is a 4x4 matrix, composed of a rotation and a translation.

Implements camitk::InterfaceFrame.

◆ translate()

void camitk::Frame::translate ( double  x,
double  y,
double  z 
)
overridevirtual

Apply a translation relative to the current position.

Implements camitk::InterfaceFrame.

Member Data Documentation

◆ axes

vtkSmartPointer<vtkAxesActor> camitk::Frame::axes
private

Geometric representation of the frame (vtkAxes)

Referenced by Frame().

◆ childrenFrame

QVector<InterfaceFrame*> camitk::Frame::childrenFrame
protected

List of children Frames to keep track of Frame hierarchy.

Referenced by Frame(), and initAttributes().

◆ frameName

QString camitk::Frame::frameName
protected

Frame unique identifier.

Referenced by Frame().

◆ frameViewers

QMap<Viewer*, bool> camitk::Frame::frameViewers
private

List of Viewers in which the frame is visible.

Referenced by initAttributes().

◆ nbTotalFrames

int camitk::Frame::nbTotalFrames = 0
staticprivate

To be able to give a default unique identifier to each created frame.

Referenced by Frame().

◆ parentFrame

InterfaceFrame* camitk::Frame::parentFrame
protected

The Parent Frame.

If it is NULL, then the parent is the World Frame.

Referenced by Frame(), and initAttributes().

◆ representationTransformFilter

vtkSmartPointer<vtkTransformPolyDataFilter> camitk::Frame::representationTransformFilter
protected

Transform Filter to store the transformation for the Frame's 3D representation.

Referenced by Frame().

◆ transformParentToMe

vtkSmartPointer<vtkTransform> camitk::Frame::transformParentToMe
protected

Transformation to represent my points (expressed in my frame) in my parent's frame.

Transformation to apply to this (and children) data to place them in my parent's frame.

Referenced by Frame(), and setTransform().

◆ transformWorldToMe

vtkSmartPointer<vtkTransform> camitk::Frame::transformWorldToMe
protected

Transformation to represent my points (expressed in my frame) in the world's frame.

i.e. Transformation to apply to this (and children) data to place them in the world's frame.

This transformation is always re-calculated and stored only for convenience purpose. It can not be set by a user.

Referenced by addFrameChild(), and Frame().


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