Mapper to resample and display 2D slices of a 3D labelset image. More...

#include <mitkLabelSetImageVtkMapper2D.h>

Inheritance diagram for mitk::LabelSetImageVtkMapper2D:

Collaboration diagram for mitk::LabelSetImageVtkMapper2D:

Classes
class	LocalStorage
	Internal class holding the mapper, actor, etc. for each of the 3 2D render windows. More...

Public Member Functions
	mitkClassMacro (LabelSetImageVtkMapper2D, VtkMapper)

const mitk::Image *	GetInput (void)
	Get the Image to map. More...

virtual void	Update (mitk::BaseRenderer *renderer) override
	Checks whether this mapper needs to update itself and generate data. More...

virtual vtkProp *	GetVtkProp (mitk::BaseRenderer *renderer) override

LocalStorage *	GetLocalStorage (mitk::BaseRenderer *renderer)
	Get the LocalStorage corresponding to the current renderer. More...

void	ApplyRenderingMode (mitk::BaseRenderer *renderer)
	This method switches between different rendering modes (e.g. use a lookup table or a transfer function). Detailed documentation about the modes can be found here: mitk::RenderingerModeProperty. More...

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

virtual const char *	GetClassName () const

virtual bool	IsVtkBased () const override
	Returns whether this is an vtk-based mapper. More...

void	MitkRender (mitk::BaseRenderer *renderer, mitk::VtkPropRenderer::RenderType type) override
	Determines which geometry should be rendered (opaque, translucent, volumetric, overlay) and calls the appropriate function. More...

virtual void	MitkRenderOverlay (BaseRenderer *renderer)
	Checks visibility and renders the overlay. More...

virtual void	MitkRenderOpaqueGeometry (BaseRenderer *renderer)
	Checks visibility and renders untransparent geometry. More...

virtual void	MitkRenderTranslucentGeometry (BaseRenderer *renderer)
	Checks visiblity and renders transparent geometry. More...

virtual void	MitkRenderVolumetricGeometry (BaseRenderer *renderer)
	Checks visibility and renders volumes. More...

virtual bool	HasVtkProp (const vtkProp prop, BaseRenderer renderer)
	Returns true if this mapper owns the specified vtkProp for the given BaseRenderer. More...

virtual void	UpdateVtkTransform (mitk::BaseRenderer *renderer)
	Set the vtkTransform of the m_Prop3D for the current time step of renderer. More...

virtual void	ApplyProperties (vtkActor actor, mitk::BaseRenderer renderer)
	Apply color and opacity properties read from the PropertyList. More...

void	ApplyShaderProperties (mitk::BaseRenderer *renderer)
	SHADERTODO. More...

virtual void	ApplyColorAndOpacityProperties (mitk::BaseRenderer renderer, vtkActor actor) override
	Apply color and opacity properties read from the PropertyList. Called by mapper subclasses. More...

virtual void	ReleaseGraphicsResources (mitk::BaseRenderer *)
	Release vtk-based graphics resources that are being consumed by this mapper. More...

Public Member Functions inherited from mitk::Mapper
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. Method only returns valid DataNode Pointer if the mapper belongs to a data node. Otherwise, the returned DataNode Pointer might be invalid. More...

BaseData *	GetData () const
	Get the data to map. More...

virtual bool	GetColor (float rgb[3], BaseRenderer renderer, const char name="color") const
	Convenience access method for color properties (instances of ColorProperty) More...

virtual bool	GetVisibility (bool &visible, BaseRenderer renderer, const char name="visible") const
	Convenience access method for visibility properties (instances of BoolProperty) More...

virtual bool	GetOpacity (float &opacity, BaseRenderer renderer, const char name="opacity") const
	Convenience access method for opacity properties (instances of FloatProperty) More...

virtual bool	GetLevelWindow (LevelWindow &levelWindow, BaseRenderer renderer, const char name="levelwindow") const
	Convenience access method for color properties (instances of LevelWindoProperty) More...

virtual bool	IsVisible (BaseRenderer renderer, const char name="visible") const
	Convenience access method for visibility properties (instances of BoolProperty). Return value is the visibility. Default is visible==true, i.e., true is returned even if the property (propertyKey) is not found. More...

