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

#include <mitkImageVtkMapper2D.h>

Inheritance diagram for mitk::ImageVtkMapper2D:

[legend]

Collaboration diagram for mitk::ImageVtkMapper2D:

[legend]

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

Public Member Functions
	mitkClassMacro (ImageVtkMapper2D, VtkMapper)

Pointer	Clone () const

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

void	Update (mitk::BaseRenderer *renderer) override
	Check whether the mapper needs to update and regenerate data for the given renderer. More...

vtkProp *	GetVtkProp (mitk::BaseRenderer *renderer) override
	Get the VTK prop assembly for the given renderer. More...

const LocalStorage *	GetConstLocalStorage (mitk::BaseRenderer *renderer)
	Get a const pointer to the LocalStorage for the given renderer. More...

void	ApplyRenderingMode (mitk::BaseRenderer *renderer)
	Apply the rendering mode for the given renderer. 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 default properties for general image rendering on the given DataNode. 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...

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

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

template<typename TPixel >
vtkSmartPointer< vtkPolyData >	CreateOutlinePolyData (mitk::BaseRenderer *renderer)
	Generates a vtkPolyData object containing the outline of a given binary slice. More...

	ImageVtkMapper2D ()

	~ImageVtkMapper2D () override

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

void	ApplyLookuptable (mitk::BaseRenderer *renderer)
	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 useful for coloring continuous 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)
	Set the color of the image/polydata. More...

void	ApplyOpacity (mitk::BaseRenderer *renderer)
	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...

void	SetToInvalidState (mitk::ImageVtkMapper2D::LocalStorage *localStorage)

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

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

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

Detailed Description

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

The following image gives a brief overview of the mapping and the involved parts.

First, the image is resliced by means of vtkImageReslice. The volume image serves as input to the mapper in addition to spatial placement of the slice and a few other properties such as thick slices. This code was already present in the old version (mitkImageMapperGL2D).

Next, the obtained slice (m_ReslicedImage) is put into a vtkMitkLevelWindowFilter and the scalar levelwindow, opacity levelwindow and optional clipping to local image bounds are applied

Next, the output of the vtkMitkLevelWindowFilter is used to create a texture (m_Texture) and a plane onto which the texture is rendered (m_Plane). For mapping purposes, a vtkPolyDataMapper (m_Mapper) is utilized. Orthographic projection is applied to create the effect of a 2D image. The mapper and the texture are assigned to the actor (m_Actor) which is passed to the VTK rendering pipeline via the method GetVtkProp().

In order to transform the textured plane to the correct position in space, the same transformation as used for reslicing is applied to both the camera and the vtkActor. All important steps are explained in more detail below. The resulting 2D image (by reslicing the underlying 3D input image appropriately) can either be directly rendered in a 2D view or just be calculated to be used later by another rendering entity, e.g. in texture mapping in a 3D view.

Properties that can be set for images and influence the imageMapper2D are:

"opacity": (FloatProperty) Opacity of the image
"color": (ColorProperty) Color of the image
"LookupTable": (mitkLookupTableProperty) If this property is set, the default lookuptable will be ignored and the "LookupTable" value will be used instead.
"Image Rendering.Mode": This property decides which mode is used to render images. (E.g. if a lookup table or a transferfunction is applied). Detailed documentation about the modes can be found here: mitk::RenderingModeProperty
"Image Rendering.Transfer Function": (mitkTransferFunctionProperty) If this property is set, a color transferfunction will be used to color the image.
"binary": (BoolProperty) is the image a binary image or not
"outline binary": (BoolProperty) show outline of the image or not
"texture interpolation": (BoolProperty) texture interpolation of the image
"reslice interpolation": (VtkResliceInterpolationProperty) reslice interpolation of the image
"in plane resample extent by geometry": (BoolProperty) Do it or not
"bounding box": (BoolProperty) Is the Bounding Box of the image shown or not
"layer": (IntProperty) Layer of the image
"volume annotation color": (ColorProperty) color of the volume annotation, TODO has to be reimplemented
"volume annotation unit": (StringProperty) annotation unit as string (does not implicit convert the unit!) unit is ml or cm3, TODO has to be reimplemented

The default properties are:

"opacity", mitk::FloatProperty::New(0.3f), renderer, overwrite )
"color", ColorProperty::New(1.0,0.0,0.0), renderer, overwrite )
"binary", mitk::BoolProperty::New( true ), renderer, overwrite )
"outline binary", mitk::BoolProperty::New( false ), renderer, overwrite )
"texture interpolation", mitk::BoolProperty::New( false ) )
"reslice interpolation", mitk::VtkResliceInterpolationProperty::New() )
"in plane resample extent by geometry", mitk::BoolProperty::New( false ) )
"bounding box", mitk::BoolProperty::New( false ) )
"layer", mitk::IntProperty::New(10), renderer, overwrite)
"Image Rendering.Transfer Function": Default color transfer function for CTs
"LookupTable": Rainbow color.

If the modality-property is set for an image, the mapper uses modality-specific default properties, e.g. color maps, if they are defined.

Definition at line 116 of file mitkImageVtkMapper2D.h.

Constructor & Destructor Documentation

◆ ImageVtkMapper2D()

mitk::ImageVtkMapper2D::ImageVtkMapper2D ( )

protected

Default constructor

◆ ~ImageVtkMapper2D()

mitk::ImageVtkMapper2D::~ImageVtkMapper2D ( )

overrideprotected

Default deconstructor

