Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitkImageVtkMapper2D.h
Go to the documentation of this file.
1 /*============================================================================
2 
3 The Medical Imaging Interaction Toolkit (MITK)
4 
5 Copyright (c) German Cancer Research Center (DKFZ)
6 All rights reserved.
7 
8 Use of this source code is governed by a 3-clause BSD license that can be
9 found in the LICENSE file.
10 
11 ============================================================================*/
12 
13 #ifndef mitkImageVtkMapper2D_h
14 #define mitkImageVtkMapper2D_h
15 
16 // MITK
17 #include <mitkCommon.h>
18 
19 // MITK Rendering
20 #include <mitkBaseRenderer.h>
21 #include <mitkExtractSliceFilter.h>
22 #include <mitkVtkMapper.h>
23 
24 // VTK
25 #include <vtkPropAssembly.h>
26 #include <vtkSmartPointer.h>
27 
28 class vtkActor;
29 class vtkPolyDataMapper;
30 class vtkPlaneSource;
31 class vtkImageData;
32 class vtkLookupTable;
33 class vtkImageExtractComponents;
34 class vtkImageReslice;
35 class vtkImageChangeInformation;
36 class vtkPoints;
38 class vtkPolyData;
39 class vtkMitkApplyLevelWindowToRGBFilter;
41 
42 namespace mitk
43 {
117  {
118  public:
121 
123  itkFactorylessNewMacro(Self);
124  itkCloneMacro(Self);
125 
130  const mitk::Image *GetInput(void);
131 
140  void Update(mitk::BaseRenderer *renderer) override;
141 
151  vtkProp *GetVtkProp(mitk::BaseRenderer *renderer) override;
152 
161  {
162  public:
167 
175  vtkProp* m_PublicActors = nullptr;
176 
199  mitk::ExtractSliceFilter::Pointer m_Reslicer;
206 
208  itk::TimeStamp m_LastUpdateTime;
209 
212 
215 
219  ~LocalStorage() override;
220  };
221 
228 
239  static void SetDefaultProperties(mitk::DataNode *node, mitk::BaseRenderer *renderer = nullptr, bool overwrite = false);
240 
251 
252  protected:
255 
258 
263 
277  void GeneratePlane(mitk::BaseRenderer *renderer, double planeBounds[6]);
278 
283  template <typename TPixel>
285 
289  ~ImageVtkMapper2D() override;
290 
303  void GenerateDataForRenderer(mitk::BaseRenderer *renderer) override;
304 
309 
315 
323 
331 
334 
337 
348  bool RenderingGeometryIntersectsImage(const PlaneGeometry *renderingGeometry, SlicedGeometry3D *imageGeometry);
349 
352  };
353 
354 } // namespace mitk
355 
356 #endif
#define MITKCORE_EXPORT
Organizes the rendering process.
Central node class of the MITK data tree, associating a data object with properties and mappers.
Definition: mitkDataNode.h:72
Internal class holding the mapper, actor, etc. for each of the 3 2D render windows.
vtkSmartPointer< vtkPlaneSource > m_Plane
Plane on which the slice is rendered as texture.
vtkSmartPointer< vtkPolyData > m_OutlinePolyData
PolyData object containing all lines/points needed for outlining the contour. This container is used ...
vtkSmartPointer< vtkPolyData > m_EmptyPolyData
Empty vtkPolyData that is set when rendering geometry does not intersect the image geometry.
mitk::ExtractSliceFilter::Pointer m_Reslicer
The actual reslicer (one per renderer)
vtkSmartPointer< vtkLookupTable > m_BinaryLookupTable
vtkSmartPointer< vtkPolyDataMapper > m_Mapper
Mapper of a 2D render window.
vtkSmartPointer< vtkActor > m_ImageActor
Actor of the image in a 2D render window.
~LocalStorage() override
Default deconstructor of the local storage.
vtkSmartPointer< vtkTexture > m_Texture
The texture which is used to render the current slice.
vtkSmartPointer< vtkActor > m_ShadowOutlineActor
Actor of the shadowimage in a 2D render window.
vtkSmartPointer< vtkImageExtractComponents > m_VectorComponentExtractor
itk::TimeStamp m_LastUpdateTime
Timestamp of last update of stored data.
vtkSmartPointer< vtkPropAssembly > m_Actors
vtkSmartPointer< vtkImageData > m_ReslicedImage
Current slice of a 2D render window.
LocalStorage()
Default constructor of the local storage.
vtkSmartPointer< vtkLookupTable > m_DefaultLookupTable
The lookuptables for colors and level window.
vtkSmartPointer< vtkPropAssembly > m_EmptyActors
vtkSmartPointer< vtkLookupTable > m_ColorLookupTable
vtkSmartPointer< vtkMitkLevelWindowFilter > m_LevelWindowFilter
This filter is used to apply the level window to Grayvalue and RBG(A) images.
mitk::ScalarType * m_mmPerPixel
mmPerPixel relation between pixel and mm. (World spacing).
vtkSmartPointer< vtkMitkThickSlicesFilter > m_TSFilter
Filter for thick slices.
Mapper to resample and display 2D slices of a 3D image.
void ApplyLevelWindow(mitk::BaseRenderer *renderer)
ApplyLevelWindow Apply the level window for the given renderer.
vtkProp * GetVtkProp(mitk::BaseRenderer *renderer) override
Get the VTK prop assembly for the given renderer.
void ApplyOpacity(mitk::BaseRenderer *renderer)
Set the opacity of the actor.
~ImageVtkMapper2D() override
vtkSmartPointer< vtkPolyData > CreateOutlinePolyData(mitk::BaseRenderer *renderer)
Generates a vtkPolyData object containing the outline of a given binary slice.
void ApplyLookuptable(mitk::BaseRenderer *renderer)
This method applies (or modifies) the lookuptable for all types of images.
mitkClassMacro(ImageVtkMapper2D, VtkMapper)
bool RenderingGeometryIntersectsImage(const PlaneGeometry *renderingGeometry, SlicedGeometry3D *imageGeometry)
Calculates whether the given rendering geometry intersects the given SlicedGeometry3D.
void Update(mitk::BaseRenderer *renderer) override
Check whether the mapper needs to update and regenerate data for the given renderer.
const mitk::Image * GetInput(void)
Get the Image to map.
void GeneratePlane(mitk::BaseRenderer *renderer, double planeBounds[6])
Generates a plane according to the size of the resliced image in millimeters.
const LocalStorage * GetConstLocalStorage(mitk::BaseRenderer *renderer)
Get a const pointer to the LocalStorage for the given renderer.
mitk::LocalStorageHandler< LocalStorage > m_LSH
The LocalStorageHandler holds all (three) LocalStorages for the three 2D render windows.
void GenerateDataForRenderer(mitk::BaseRenderer *renderer) override
Does the actual resampling, without rendering the image yet. All the data is generated inside this me...
void ApplyRenderingMode(mitk::BaseRenderer *renderer)
Apply the rendering mode for the given renderer.
LocalStorage * GetLocalStorage(mitk::BaseRenderer *renderer)
Get the LocalStorage corresponding to the current renderer.
void ApplyColorTransferFunction(mitk::BaseRenderer *renderer)
This method applies a color transfer function. Internally, a vtkColorTransferFunction is used....
static void SetDefaultProperties(mitk::DataNode *node, mitk::BaseRenderer *renderer=nullptr, bool overwrite=false)
Set default properties for general image rendering on the given DataNode.
void ApplyColor(mitk::BaseRenderer *renderer)
Set the color of the image/polydata.
float CalculateLayerDepth(mitk::BaseRenderer *renderer)
This method uses the vtkCamera clipping range and the layer property to calculate the depth of the ob...
void TransformActor(mitk::BaseRenderer *renderer)
Transforms the actor to the actual position in 3D.
void SetToInvalidState(mitk::ImageVtkMapper2D::LocalStorage *localStorage)
Image class for storing multi-dimensional medical image data.
Definition: mitkImage.h:76
Base class for mapper-specific rendering resources.
Definition: mitkMapper.h:181
Describes the geometry of a plane object.
Describes the geometry of a data object consisting of slices.
Base class of all VTK-based Mappers for displaying primitives using VTK functionality.
Definition: mitkVtkMapper.h:53
Applies the gray-value or color/opacity level window to scalar or RGB(A) images.
Computes a thick slice projection from a 3D image stack.
Find image slices visible on a given plane.
double ScalarType
Scalar type used throughout MITK for geometric computations.