int	GetTimestep () const
	Returns the current time step as calculated from the renderer. More...

virtual bool	IsLODEnabled (BaseRenderer *) const

Static Public Member Functions
static Pointer	New ()

static void	SetDefaultProperties (mitk::DataNode node, mitk::BaseRenderer renderer=NULL, bool overwrite=false)
	Set the default properties for general image rendering. More...

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

static void	SetVtkMapperImmediateModeRendering (vtkMapper *mapper)
	Re-issues all drawing commands required to describe the entire scene each time a new frame is required, regardless of actual changes. More...

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

static void	SetDefaultProperties (DataNode node, BaseRenderer renderer=nullptr, bool overwrite=false)
	Set default values of properties used by this mapper to node. More...

Public Attributes
mitk::LocalStorageHandler< LocalStorage >	m_LSH
	The LocalStorageHandler holds all (three) LocalStorages for the three 2D render windows. More...

Public Attributes inherited from mitk::VtkMapper
mitk::LocalStorageHandler< VtkMapperLocalStorage >	m_VtkMapperLSH

Protected Member Functions
void	TransformActor (mitk::BaseRenderer *renderer)
	Transforms the actor to the actual position in 3D. More...

void	GeneratePlane (mitk::BaseRenderer *renderer, double planeBounds[6])
	Generates a plane according to the size of the resliced image in milimeters. More...

vtkSmartPointer< vtkPolyData >	CreateOutlinePolyData (mitk::BaseRenderer renderer, vtkImageData image, int pixelValue=1)
	Generates a vtkPolyData object containing the outline of a given binary slice. More...

	LabelSetImageVtkMapper2D ()

virtual	~LabelSetImageVtkMapper2D ()

virtual void	GenerateDataForRenderer (mitk::BaseRenderer *renderer) override
	Does the actual resampling, without rendering the image yet. All the data is generated inside this method. The vtkProp (or Actor) is filled with content (i.e. the resliced image). More...

float	CalculateLayerDepth (mitk::BaseRenderer *renderer)
	This method uses the vtkCamera clipping range and the layer property to calcualte the depth of the object (e.g. image or contour). The depth is used to keep the correct order for the final VTK rendering. More...

void	ApplyLookuptable (mitk::BaseRenderer *renderer, int layer)
	This method applies (or modifies) the lookuptable for all types of images. More...

void	ApplyColorTransferFunction (mitk::BaseRenderer *renderer)
	This method applies a color transfer function. Internally, a vtkColorTransferFunction is used. This is usefull for coloring continous images (e.g. float) More...

void	ApplyLevelWindow (mitk::BaseRenderer *renderer)
	ApplyLevelWindow Apply the level window for the given renderer. More...

void	ApplyColor (mitk::BaseRenderer *renderer, const mitk::Color &color)
	Set the color of the image/polydata. More...

void	ApplyOpacity (mitk::BaseRenderer *renderer, int layer)
	Set the opacity of the actor. More...

bool	RenderingGeometryIntersectsImage (const PlaneGeometry renderingGeometry, SlicedGeometry3D imageGeometry)
	Calculates whether the given rendering geometry intersects the given SlicedGeometry3D. More...

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

virtual	~VtkMapper ()

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

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

virtual void	GenerateData ()
	Generate the data needed for rendering (independent of a specific 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...

virtual OverlayManager *	GetOverlayManager () const

Additional Inherited Members
Public Types inherited from mitk::VtkMapper
typedef VtkMapper	Self

typedef Mapper	Superclass

typedef itk::SmartPointer< Self >	Pointer

typedef itk::SmartPointer< const Self >	ConstPointer

Public Types inherited from mitk::Mapper
typedef Mapper	Self

typedef itk::Object	Superclass

typedef itk::SmartPointer< Self >	Pointer

typedef itk::SmartPointer< const Self >	ConstPointer

Protected Attributes inherited from mitk::Mapper
mitk::DataNode *	m_DataNode

Detailed Description

Mapper to resample and display 2D slices of a 3D labelset image.

Properties that can be set for labelset images and influence this mapper are:

"labelset.contour.active": (BoolProperty) whether to show only the active label as a contour or not
"labelset.contour.width": (FloatProperty) line width of the contour

The default properties are:

"labelset.contour.active", mitk::BoolProperty::New( true ), renderer, overwrite )
"labelset.contour.width", mitk::FloatProperty::New( 2.0 ), renderer, overwrite )

