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

#include <mitkLabelSetImageVtkMapper2D.h>

Inheritance diagram for mitk::LabelSetImageVtkMapper2D:

[legend]

Collaboration diagram for mitk::LabelSetImageVtkMapper2D:

[legend]

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...

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

vtkProp *	GetVtkProp (mitk::BaseRenderer *renderer) override
	Get the VTK prop for MITK-VTK rendering pipeline. More...

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::RenderingModeProperty. More...

Public Member Functions inherited from mitk::VtkMapper
	mitkClassMacro (VtkMapper, Mapper)

void	MitkRender (mitk::BaseRenderer *renderer, mitk::VtkPropRenderer::RenderType type) override
	Determine the render pass type and call the appropriate render method. More...

virtual void	MitkRenderOverlay (BaseRenderer *renderer)
	Check visibility and render the overlay pass. More...

virtual void	MitkRenderOpaqueGeometry (BaseRenderer *renderer)
	Check visibility and render opaque (untransparent) geometry. More...

virtual void	MitkRenderTranslucentGeometry (BaseRenderer *renderer)
	Check visibility and render translucent (transparent) geometry. More...

virtual void	MitkRenderVolumetricGeometry (BaseRenderer *renderer)
	Check visibility and render volumetric geometry. More...

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

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

void	ApplyColorAndOpacityProperties (mitk::BaseRenderer renderer, vtkActor actor) override
	Apply color and opacity properties read from the PropertyList to the given vtkActor. More...

virtual void	ReleaseGraphicsResources (mitk::BaseRenderer *)
	Release VTK-based graphics resources consumed by this mapper. 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...

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)
	Set the default properties for general image rendering. More...

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...

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

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 millimeters. 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 ()
	Default constructor. More...

	~LabelSetImageVtkMapper2D () override
	Default destructor. More...

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...

void	GenerateImageSlice (mitk::BaseRenderer *renderer, const std::vector< mitk::MultiLabelSegmentation::GroupIndexType > &outdatedGroupIDs)
	Generate the image slice for the given renderer and outdated group IDs. More...

void	GenerateActiveLabelOutline (mitk::BaseRenderer *renderer)
	Generate the outline for the currently active label. More...

void	GenerateLookupTable (mitk::BaseRenderer *renderer)
	Generates the look up table that should be used. More...

float	CalculateLayerDepth (mitk::BaseRenderer *renderer)
	This method uses the vtkCamera clipping range and the layer property to calculate 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...

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

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

	~VtkMapper () override

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	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

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 59 of file mitkLabelSetImageVtkMapper2D.h.

Constructor & Destructor Documentation

◆ LabelSetImageVtkMapper2D()

mitk::LabelSetImageVtkMapper2D::LabelSetImageVtkMapper2D ( )

protected

Default constructor.

◆ ~LabelSetImageVtkMapper2D()

mitk::LabelSetImageVtkMapper2D::~LabelSetImageVtkMapper2D ( )

overrideprotected

Default destructor.

Member Function Documentation

◆ ApplyRenderingMode()

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::RenderingModeProperty.

◆ CalculateLayerDepth()

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

protected

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

◆ CreateOutlinePolyData()

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
image
pixelValue

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

◆ GenerateActiveLabelOutline()

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

protected

Generate the outline for the currently active label.

Parameters

renderer The renderer to generate the outline for.

◆ GenerateDataForRenderer()

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.

◆ GenerateImageSlice()

void mitk::LabelSetImageVtkMapper2D::GenerateImageSlice	(	mitk::BaseRenderer *	renderer,
		const std::vector< mitk::MultiLabelSegmentation::GroupIndexType > &	outdatedGroupIDs
	)

protected

Generate the image slice for the given renderer and outdated group IDs.

Parameters

renderer	The renderer to generate the slice for.
outdatedGroupIDs	The group indices that need to be updated.

◆ GenerateLookupTable()

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

protected

Generates the look up table that should be used.

◆ GeneratePlane()

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

protected

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

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).

◆ GetInput()

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

Get the Image to map.

◆ GetLocalStorage()

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

Get the LocalStorage corresponding to the current renderer.

◆ GetVtkProp()

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

overridevirtual

Get the VTK prop for MITK-VTK rendering pipeline.

Parameters

renderer The renderer to get the prop for.

Returns: The vtkProp for rendering.

Implements mitk::VtkMapper.

◆ mitkClassMacro()

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

Standard class typedefs.

◆ New()

static Pointer mitk::LabelSetImageVtkMapper2D::New ( )

static

Method for creation through the object factory.

◆ RenderingGeometryIntersectsImage()

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

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.

◆ SetDefaultProperties()

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

static

Set the default properties for general image rendering.

◆ TransformActor()

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

protected

Transforms the actor to the actual position in 3D.

Parameters

renderer The current renderer corresponding to the render window.

◆ Update()

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

overridevirtual

Checks whether this mapper needs to update itself and generate data.

Reimplemented from mitk::Mapper.

Member Data Documentation

◆ m_LSH

mitk::LocalStorageHandler<LocalStorage> mitk::LabelSetImageVtkMapper2D::m_LSH

The LocalStorageHandler holds all (three) LocalStorages for the three 2D render windows.

Definition at line 170 of file mitkLabelSetImageVtkMapper2D.h.

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

mitkLabelSetImageVtkMapper2D.h

Classes

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ LabelSetImageVtkMapper2D()

◆ ~LabelSetImageVtkMapper2D()

Member Function Documentation

◆ ApplyRenderingMode()

◆ CalculateLayerDepth()

◆ CreateOutlinePolyData()

◆ GenerateActiveLabelOutline()

◆ GenerateDataForRenderer()

◆ GenerateImageSlice()

◆ GenerateLookupTable()

◆ GeneratePlane()

◆ GetInput()

◆ GetLocalStorage()

◆ GetVtkProp()

◆ mitkClassMacro()

◆ New()

◆ RenderingGeometryIntersectsImage()

◆ SetDefaultProperties()

◆ TransformActor()

◆ Update()

Member Data Documentation

◆ m_LSH