OpenGL-based mapper to render display sub-class instances of mitk::PlanarFigure. More...

#include <mitkPlanarFigureMapper2D.h>

Inheritance diagram for mitk::PlanarFigureMapper2D:

Collaboration diagram for mitk::PlanarFigureMapper2D:

[legend]

Public Member Functions
	mitkClassMacro (PlanarFigureMapper2D, Mapper)

Pointer	Clone () const

void	MitkRender (mitk::BaseRenderer *renderer, mitk::VtkPropRenderer::RenderType type) override

void	ApplyColorAndOpacityProperties (mitk::BaseRenderer renderer, vtkActor actor=nullptr) override
	Apply color and opacity properties read from the PropertyList. The actor parameter is unused; color and opacity are applied via vtkContext2D. More...

Public Member Functions inherited from mitk::Mapper
	mitkClassMacroItkParent (Mapper, itk::Object)

virtual void	SetDataNode (DataNode *_arg)
	Set the DataNode containing the data to map. More...

virtual DataNode *	GetDataNode () const
	Get the DataNode containing the data to map. More...

virtual void	Update (BaseRenderer *renderer)
	Calculate the time step for the current renderer and generate rendering data. More...

TimeStepType	GetTimestep () const
	Return the current time step as calculated from the renderer. More...

virtual bool	IsLODEnabled (BaseRenderer *) const
	Return whether this Mapper currently allows for Level-of-Detail rendering. More...

Static Public Member Functions
static Pointer	New ()

static void	SetDefaultProperties (mitk::DataNode node, mitk::BaseRenderer renderer=nullptr, bool overwrite=false)

Static Public Member Functions inherited from mitk::Mapper
static void	SetDefaultProperties (DataNode node, BaseRenderer renderer=nullptr, bool overwrite=false)
	Set default values of properties used by this mapper on the given node. More...

Protected Types
enum	PlanarFigureDisplayMode { PF_DEFAULT , PF_HOVER , PF_SELECTED , PF_COUNT }

Protected Member Functions
	PlanarFigureMapper2D ()

	~PlanarFigureMapper2D () override

void	RenderLines (const PlanarFigureDisplayMode lineDisplayMode, mitk::PlanarFigure planarFigure, mitk::Point2D &anchorPoint, const mitk::PlaneGeometry planarFigurePlaneGeometry, const mitk::PlaneGeometry rendererPlaneGeometry, const mitk::BaseRenderer renderer, vtkContext2D *context2D)
	Renders all the lines defined by the PlanarFigure. More...

void	RenderQuantities (const mitk::PlanarFigure planarFigure, mitk::BaseRenderer renderer, const mitk::Point2D anchorPoint, double &annotationOffset, float globalOpacity, const PlanarFigureDisplayMode lineDisplayMode, vtkContext2D *context2D)
	Renders the quantities of the figure below the text annotations. More...

void	RenderAnnotations (mitk::BaseRenderer renderer, const std::string name, const mitk::Point2D anchorPoint, float globalOpacity, const PlanarFigureDisplayMode lineDisplayMode, double &annotationOffset, vtkContext2D context2D)
	Renders the text annotations. More...

void	RenderControlPoints (const mitk::PlanarFigure planarFigure, const PlanarFigureDisplayMode lineDisplayMode, const mitk::PlaneGeometry planarFigurePlaneGeometry, const mitk::PlaneGeometry rendererPlaneGeometry, mitk::BaseRenderer renderer, vtkContext2D *context2D)
	Renders the control-points. More...

void	TransformObjectToDisplay (const mitk::Point2D &point2D, mitk::Point2D &displayPoint, const mitk::PlaneGeometry objectGeometry, const mitk::PlaneGeometry , const mitk::BaseRenderer *renderer)

void	DrawMarker (const mitk::Point2D &point, float lineColor, float lineOpacity, float markerColor, float markerOpacity, float lineWidth, PlanarFigureControlPointStyleProperty::Shape shape, const mitk::PlaneGeometry objectGeometry, const mitk::PlaneGeometry rendererGeometry, const mitk::BaseRenderer renderer, vtkContext2D context2D)

void	PaintPolyLine (const PlanarFigure::PolyLineType &vertices, bool closed, Point2D &anchorPoint, const PlaneGeometry planarFigurePlaneGeometry, const PlaneGeometry rendererPlaneGeometry, const mitk::BaseRenderer renderer, vtkContext2D context2D)
	Actually paints the polyline defined by the figure. More...