Definition at line 62 of file mitkLabelSetImageVtkMapper2D.h.

Constructor & Destructor Documentation

mitk::LabelSetImageVtkMapper2D::LabelSetImageVtkMapper2D ( )

protected

Default constructor

Definition at line 59 of file mitkLabelSetImageVtkMapper2D.cpp.

mitk::LabelSetImageVtkMapper2D::~LabelSetImageVtkMapper2D ( )

protectedvirtual

Default deconstructor

Definition at line 63 of file mitkLabelSetImageVtkMapper2D.cpp.

Member Function Documentation

void mitk::LabelSetImageVtkMapper2D::ApplyColor	(	mitk::BaseRenderer *	renderer,
		const mitk::Color &	color
	)

protected

Set the color of the image/polydata.

Definition at line 474 of file mitkLabelSetImageVtkMapper2D.cpp.

References mitk::LabelSetImageVtkMapper2D::LocalStorage::m_OutlineActor, and mitk::LabelSetImageVtkMapper2D::LocalStorage::m_OutlineShadowActor.

void mitk::LabelSetImageVtkMapper2D::ApplyColorTransferFunction ( mitk::BaseRenderer * renderer )

protected

This method applies a color transfer function. Internally, a vtkColorTransferFunction is used. This is usefull for coloring continous images (e.g. float)

Warning: To use the color transfer function, the property 'Image Rendering.Transfer Function' must be set and a 'Image Rendering.Mode' which uses the color transfer function must be set.

void mitk::LabelSetImageVtkMapper2D::ApplyLevelWindow ( mitk::BaseRenderer * renderer )

protected

ApplyLevelWindow Apply the level window for the given renderer.

Warning: To use the level window, the property 'LevelWindow' must be set and a 'Image Rendering.Mode' which uses the level window must be set.

Parameters

renderer Level window for which renderer?

void mitk::LabelSetImageVtkMapper2D::ApplyLookuptable	(	mitk::BaseRenderer *	renderer,
		int	layer
	)

protected

This method applies (or modifies) the lookuptable for all types of images.

Warning: To use the lookup table, the property 'Lookup Table' must be set and a 'Image Rendering.Mode' which uses the lookup table must be set.

Definition at line 491 of file mitkLabelSetImageVtkMapper2D.cpp.

References mitk::LabelSetImage::GetLabelSet(), and mitk::LabelSetImageVtkMapper2D::LocalStorage::m_LevelWindowFilterVector.

void mitk::LabelSetImageVtkMapper2D::ApplyOpacity	(	mitk::BaseRenderer *	renderer,
		int	layer
	)

protected

Set the opacity of the actor.

Definition at line 481 of file mitkLabelSetImageVtkMapper2D.cpp.

References mitk::LabelSetImageVtkMapper2D::LocalStorage::m_LayerActorVector, mitk::LabelSetImageVtkMapper2D::LocalStorage::m_OutlineActor, and mitk::LabelSetImageVtkMapper2D::LocalStorage::m_OutlineShadowActor.

void mitk::LabelSetImageVtkMapper2D::ApplyRenderingMode ( mitk::BaseRenderer * renderer )

This method switches between different rendering modes (e.g. use a lookup table or a transfer function). Detailed documentation about the modes can be found here: mitk::RenderingerModeProperty.

float mitk::LabelSetImageVtkMapper2D::CalculateLayerDepth ( mitk::BaseRenderer * renderer )

protected

This method uses the vtkCamera clipping range and the layer property to calcualte the depth of the object (e.g. image or contour). The depth is used to keep the correct order for the final VTK rendering.

Definition at line 559 of file mitkLabelSetImageVtkMapper2D.cpp.

