#include <mitkGizmo.h>

Inheritance diagram for mitk::Gizmo:

Collaboration diagram for mitk::Gizmo:

Public Types
enum	AxisType { AxisX, AxisY, AxisZ }
	Names for the three axes. More...

enum	HandleType { MoveFreely, MoveAlongAxisX, MoveAlongAxisY, MoveAlongAxisZ, RotateAroundAxisX, RotateAroundAxisY, RotateAroundAxisZ, ScaleX, ScaleY, ScaleZ, NoHandle }
	Names for the different parts of the gizmo. More...

Public Types inherited from mitk::Surface
typedef itk::ImageRegion< 5 >	RegionType

typedef Surface	Self

typedef BaseData	Superclass

typedef itk::SmartPointer< Self >	Pointer

typedef itk::SmartPointer< const Self >	ConstPointer

Public Types inherited from mitk::BaseData
typedef BaseData	Self

typedef itk::DataObject	Superclass

typedef itk::SmartPointer< Self >	Pointer

typedef itk::SmartPointer< const Self >	ConstPointer

Public Member Functions
	mitkClassMacro (Gizmo, Surface)

virtual Point3D	GetCenter () const

virtual void	SetCenter (Point3D _arg)

virtual Vector3D	GetAxisX () const

virtual void	SetAxisX (Vector3D _arg)

virtual Vector3D	GetAxisY () const

virtual void	SetAxisY (Vector3D _arg)

virtual Vector3D	GetAxisZ () const

virtual void	SetAxisZ (Vector3D _arg)

virtual Vector3D	GetRadius () const

virtual void	SetRadius (Vector3D _arg)

virtual bool	GetAllowTranslation () const

virtual void	SetAllowTranslation (bool _arg)

virtual void	AllowTranslationOn ()

virtual void	AllowTranslationOff ()

virtual bool	GetAllowRotation () const

virtual void	SetAllowRotation (bool _arg)

virtual void	AllowRotationOn ()

virtual void	AllowRotationOff ()

virtual bool	GetAllowScaling () const

virtual void	SetAllowScaling (bool _arg)

virtual void	AllowScalingOn ()

virtual void	AllowScalingOff ()

double	GetLongestRadius () const
	Return the longest of the three axes. More...

void	UpdateRepresentation ()
	Updates the representing surface object after changes to center, axes, or radius. More...

void	FollowGeometry (BaseGeometry *geom)

void	OnFollowedGeometryModified ()
	The ITK callback to receive modified events of the followed geometry. More...

HandleType	GetHandleFromPointID (vtkIdType id)

mitk::Gizmo::HandleType	GetHandleFromPointDataValue (double value)

Public Member Functions inherited from mitk::Surface
virtual std::vector< std::string >	GetClassHierarchy () const override

virtual const char *	GetClassName () const

Pointer	Clone () const

void	CalculateBoundingBox ()

virtual void	CopyInformation (const itk::DataObject *data) override

virtual void	ExecuteOperation (Operation *operation) override
	overwrite if the Data can be called by an Interactor (StateMachine). More...

virtual void	Expand (unsigned int timeSteps=1) override
	Expands the TimeGeometry to a number of TimeSteps. More...

const RegionType &	GetLargestPossibleRegion () const

virtual const RegionType &	GetRequestedRegion () const

unsigned int	GetSizeOfPolyDataSeries () const

virtual vtkPolyData *	GetVtkPolyData (unsigned int t=0) const

virtual void	Graft (const DataObject *data) override

virtual bool	IsEmptyTimeStep (unsigned int t) const override
	Check whether object contains data (at a specified time), e.g., a set of points may be empty. More...

virtual void	PrintSelf (std::ostream &os, itk::Indent indent) const override

virtual bool	RequestedRegionIsOutsideOfTheBufferedRegion () override
	Determine whether the RequestedRegion is outside of the BufferedRegion. More...

virtual void	SetRequestedRegion (const itk::DataObject *data) override
	Set the requested region from this data object to match the requested region of the data object passed in as a parameter. More...

virtual void	SetRequestedRegion (Surface::RegionType *region)

virtual void	SetRequestedRegionToLargestPossibleRegion () override
	Set the RequestedRegion to the LargestPossibleRegion. More...

virtual void	SetVtkPolyData (vtkPolyData *polydata, unsigned int t=0)

virtual void	Swap (Surface &other)

virtual void	Update () override

virtual void	UpdateOutputInformation () override

virtual bool	VerifyRequestedRegion () override
	Verify that the RequestedRegion is within the LargestPossibleRegion. More...

Public Member Functions inherited from mitk::BaseData
const mitk::TimeGeometry *	GetTimeGeometry () const
	Return the TimeGeometry of the data as const pointer. More...