void	DrawMainLines (mitk::PlanarFigure figure, Point2D &anchorPoint, const PlaneGeometry planarFigurePlaneGeometry, const PlaneGeometry rendererPlaneGeometry, const mitk::BaseRenderer renderer, vtkContext2D *context2D)
	Internally used by RenderLines() to draw the mainlines using PaintPolyLine(). More...

void	DrawHelperLines (mitk::PlanarFigure figure, Point2D &anchorPoint, const PlaneGeometry planarFigurePlaneGeometry, const PlaneGeometry rendererPlaneGeometry, const mitk::BaseRenderer renderer, vtkContext2D *context2D)
	Internally used by RenderLines() to draw the helperlines using PaintPolyLine(). More...

void	InitializeDefaultPlanarFigureProperties ()

void	InitializePlanarFigurePropertiesFromDataNode (const mitk::DataNode *node)

void	SetColorProperty (float property[3][3], PlanarFigureDisplayMode mode, float red, float green, float blue)

void	SetFloatProperty (float *property, PlanarFigureDisplayMode mode, float value)

void	OnNodeModified ()
	Callback that sets m_NodeModified to true. More...

void	Initialize (mitk::BaseRenderer *renderer)

Protected Member Functions inherited from mitk::Mapper
	Mapper ()
	explicit constructor which disallows implicit conversions More...

	~Mapper () override
	virtual destructor in order to derive from this class More...

virtual void	GenerateDataForRenderer (BaseRenderer *)
	Generate the data needed for rendering into renderer. More...

virtual void	CalculateTimeStep (BaseRenderer *renderer)
	Updates the time step, which is sometimes needed in subclasses. More...

virtual void	ResetMapper (BaseRenderer *)
	Reset the mapper (i.e., make sure that nothing is displayed) if no valid data is present. In most cases the reimplemented function disables the according actors (toggling visibility off) More...

Additional Inherited Members
Protected Attributes inherited from mitk::Mapper
mitk::DataNode *	m_DataNode

Detailed Description

OpenGL-based mapper to render display sub-class instances of mitk::PlanarFigure.

The appearance of planar figures can be configured through properties. If no properties are specified, default values will be used. There are four elements a planar figure consists of:

"line": the main line segments of the planar figure (note: text is drawn in the same style)
"helperline": additional line segments of planar figures, such as arrow tips, arches of angles, etc.
"outline": background which is drawn behind the lines and helperlines of the planar figure (optional)
"marker": the markers (control points) of a planar figure
"markerline": the lines by which markers (control points) are surrounded

In the following, all appearance-related planar figure properties are listed:

General properties for the planar figure
- "planarfigure.drawoutline": if true, the "outline" lines is drawn
- "planarfigure.drawquantities": if true, the quantities (text) associated with the planar figure is drawn
- "planarfigure.drawname": if true, the name specified by the dataNode is drawn
- "planarfigure.drawshadow": if true, a black shadow is drawn around the planar figure
- "planarfigure.controlpointshape": style of the control points (enum)
Line widths of planar figure elements
- "planarfigure.line.width": width of "line" segments (float value, in mm)
- "planarfigure.shadow.widthmodifier": the width of the shadow is defined by width of the "line" * this modifier
- "planarfigure.outline.width": width of "outline" segments (float value, in mm)
- "planarfigure.helperline.width": width of "helperline" segments (float value, in mm)
Color/opacity of planar figure elements in normal mode (unselected)
- "planarfigure.default.line.color"
- "planarfigure.default.line.opacity"
- "planarfigure.default.outline.color"
- "planarfigure.default.outline.opacity"
- "planarfigure.default.helperline.color"
- "planarfigure.default.helperline.opacity"
- "planarfigure.default.markerline.color"
- "planarfigure.default.markerline.opacity"
- "planarfigure.default.marker.color"
- "planarfigure.default.marker.opacity"
Color/opacity of planar figure elements in hover mode (mouse-over)
- "planarfigure.hover.line.color"
- "planarfigure.hover.line.opacity"
- "planarfigure.hover.outline.color"
- "planarfigure.hover.outline.opacity"
- "planarfigure.hover.helperline.color"
- "planarfigure.hover.helperline.opacity"
- "planarfigure.hover.markerline.color"
- "planarfigure.hover.markerline.opacity"
- "planarfigure.hover.marker.color"
- "planarfigure.hover.marker.opacity"
Color/opacity of planar figure elements in selected mode
- "planarfigure.selected.line.color"
- "planarfigure.selected.line.opacity"
- "planarfigure.selected.outline.color"
- "planarfigure.selected.outline.opacity"
- "planarfigure.selected.helperline.color"
- "planarfigure.selected.helperline.opacity"
- "planarfigure.selected.markerline.color;"
- "planarfigure.selected.markerline.opacity"
- "planarfigure.selected.marker.color"
- "planarfigure.selected.marker.opacity"