References mitk::BaseRenderer::GetVtkRenderer(), and MITK_WARN.

vtkSmartPointer< vtkPolyData > mitk::LabelSetImageVtkMapper2D::CreateOutlinePolyData	(	mitk::BaseRenderer *	renderer,
		vtkImageData *	image,
		int	pixelValue = `1`
	)

protected

Generates a vtkPolyData object containing the outline of a given binary slice.

Parameters

renderer Pointer to the renderer containing the needed information

Note: This code is based on code from the iil library.

Definition at line 314 of file mitkLabelSetImageVtkMapper2D.cpp.

References line, mitk::LabelSetImageVtkMapper2D::LocalStorage::m_mmPerPixel, and mitk::New().

void mitk::LabelSetImageVtkMapper2D::GenerateDataForRenderer ( mitk::BaseRenderer * renderer )

overrideprotectedvirtual

Does the actual resampling, without rendering the image yet. All the data is generated inside this method. The vtkProp (or Actor) is filled with content (i.e. the resliced image).

After generation, a 4x4 transformation matrix(t) of the current slice is obtained from the vtkResliceImage object via GetReslicesAxis(). This matrix is applied to each textured plane (actor->SetUserTransform(t)) to transform everything to the actual 3D position (cf. the following image).

Reimplemented from mitk::Mapper.

Definition at line 79 of file mitkLabelSetImageVtkMapper2D.cpp.

void mitk::LabelSetImageVtkMapper2D::GeneratePlane	(	mitk::BaseRenderer *	renderer,
		double	planeBounds[6]
	)

protected

Generates a plane according to the size of the resliced image in milimeters.

In VTK a vtkPlaneSource is defined through three points. The origin and two points defining the axes of the plane (see VTK documentation). The origin is set to (xMin; yMin; Z), where xMin and yMin are the minimal bounds of the resliced image in space. Z is relevant for blending and the layer property. The center of the plane (C) is also the center of the view plane (cf. the image above).

Note: For the standard MITK view with three 2D render windows showing three different slices, three such planes are generated. All these planes are generated in the XY-plane (even if they depict a YZ-slice of the volume).

Definition at line 544 of file mitkLabelSetImageVtkMapper2D.cpp.

References mitk::LabelSetImageVtkMapper2D::LocalStorage::m_Plane.

const mitk::Image* mitk::LabelSetImageVtkMapper2D::GetInput ( void )

Get the Image to map.

mitk::LabelSetImageVtkMapper2D::LocalStorage * mitk::LabelSetImageVtkMapper2D::GetLocalStorage ( mitk::BaseRenderer * renderer )

Get the LocalStorage corresponding to the current renderer.

Definition at line 73 of file mitkLabelSetImageVtkMapper2D.cpp.

vtkProp * mitk::LabelSetImageVtkMapper2D::GetVtkProp ( mitk::BaseRenderer * renderer )

overridevirtual

Implements mitk::VtkMapper.

Definition at line 67 of file mitkLabelSetImageVtkMapper2D.cpp.

mitk::LabelSetImageVtkMapper2D::mitkClassMacro	(	LabelSetImageVtkMapper2D	,
		VtkMapper
	)

Standard class typedefs.

static Pointer mitk::LabelSetImageVtkMapper2D::New ( )

static

Method for creation through the object factory.

Referenced by mitk::MultilabelObjectFactory::CreateMapper().

bool mitk::LabelSetImageVtkMapper2D::RenderingGeometryIntersectsImage	(	const PlaneGeometry *	renderingGeometry,
		SlicedGeometry3D *	imageGeometry
	)

protected

Calculates whether the given rendering geometry intersects the given SlicedGeometry3D.

This method checks if the given Geometry2D intersects the given SlicedGeometry3D. It calculates the distance of the Geometry2D to all 8 cornerpoints of the SlicedGeometry3D. If all distances have the same sign (all positive or all negative) there is no intersection. If the distances have different sign, there is an intersection.

Definition at line 285 of file mitkLabelSetImageVtkMapper2D.cpp.

References mitk::BaseGeometry::GetCornerPoint(), and mitk::PlaneGeometry::SignedDistance().