const mitk::TimeGeometry *	GetTimeSlicedGeometry () const
	Return the TimeGeometry of the data as const pointer. More...

mitk::TimeGeometry *	GetTimeGeometry ()
	Return the TimeGeometry of the data as pointer. More...

const mitk::TimeGeometry *	GetUpdatedTimeGeometry ()
	Return the TimeGeometry of the data. More...

const mitk::TimeGeometry *	GetUpdatedTimeSliceGeometry ()
	Return the TimeGeometry of the data. More...

const mitk::BaseGeometry *	GetUpdatedGeometry (int t=0)
	Return the BaseGeometry of the data at time t. More...

mitk::BaseGeometry *	GetGeometry (int t=0) const
	Return the geometry, which is a TimeGeometry, of the data as non-const pointer. More...

void	UpdateOutputInformation () override
	Update the information for this BaseData (the geometry in particular) so that it can be used as an output of a BaseProcess. More...

void	CopyInformation (const itk::DataObject *data) override
	Copy information from the specified data set. More...

virtual bool	IsInitialized () const
	Check whether the data has been initialized, i.e., at least the Geometry and other header data has been set. More...

virtual void	Clear ()
	Calls ClearData() and InitializeEmpty();. More...

virtual bool	IsEmpty () const
	Check whether object contains data (at least at one point in time), e.g., a set of points may be empty. More...

virtual void	SetGeometry (BaseGeometry *aGeometry3D)
	Set the BaseGeometry of the data, which will be referenced (not copied!). Assumes the data object has only 1 time step ( is a 3D object ) and creates a new TimeGeometry which saves the given BaseGeometry. If an TimeGeometry has already been set for the object, it will be replaced after calling this function. More...

virtual void	SetTimeGeometry (TimeGeometry *geometry)
	Set the TimeGeometry of the data, which will be referenced (not copied!). More...

virtual void	SetClonedGeometry (const BaseGeometry *aGeometry3D)
	Set a clone of the provided TimeGeometry as TimeGeometry of the data. Assumes the data object has only 1 time step ( is a 3D object ) and creates a new TimeGeometry. If an TimeGeometry has already been set for the object, it will be replaced after calling this function. More...

virtual void	SetClonedTimeGeometry (const TimeGeometry *geometry)
	Set a clone of the provided TimeGeometry as TimeGeometry of the data. More...

virtual void	SetClonedGeometry (const BaseGeometry *aGeometry3D, unsigned int time)
	Set a clone of the provided geometry as BaseGeometry of a given time step. More...

mitk::PropertyList::Pointer	GetPropertyList () const
	Get the data's property list. More...

void	SetPropertyList (PropertyList *propertyList)
	Set the data's property list. More...

mitk::BaseProperty::Pointer	GetProperty (const char *propertyKey) const
	Get the property (instance of BaseProperty) with key propertyKey from the PropertyList, and set it to this, respectively;. More...

void	SetProperty (const char propertyKey, BaseProperty property)

virtual void	SetOrigin (const Point3D &origin)
	Convenience method for setting the origin of the BaseGeometry instances of all time steps. More...

itk::SmartPointer< mitk::BaseDataSource >	GetSource () const
	Get the process object that generated this data object. More...

unsigned int	GetTimeSteps () const
	Get the number of time steps from the TimeGeometry As the base data has not a data vector given by itself, the number of time steps is defined over the time sliced geometry. In sub classes, a better implementation could be over the length of the data vector. More...

virtual unsigned long	GetMTime () const override
	Get the modified time of the last change of the contents this data object or its geometry. More...

Public Member Functions inherited from mitk::OperationActor
	itkTypeMacroNoParent (OperationActor) virtual ~OperationActor()

Static Public Member Functions
static std::string	HandleTypeToString (HandleType type)
	Conversion for any kind of logging/debug/... purposes. More...

static Pointer	New ()

static DataNode::Pointer	AddGizmoToNode (DataNode node, DataStorage storage)

static bool	RemoveGizmoFromNode (DataNode node, DataStorage storage)

static bool	HasGizmoAttached (mitk::DataNode node, DataStorage storage)

Static Public Member Functions inherited from mitk::Surface
static const char *	GetStaticNameOfClass ()

static Pointer	New ()

Static Public Member Functions inherited from mitk::BaseData
static const char *	GetStaticNameOfClass ()

Protected Member Functions
	Gizmo ()

virtual	~Gizmo ()

	Gizmo (const Gizmo &)

Gizmo &	operator= (const Gizmo &)

vtkSmartPointer< vtkPolyData >	BuildGizmo ()
	Creates a vtkPolyData representing the parameters defining the gizmo. More...