Definition at line 108 of file mitkPlanarFigureMapper2D.h.

Member Enumeration Documentation

◆ PlanarFigureDisplayMode

enum mitk::PlanarFigureMapper2D::PlanarFigureDisplayMode

protected

Enumerator
PF_DEFAULT
PF_HOVER
PF_SELECTED
PF_COUNT

Definition at line 130 of file mitkPlanarFigureMapper2D.h.

Constructor & Destructor Documentation

◆ PlanarFigureMapper2D()

mitk::PlanarFigureMapper2D::PlanarFigureMapper2D ( )

protected

◆ ~PlanarFigureMapper2D()

mitk::PlanarFigureMapper2D::~PlanarFigureMapper2D ( )

overrideprotected

Member Function Documentation

◆ ApplyColorAndOpacityProperties()

void mitk::PlanarFigureMapper2D::ApplyColorAndOpacityProperties	(	mitk::BaseRenderer *	renderer,
		vtkActor *	actor = `nullptr`
	)

overridevirtual

Apply color and opacity properties read from the PropertyList. The actor parameter is unused; color and opacity are applied via vtkContext2D.

Implements mitk::Mapper.

◆ Clone()

Pointer mitk::PlanarFigureMapper2D::Clone ( ) const

◆ DrawHelperLines()

void mitk::PlanarFigureMapper2D::DrawHelperLines	(	mitk::PlanarFigure *	figure,
		Point2D &	anchorPoint,
		const PlaneGeometry *	planarFigurePlaneGeometry,
		const PlaneGeometry *	rendererPlaneGeometry,
		const mitk::BaseRenderer *	renderer,
		vtkContext2D *	context2D
	)

protected

Internally used by RenderLines() to draw the helperlines using PaintPolyLine().

◆ DrawMainLines()

void mitk::PlanarFigureMapper2D::DrawMainLines	(	mitk::PlanarFigure *	figure,
		Point2D &	anchorPoint,
		const PlaneGeometry *	planarFigurePlaneGeometry,
		const PlaneGeometry *	rendererPlaneGeometry,
		const mitk::BaseRenderer *	renderer,
		vtkContext2D *	context2D
	)

protected

Internally used by RenderLines() to draw the mainlines using PaintPolyLine().

◆ DrawMarker()

void mitk::PlanarFigureMapper2D::DrawMarker	(	const mitk::Point2D &	point,
		float *	lineColor,
		float	lineOpacity,
		float *	markerColor,
		float	markerOpacity,
		float	lineWidth,
		PlanarFigureControlPointStyleProperty::Shape	shape,
		const mitk::PlaneGeometry *	objectGeometry,
		const mitk::PlaneGeometry *	rendererGeometry,
		const mitk::BaseRenderer *	renderer,
		vtkContext2D *	context2D
	)

protected

◆ Initialize()

void mitk::PlanarFigureMapper2D::Initialize ( mitk::BaseRenderer * renderer )

protected

◆ InitializeDefaultPlanarFigureProperties()

void mitk::PlanarFigureMapper2D::InitializeDefaultPlanarFigureProperties ( )

protected

◆ InitializePlanarFigurePropertiesFromDataNode()

void mitk::PlanarFigureMapper2D::InitializePlanarFigurePropertiesFromDataNode ( const mitk::DataNode * node )

protected

◆ mitkClassMacro()

mitk::PlanarFigureMapper2D::mitkClassMacro	(	PlanarFigureMapper2D	,
		Mapper
	)

◆ MitkRender()

void mitk::PlanarFigureMapper2D::MitkRender	(	mitk::BaseRenderer *	renderer,
		mitk::VtkPropRenderer::RenderType	type
	)

overridevirtual

reimplemented from Baseclass

Implements mitk::Mapper.

◆ New()

static Pointer mitk::PlanarFigureMapper2D::New ( )

static

◆ OnNodeModified()

void mitk::PlanarFigureMapper2D::OnNodeModified ( )

protected

Callback that sets m_NodeModified to true.

This method set the bool flag m_NodeModified to true. It's a callback that is executed when a itk::ModifiedEvet is invoked on our DataNode.

◆ PaintPolyLine()

void mitk::PlanarFigureMapper2D::PaintPolyLine	(	const PlanarFigure::PolyLineType &	vertices,
		bool	closed,
		Point2D &	anchorPoint,
		const PlaneGeometry *	planarFigurePlaneGeometry,
		const PlaneGeometry *	rendererPlaneGeometry,
		const mitk::BaseRenderer *	renderer,
		vtkContext2D *	context2D
	)