Member Function Documentation

◆ ApplyColor()

void mitk::ImageVtkMapper2D::ApplyColor ( mitk::BaseRenderer * renderer )

protected

Set the color of the image/polydata.

◆ ApplyColorTransferFunction()

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

protected

This method applies a color transfer function. Internally, a vtkColorTransferFunction is used. This is useful for coloring continuous 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.

◆ ApplyLevelWindow()

void mitk::ImageVtkMapper2D::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?

◆ ApplyLookuptable()

void mitk::ImageVtkMapper2D::ApplyLookuptable ( mitk::BaseRenderer * renderer )

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.

◆ ApplyOpacity()

void mitk::ImageVtkMapper2D::ApplyOpacity ( mitk::BaseRenderer * renderer )

protected

Set the opacity of the actor.

◆ ApplyRenderingMode()

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

Apply the rendering mode for the given renderer.

Switches between different rendering modes (lookup table, color transfer function, etc.) based on the "Image Rendering.Mode" property.

Parameters

[in] renderer The renderer to apply the rendering mode for.

See also: mitk::RenderingModeProperty

◆ CalculateLayerDepth()

float mitk::ImageVtkMapper2D::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.

◆ Clone()

Pointer mitk::ImageVtkMapper2D::Clone ( ) const

◆ CreateOutlinePolyData()

template<typename TPixel >

vtkSmartPointer<vtkPolyData> mitk::ImageVtkMapper2D::CreateOutlinePolyData ( mitk::BaseRenderer * renderer )

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.

◆ GenerateDataForRenderer()

void mitk::ImageVtkMapper2D::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.

◆ GeneratePlane()

void mitk::ImageVtkMapper2D::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).

◆ GetConstLocalStorage()

const LocalStorage* mitk::ImageVtkMapper2D::GetConstLocalStorage ( mitk::BaseRenderer * renderer )

Get a const pointer to the LocalStorage for the given renderer.

Parameters

[in] renderer The renderer whose LocalStorage is requested.

Returns: Const pointer to the LocalStorage.

◆ GetInput()

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

Get the Image to map.

Returns: Pointer to the input mitk::Image from the associated DataNode.

◆ GetLocalStorage()

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

protected

Get the LocalStorage corresponding to the current renderer.

◆ GetVtkProp()

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

overridevirtual

Get the VTK prop assembly for the given renderer.

Returns the public prop assembly (either the regular actors or the empty actors if the mapper is in an invalid state).

Parameters

[in] renderer The renderer for which the prop is requested.

Returns: Pointer to the vtkProp used for rendering.

Implements mitk::VtkMapper.

◆ mitkClassMacro()

mitk::ImageVtkMapper2D::mitkClassMacro	(	ImageVtkMapper2D	,
		VtkMapper
	)

Standard class typedefs.

◆ New()

static Pointer mitk::ImageVtkMapper2D::New ( )

static

Method for creation through the object factory.

◆ RenderingGeometryIntersectsImage()

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

protected

Calculates whether the given rendering geometry intersects the given SlicedGeometry3D.

This method checks if the given PlaneGeometry intersects the given SlicedGeometry3D. It calculates the distance of the PlaneGeometry 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::ImageVtkMapper2D::SetDefaultProperties	(	mitk::DataNode *	node,
		mitk::BaseRenderer *	renderer = `nullptr`,
		bool	overwrite = `false`
	)

static

Set default properties for general image rendering on the given DataNode.

Initializes properties such as opacity, color, binary rendering mode, texture interpolation, lookup table, and transfer function.

Parameters

[in]	node	The DataNode on which to set the properties.
[in]	renderer	The renderer context (nullptr for default property list).
[in]	overwrite	If true, overwrite existing properties.

◆ SetToInvalidState()

void mitk::ImageVtkMapper2D::SetToInvalidState ( mitk::ImageVtkMapper2D::LocalStorage * localStorage )

protected

Helper function to reset the local storage in order to indicate an invalid state.

◆ TransformActor()

void mitk::ImageVtkMapper2D::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::ImageVtkMapper2D::Update ( mitk::BaseRenderer * renderer )

overridevirtual

Check whether the mapper needs to update and regenerate data for the given renderer.

Validates the time step and world plane geometry before calling GenerateDataForRenderer().

Parameters

[in] renderer The renderer to update for.

Reimplemented from mitk::Mapper.

Member Data Documentation

◆ m_LSH

mitk::LocalStorageHandler<LocalStorage> mitk::ImageVtkMapper2D::m_LSH

protected

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

Definition at line 254 of file mitkImageVtkMapper2D.h.

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

mitkImageVtkMapper2D.h

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ImageVtkMapper2D()

◆ ~ImageVtkMapper2D()

Member Function Documentation

◆ ApplyColor()

◆ ApplyColorTransferFunction()

◆ ApplyLevelWindow()

◆ ApplyLookuptable()

◆ ApplyOpacity()

◆ ApplyRenderingMode()

◆ CalculateLayerDepth()

◆ Clone()

◆ CreateOutlinePolyData()

◆ GenerateDataForRenderer()

◆ GeneratePlane()

◆ GetConstLocalStorage()

◆ GetInput()

◆ GetLocalStorage()

◆ GetVtkProp()

◆ mitkClassMacro()

◆ New()

◆ RenderingGeometryIntersectsImage()

◆ SetDefaultProperties()

◆ SetToInvalidState()

◆ TransformActor()

◆ Update()

Member Data Documentation

◆ m_LSH