Protected Member Functions inherited from mitk::Surface
virtual itk::LightObject::Pointer	InternalClone () const override

	Surface ()

virtual	~Surface ()

	Surface (const Surface &other)

Surface &	operator= (Surface other)

virtual void	ClearData () override
	reset to non-initialized state, release memory More...

virtual void	InitializeEmpty () override
	Pure virtual; Must be used in subclasses to get a data object to a valid state. Should at least create one empty object and call Superclass::InitializeTimeGeometry() to ensure an existing valid geometry. More...

Protected Member Functions inherited from mitk::BaseData
	BaseData ()

	BaseData (const BaseData &other)

	~BaseData ()

virtual void	InitializeTimeGeometry (unsigned int timeSteps=1)
	Initialize the TimeGeometry for a number of time steps. The TimeGeometry is initialized empty and evenly timed. In many cases it will be necessary to overwrite this in sub-classes. More...

virtual void	InitializeTimeSlicedGeometry (unsigned int timeSteps=1)
	Initialize the TimeGeometry for a number of time steps. The TimeGeometry is initialized empty and evenly timed. In many cases it will be necessary to overwrite this in sub-classes. More...

Additional Inherited Members
Protected Attributes inherited from mitk::BaseData
bool	m_LastRequestedRegionWasOutsideOfTheBufferedRegion

unsigned int	m_SourceOutputIndexDuplicate

bool	m_Initialized

Detailed Description

A geometry manipulation "gizmo".

This class represents the principal axes of some arbitrary BaseGeometry.

The visualization shows the three axes x, y, and z along with a orthogonal ring around them. In its center, a small sphere is visualized.

The class is intended to be visualized along with another data object that "owns" the followed BaseGeometry. The Gizmo will automatically update itself to all modifications to the followed base geometry. Interactive modifications to the geometry can thus be easily visualized.

The gizmo is definded by

a center
three axes for x, y, and z
a radius

The radius determines the size of the axes and the rings around them.

A nice overview of similar / alternative representations can be found in "Schmidt R, Singh K, and Balakrishnan R. Sketching and Composing Widgets for 3D Manipulation. EUROGRAPHICS 2008"

See also: GizmoInteractor3D

Definition at line 53 of file mitkGizmo.h.

Member Enumeration Documentation

enum mitk::Gizmo::AxisType

Names for the three axes.

Enumerator
AxisX
AxisY
AxisZ

Definition at line 57 of file mitkGizmo.h.

enum mitk::Gizmo::HandleType

Names for the different parts of the gizmo.

Enumerator
MoveFreely
MoveAlongAxisX
MoveAlongAxisY
MoveAlongAxisZ
RotateAroundAxisX
RotateAroundAxisY
RotateAroundAxisZ
ScaleX
ScaleY
ScaleZ
NoHandle

Definition at line 65 of file mitkGizmo.h.

Constructor & Destructor Documentation

mitk::Gizmo::Gizmo ( )

protected

Definition at line 220 of file mitkGizmo.cpp.

References UpdateRepresentation().

mitk::Gizmo::~Gizmo ( )

protectedvirtual

Definition at line 237 of file mitkGizmo.cpp.

mitk::Gizmo::Gizmo ( const Gizmo & )

protected

Member Function Documentation

mitk::DataNode::Pointer mitk::Gizmo::AddGizmoToNode	(	DataNode *	node,
		DataStorage *	storage
	)

static

Convenience creation of a gizmo for given node

Parameters

node	The node holding the geometry to be visualized
storage	The DataStorage where a node holding the gizmo shall be added to (ignored when nullptr)

Returns: DataNode::Pointer containing the node used for vizualization of our gizmo

Definition at line 169 of file mitkGizmo.cpp.

References mitk::DataStorage::Add(), mitk::DataNode::GetData(), mitk::BaseData::GetGeometry(), us::ModuleRegistry::GetModule(), us::GetModuleContext(), mitk::DataNode::GetOpacity(), mitk::GizmoInteractor::New(), mitk::DataNode::New(), New(), mitk::DataNode::SetFloatProperty(), and mitk::DataNode::SetOpacity().

virtual void mitk::Gizmo::AllowRotationOff ( )

virtual

virtual void mitk::Gizmo::AllowRotationOn ( )

virtual

virtual void mitk::Gizmo::AllowScalingOff ( )

virtual

virtual void mitk::Gizmo::AllowScalingOn ( )

virtual

virtual void mitk::Gizmo::AllowTranslationOff ( )

virtual

virtual void mitk::Gizmo::AllowTranslationOn ( )

virtual

vtkSmartPointer< vtkPolyData > mitk::Gizmo::BuildGizmo ( )

protected

Creates a vtkPolyData representing the parameters defining the gizmo.