protected

Actually paints the polyline defined by the figure.

◆ RenderAnnotations()

void mitk::PlanarFigureMapper2D::RenderAnnotations	(	mitk::BaseRenderer *	renderer,
		const std::string	name,
		const mitk::Point2D	anchorPoint,
		float	globalOpacity,
		const PlanarFigureDisplayMode	lineDisplayMode,
		double &	annotationOffset,
		vtkContext2D *	context2D
	)

protected

Renders the text annotations.

◆ RenderControlPoints()

void mitk::PlanarFigureMapper2D::RenderControlPoints	(	const mitk::PlanarFigure *	planarFigure,
		const PlanarFigureDisplayMode	lineDisplayMode,
		const mitk::PlaneGeometry *	planarFigurePlaneGeometry,
		const mitk::PlaneGeometry *	rendererPlaneGeometry,
		mitk::BaseRenderer *	renderer,
		vtkContext2D *	context2D
	)

protected

Renders the control-points.

◆ RenderLines()

void mitk::PlanarFigureMapper2D::RenderLines	(	const PlanarFigureDisplayMode	lineDisplayMode,
		mitk::PlanarFigure *	planarFigure,
		mitk::Point2D &	anchorPoint,
		const mitk::PlaneGeometry *	planarFigurePlaneGeometry,
		const mitk::PlaneGeometry *	rendererPlaneGeometry,
		const mitk::BaseRenderer *	renderer,
		vtkContext2D *	context2D
	)

protected

Renders all the lines defined by the PlanarFigure.

This method renders all the lines that are defined by the PlanarFigure. That includes the mainlines and helperlines as well as their shadows and the outlines.

This method already takes responsibility for the setting of the relevant openGL attributes to reduce unnecessary setting of these attributes. (e.g. no need to set color twice if it's the same)

◆ RenderQuantities()

void mitk::PlanarFigureMapper2D::RenderQuantities	(	const mitk::PlanarFigure *	planarFigure,
		mitk::BaseRenderer *	renderer,
		const mitk::Point2D	anchorPoint,
		double &	annotationOffset,
		float	globalOpacity,
		const PlanarFigureDisplayMode	lineDisplayMode,
		vtkContext2D *	context2D
	)

protected

Renders the quantities of the figure below the text annotations.

◆ SetColorProperty()

void mitk::PlanarFigureMapper2D::SetColorProperty	(	float	property[3][3],
		PlanarFigureDisplayMode	mode,
		float	red,
		float	green,
		float	blue
	)

inlineprotected

Definition at line 249 of file mitkPlanarFigureMapper2D.h.

◆ SetDefaultProperties()

static void mitk::PlanarFigureMapper2D::SetDefaultProperties	(	mitk::DataNode *	node,
		mitk::BaseRenderer *	renderer = `nullptr`,
		bool	overwrite = `false`
	)

static

◆ SetFloatProperty()

void mitk::PlanarFigureMapper2D::SetFloatProperty	(	float *	property,
		PlanarFigureDisplayMode	mode,
		float	value
	)

inlineprotected

Definition at line 256 of file mitkPlanarFigureMapper2D.h.

◆ TransformObjectToDisplay()

void mitk::PlanarFigureMapper2D::TransformObjectToDisplay	(	const mitk::Point2D &	point2D,
		mitk::Point2D &	displayPoint,
		const mitk::PlaneGeometry *	objectGeometry,
		const mitk::PlaneGeometry *	,
		const mitk::BaseRenderer *	renderer
	)

protected

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

mitkPlanarFigureMapper2D.h

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ PlanarFigureDisplayMode

Constructor & Destructor Documentation

◆ PlanarFigureMapper2D()

◆ ~PlanarFigureMapper2D()

Member Function Documentation

◆ ApplyColorAndOpacityProperties()

◆ Clone()

◆ DrawHelperLines()

◆ DrawMainLines()

◆ DrawMarker()

◆ Initialize()

◆ InitializeDefaultPlanarFigureProperties()

◆ InitializePlanarFigurePropertiesFromDataNode()

◆ mitkClassMacro()

◆ MitkRender()

◆ New()

◆ OnNodeModified()

◆ PaintPolyLine()

◆ RenderAnnotations()

◆ RenderControlPoints()

◆ RenderLines()

◆ RenderQuantities()

◆ SetColorProperty()

◆ SetDefaultProperties()

◆ SetFloatProperty()

◆ TransformObjectToDisplay()