Medical Imaging Interaction Toolkit
2016.11.0
Medical Imaging Interaction Toolkit
|
Mapper to resample and display 2D slices of a 3D image. More...
#include <mitkDoseImageVtkMapper2D.h>
Classes | |
class | LocalStorage |
Internal class holding the mapper, actor, etc. for each of the 3 2D render windows. More... | |
Public Member Functions | |
mitkClassMacro (DoseImageVtkMapper2D, VtkMapper) | |
Pointer | Clone () const |
const mitk::Image * | GetInput (void) |
Get the Image to map. More... | |
virtual void | Update (mitk::BaseRenderer *renderer) |
Checks whether this mapper needs to update itself and generate data. More... | |
virtual vtkProp * | GetVtkProp (mitk::BaseRenderer *renderer) |
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) |
Generates a vtkPolyData object containing the outline of a given binary slice. More... | |
DoseImageVtkMapper2D () | |
virtual | ~DoseImageVtkMapper2D () |
virtual void | GenerateDataForRenderer (mitk::BaseRenderer *renderer) |
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) |
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) |
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... | |
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 |
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:
The default properties are:
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 119 of file mitkDoseImageVtkMapper2D.h.
|
protected |
Default constructor
Definition at line 66 of file mitkDoseImageVtkMapper2D.cpp.
|
protectedvirtual |
Default deconstructor
Definition at line 70 of file mitkDoseImageVtkMapper2D.cpp.
|
protected |
Set the color of the image/polydata.
Definition at line 443 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::DoseImageVtkMapper2D::LocalStorage::m_Actor, and mitk::DoseImageVtkMapper2D::LocalStorage::m_Actors.
|
protected |
This method applies a color transfer function. Internally, a vtkColorTransferFunction is used. This is usefull for coloring continous images (e.g. float)
Definition at line 591 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::DoseImageVtkMapper2D::LocalStorage::m_LevelWindowFilter, and MITK_ERROR.
|
protected |
ApplyLevelWindow Apply the level window for the given renderer.
renderer | Level window for which renderer? |
Definition at line 420 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::LevelWindow::GetLowerWindowBound(), mitk::LevelWindow::GetUpperWindowBound(), and mitk::DoseImageVtkMapper2D::LocalStorage::m_LevelWindowFilter.
|
protected |
This method applies (or modifies) the lookuptable for all types of images.
Definition at line 569 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::DoseImageVtkMapper2D::LocalStorage::m_ColorLookupTable, and mitk::DoseImageVtkMapper2D::LocalStorage::m_LevelWindowFilter.
|
protected |
Set the opacity of the actor.
Definition at line 503 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::DoseImageVtkMapper2D::LocalStorage::m_Actor, and mitk::DoseImageVtkMapper2D::LocalStorage::m_Actors.
void mitk::DoseImageVtkMapper2D::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.
Definition at line 517 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::RenderingModeProperty::COLORTRANSFERFUNCTION_COLOR, mitk::RenderingModeProperty::COLORTRANSFERFUNCTION_LEVELWINDOW_COLOR, mitk::RenderingModeProperty::LOOKUPTABLE_COLOR, mitk::RenderingModeProperty::LOOKUPTABLE_LEVELWINDOW_COLOR, mitk::DoseImageVtkMapper2D::LocalStorage::m_BinaryLookupTable, mitk::DoseImageVtkMapper2D::LocalStorage::m_LevelWindowFilter, MITK_DEBUG, and MITK_ERROR.
|
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 93 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::BaseRenderer::GetVtkRenderer(), and MITK_WARN.
Pointer mitk::DoseImageVtkMapper2D::Clone | ( | ) | const |
|
protected |
Generates a vtkPolyData object containing the outline of a given binary slice.
renderer | Pointer to the renderer containing the needed information |
Definition at line 818 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::RTConstants::DOSE_FREE_ISO_VALUES_PROPERTY_NAME, mitk::RTConstants::DOSE_ISO_LEVELS_PROPERTY_NAME, mitk::New(), and mitk::RTConstants::REFERENCE_DOSE_PROPERTY_NAME.
|
protectedvirtual |
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 122 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::PlaneClipping::CalculateClippedPlaneBounds(), mitk::DataNode::GetBoolProperty(), mitk::BaseRenderer::GetCurrentWorldPlaneGeometry(), mitk::BaseRenderer::GetCurrentWorldPlaneGeometryNode(), mitk::Image::GetDimension(), mitk::DataNode::GetFloatProperty(), mitk::BaseData::GetGeometry(), mitk::TimeGeometry::GetGeometryForTimeStep(), mitk::VtkResliceInterpolationProperty::GetInterpolation(), mitk::DataNode::GetIntProperty(), mitk::PlaneGeometry::GetNormal(), mitk::PixelType::GetNumberOfComponents(), mitk::Image::GetPixelType(), mitk::AbstractTransformGeometry::GetPlane(), mitk::DataNode::GetProperty(), mitk::SlicedData::GetSlicedGeometry(), mitk::BaseData::GetTimeGeometry(), mitk::GenericProperty< T >::GetValue(), mitk::EnumerationProperty::GetValueAsId(), mitk::PlaneGeometry::HasReferenceGeometry(), mitk::BaseData::IsInitialized(), mitk::BaseGeometry::IsValid(), mitk::DoseImageVtkMapper2D::LocalStorage::m_Actor, mitk::DoseImageVtkMapper2D::LocalStorage::m_Actors, mitk::DoseImageVtkMapper2D::LocalStorage::m_EmptyPolyData, mitk::DoseImageVtkMapper2D::LocalStorage::m_LastUpdateTime, mitk::DoseImageVtkMapper2D::LocalStorage::m_LevelWindowFilter, mitk::DoseImageVtkMapper2D::LocalStorage::m_Mapper, mitk::DoseImageVtkMapper2D::LocalStorage::m_mmPerPixel, mitk::DoseImageVtkMapper2D::LocalStorage::m_OutlinePolyData, mitk::DoseImageVtkMapper2D::LocalStorage::m_Plane, mitk::DoseImageVtkMapper2D::LocalStorage::m_ReslicedImage, mitk::DoseImageVtkMapper2D::LocalStorage::m_Reslicer, mitk::DoseImageVtkMapper2D::LocalStorage::m_Texture, mitk::DoseImageVtkMapper2D::LocalStorage::m_TSFilter, mitk::DoseImageVtkMapper2D::LocalStorage::m_VectorComponentExtractor, MITK_WARN, mitk::ExtractSliceFilter::RESLICE_CUBIC, mitk::ExtractSliceFilter::RESLICE_LINEAR, and mitk::ExtractSliceFilter::RESLICE_NEAREST.
|
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).
Definition at line 78 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::DoseImageVtkMapper2D::LocalStorage::m_Plane.
const mitk::Image * mitk::DoseImageVtkMapper2D::GetInput | ( | void | ) |
Get the Image to map.
Definition at line 111 of file mitkDoseImageVtkMapper2D.cpp.
mitk::DoseImageVtkMapper2D::LocalStorage * mitk::DoseImageVtkMapper2D::GetLocalStorage | ( | mitk::BaseRenderer * | renderer | ) |
Get the LocalStorage corresponding to the current renderer.
Definition at line 812 of file mitkDoseImageVtkMapper2D.cpp.
|
virtual |
Implements mitk::VtkMapper.
Definition at line 116 of file mitkDoseImageVtkMapper2D.cpp.
mitk::DoseImageVtkMapper2D::mitkClassMacro | ( | DoseImageVtkMapper2D | , |
VtkMapper | |||
) |
Standard class typedefs.
|
static |
Method for creation through the object factory.
|
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.
Definition at line 1027 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::BaseGeometry::GetCornerPoint(), and mitk::PlaneGeometry::SignedDistance().
|
static |
Set the default properties for general image rendering.
Definition at line 654 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::DataNode::AddProperty(), mitk::GetBackwardsCompatibleDICOMProperty(), mitk::DataNode::GetBoolProperty(), mitk::DataNode::GetData(), mitk::PixelType::GetNumberOfComponents(), mitk::PixelType::GetPixelTypeAsString(), mitk::DataNode::GetProperty(), mitk::DataNode::GetStringProperty(), mitk::LookupTable::GRAYSCALE, mitk::LookupTable::INVERSE_GRAYSCALE, mitk::DataNodeFactory::m_TextureInterpolationActive, mitk::BoolProperty::New(), mitk::IntProperty::New(), mitk::FloatProperty::New(), mitk::ImageSliceSelector::New(), mitk::VtkResliceInterpolationProperty::New(), mitk::LevelWindowProperty::New(), mitk::LookupTable::New(), mitk::LookupTableProperty::New(), mitk::ColorProperty::New(), mitk::RenderingModeProperty::New(), mitk::DataNode::SetProperty(), mitk::LevelWindow::SetRangeMinMax(), and mitk::LevelWindow::SetWindowBounds().
|
protected |
Transforms the actor to the actual position in 3D.
renderer | The current renderer corresponding to the render window. |
Definition at line 1007 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::DoseImageVtkMapper2D::LocalStorage::m_Actor, mitk::DoseImageVtkMapper2D::LocalStorage::m_Actors, mitk::DoseImageVtkMapper2D::LocalStorage::m_mmPerPixel, mitk::DoseImageVtkMapper2D::LocalStorage::m_Reslicer, and mitk::New().
|
virtual |
Checks whether this mapper needs to update itself and generate data.
Reimplemented from mitk::Mapper.
Definition at line 605 of file mitkDoseImageVtkMapper2D.cpp.
References mitk::BaseRenderer::GetCurrentWorldPlaneGeometry(), mitk::BaseRenderer::GetCurrentWorldPlaneGeometryUpdateTime(), mitk::PropertyList::GetMTime(), mitk::DataNode::GetMTime(), mitk::DataNode::GetPropertyList(), mitk::BaseData::GetTimeGeometry(), mitk::TimeGeometry::IsValidTimeStep(), mitk::DoseImageVtkMapper2D::LocalStorage::m_LastUpdateTime, and mitk::SlicedData::UpdateOutputInformation().
mitk::LocalStorageHandler<LocalStorage> mitk::DoseImageVtkMapper2D::m_LSH |
The LocalStorageHandler holds all (three) LocalStorages for the three 2D render windows.
Definition at line 202 of file mitkDoseImageVtkMapper2D.h.