Definition at line 422 of file mitkGizmo.cpp.

References mitk::New().

void mitk::Gizmo::FollowGeometry ( BaseGeometry * geom )

Setup the gizmo to follow any ModifiedEvents of the given geometry. The object will adapt and update itself in function of the geometry's changes.

Definition at line 461 of file mitkGizmo.cpp.

References mitk::New(), and OnFollowedGeometryModified().

virtual bool mitk::Gizmo::GetAllowRotation ( ) const

virtual

virtual bool mitk::Gizmo::GetAllowScaling ( ) const

virtual

virtual bool mitk::Gizmo::GetAllowTranslation ( ) const

virtual

virtual Vector3D mitk::Gizmo::GetAxisX ( ) const

virtual

virtual Vector3D mitk::Gizmo::GetAxisY ( ) const

virtual

virtual Vector3D mitk::Gizmo::GetAxisZ ( ) const

virtual

virtual Point3D mitk::Gizmo::GetCenter ( ) const

virtual

mitk::Gizmo::HandleType mitk::Gizmo::GetHandleFromPointDataValue ( double value )

Determine the nature of the the given vertex data value. Can be used after picking a vertex data value to determine what part of the gizmo has been picked.

Definition at line 498 of file mitkGizmo.cpp.

References CheckHandleType.

mitk::Gizmo::HandleType mitk::Gizmo::GetHandleFromPointID ( vtkIdType id )

Determine the nature of the the given vertex id. Can be used after picking a vertex id to determine what part of the gizmo has been picked.

Definition at line 518 of file mitkGizmo.cpp.

double mitk::Gizmo::GetLongestRadius ( ) const

Return the longest of the three axes.

Definition at line 415 of file mitkGizmo.cpp.

References max().

virtual Vector3D mitk::Gizmo::GetRadius ( ) const

virtual

std::string mitk::Gizmo::HandleTypeToString ( HandleType type )

static

Conversion for any kind of logging/debug/... purposes.

Definition at line 527 of file mitkGizmo.cpp.

References CheckHandleType.

bool mitk::Gizmo::HasGizmoAttached	(	mitk::DataNode *	node,
		DataStorage *	storage
	)

static

Returns: whether given node in given storage has a gizmo attached.

Definition at line 129 of file mitkGizmo.cpp.

References mitk::DataStorage::GetDerivations(), and mitk::TNodePredicateDataType< T >::New().

mitk::Gizmo::mitkClassMacro	(	Gizmo	,
		Surface
	)

static Pointer mitk::Gizmo::New ( )

static

Referenced by AddGizmoToNode().

void mitk::Gizmo::OnFollowedGeometryModified ( )

The ITK callback to receive modified events of the followed geometry.

Definition at line 478 of file mitkGizmo.cpp.

Referenced by FollowGeometry().

Gizmo& mitk::Gizmo::operator= ( const Gizmo & )

protected

bool mitk::Gizmo::RemoveGizmoFromNode	(	DataNode *	node,
		DataStorage *	storage
	)

static

Convenience removal of gizmo from given node

Parameters

node	The node being currently manipulated
storage	The DataStorage where the gizmo has been added to

Returns: true if the gizmo has been found and removed successfully

Make sure to pass the same parameters here that you provided to a previous call to AddGizmoToNode.

Returns: DataNode::Pointer containing the node used for vizualization of our gizmo

Definition at line 136 of file mitkGizmo.cpp.

References mitk::PropertyList::DeleteProperty(), mitk::DataStorage::GetDerivations(), mitk::DataNode::GetFloatProperty(), mitk::DataNode::GetPropertyList(), mitk::TNodePredicateDataType< T >::New(), mitk::DataStorage::Remove(), and mitk::DataNode::SetOpacity().

virtual void mitk::Gizmo::SetAllowRotation ( bool _arg )

virtual

virtual void mitk::Gizmo::SetAllowScaling ( bool _arg )

virtual

virtual void mitk::Gizmo::SetAllowTranslation ( bool _arg )

virtual

virtual void mitk::Gizmo::SetAxisX ( Vector3D _arg )

virtual

virtual void mitk::Gizmo::SetAxisY ( Vector3D _arg )

virtual

virtual void mitk::Gizmo::SetAxisZ ( Vector3D _arg )

virtual

virtual void mitk::Gizmo::SetCenter ( Point3D _arg )

virtual

virtual void mitk::Gizmo::SetRadius ( Vector3D _arg )

virtual

void mitk::Gizmo::UpdateRepresentation ( )

Updates the representing surface object after changes to center, axes, or radius.

Definition at line 245 of file mitkGizmo.cpp.

Referenced by Gizmo().

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

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation