Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitk::ImageToContourFilter Class Reference

A filter that can extract contours out of a 2D binary image. More...

#include <mitkImageToContourFilter.h>

Inheritance diagram for mitk::ImageToContourFilter:
Collaboration diagram for mitk::ImageToContourFilter:

Public Types

typedef itk::PolyLineParametricPath< 2 > PolyLineParametricPath2D
 
typedef PolyLineParametricPath2D::VertexListType ContourPath
 
- Public Types inherited from mitk::ImageToSurfaceFilter
enum  DecimationType { NoDecimation , DecimatePro , QuadricDecimation }
 Enumeration of available polygon decimation strategies. More...
 
- Public Types inherited from mitk::SurfaceSource
typedef Surface OutputType
 
- Public Types inherited from mitk::BaseDataSource
typedef BaseData OutputType
 Output data type. More...
 
typedef itk::DataObject::DataObjectIdentifierType DataObjectIdentifierType
 Identifier type for named data objects. More...
 

Public Member Functions

 mitkClassMacro (ImageToContourFilter, ImageToSurfaceFilter)
 
Pointer Clone () const
 
virtual void SetSliceGeometry (BaseGeometry *_arg)
 Set macro for the geometry of the slice. If it is not set explicitly the geometry will be taken from the slice. More...
 
void SetUseProgressBar (bool)
 Set whether the mitkProgressBar should be used. More...
 
void SetProgressStepSize (unsigned int stepSize)
 Set the stepsize which the progress bar should proceed. More...
 
virtual void SetContourValue (ScalarType _arg)
 Sets the contour value to be extracted if there are multiple contours. More...
 
- Public Member Functions inherited from mitk::ImageToSurfaceFilter
 mitkClassMacro (ImageToSurfaceFilter, SurfaceSource)
 
Pointer Clone () const
 
void GenerateData () override
 
void GenerateOutputInformation () override
 
const mitk::Image * GetInput (void)
 
virtual void SetInput (const mitk::Image *image)
 
void SetSmoothIteration (int smoothIteration)
 Set the number of iterations used to smooth the surface. More...
 
void SetSmoothRelaxation (float smoothRelaxation)
 Set the relaxation factor for Laplacian smoothing. More...
 
virtual void SetThreshold (ScalarType _arg)
 Set the threshold used for surface extraction via vtkMarchingCubes. More...
 
virtual ScalarType GetThreshold () const
 Get the threshold used for vtkMarchingCubes surface extraction. More...
 
virtual void SetSmooth (bool _arg)
 Enable vtkSmoothPolyDataFilter for Laplacian smoothing. More...
 
virtual void SmoothOn ()
 Toggle surface smoothing on/off. More...
 
virtual void SmoothOff ()
 
virtual bool GetSmooth () const
 Get whether surface smoothing is enabled. More...
 
virtual DecimationType GetDecimate () const
 Get the current decimation mode. More...
 
virtual void SetDecimate (DecimationType _arg)
 Set the decimation mode to reduce the number of triangles in the mesh. More...
 
virtual void SetTargetReduction (float _arg)
 Set the desired target reduction of triangles in the range [0.0, 1.0]. More...
 
virtual float GetTargetReduction () const
 Get the target reduction factor for the decimation filter. More...
 
template<class T1 , class T2 , class T3 >
void mitkVtkLinearTransformPoint (T1 matrix[4][4], T2 in[3], T3 out[3])
 Transform a 3D point by a 4x4 matrix (affine transformation). More...
 
- Public Member Functions inherited from mitk::SurfaceSource
 mitkClassMacro (SurfaceSource, BaseDataSource)
 
Pointer Clone () const
 
mitkBaseDataSourceGetOutputDeclarations itk::DataObject::Pointer MakeOutput (DataObjectPointerArraySizeType idx) override
 Allocate a new output object and return it. More...
 
itk::DataObject::Pointer MakeOutput (const DataObjectIdentifierType &name) override
 Allocate a new output object by name. More...
 
- Public Member Functions inherited from mitk::BaseDataSource
 mitkClassMacroItkParent (BaseDataSource, itk::ProcessObject)
 
OutputType * GetOutput ()
 
const OutputType * GetOutput () const
 
OutputType * GetOutput (DataObjectPointerArraySizeType idx)
 
const OutputType * GetOutput (DataObjectPointerArraySizeType idx) const
 
virtual void GraftOutput (OutputType *output)
 Graft the specified BaseData onto this BaseDataSource's output. More...
 
virtual void GraftOutput (const DataObjectIdentifierType &key, OutputType *output)
 Graft the specified base data object onto a named output. More...
 
virtual void GraftNthOutput (unsigned int idx, OutputType *output)
 Graft the specified base data object onto this BaseDataSource's idx'th output. More...
 
bool Updating () const
 Check whether the pipeline is currently executing. More...
 

Static Public Member Functions

static Pointer New ()
 
- Static Public Member Functions inherited from mitk::ImageToSurfaceFilter
static Pointer New ()
 
- Static Public Member Functions inherited from mitk::SurfaceSource
static Pointer New ()
 

Protected Member Functions

 ImageToContourFilter ()
 
 ~ImageToContourFilter () override
 
void GenerateData () override
 
void GenerateOutputInformation () override
 
- Protected Member Functions inherited from mitk::ImageToSurfaceFilter
 ImageToSurfaceFilter ()
 
 ~ImageToSurfaceFilter () override
 Destructor. More...
 
void CreateSurface (int time, vtkImageData *vtkimage, mitk::Surface *surface, const ScalarType threshold)
 Create the surface for a single time step using vtkMarchingCubes. More...
 
- Protected Member Functions inherited from mitk::SurfaceSource
 SurfaceSource ()
 
 ~SurfaceSource () override
 
- Protected Member Functions inherited from mitk::BaseDataSource
 BaseDataSource ()
 Constructor. More...
 
 ~BaseDataSource () override
 Destructor. More...
 

Additional Inherited Members

- Static Protected Member Functions inherited from mitk::BaseDataSource
static Pointer New ()
 
- Protected Attributes inherited from mitk::ImageToSurfaceFilter
bool m_Smooth
 Flag whether the created surface shall be smoothed (default is false). More...
 
DecimationType m_Decimate
 Decimation mode. Default is NoDecimation. More...
 
ScalarType m_Threshold
 Threshold for surface extraction. Default value is 1. More...
 
float m_TargetReduction
 The reduction factor for the decimation filter. Range [0.0, 1.0]. More...
 
int m_SmoothIteration
 The number of iterations for the smoothing filter. Default is 50. More...
 
float m_SmoothRelaxation
 The relaxation factor for the smoothing filter. Default is 0.1. More...
 

Detailed Description

A filter that can extract contours out of a 2D binary image.

This class takes an 2D mitk::Image as input and extracts all contours which are drawn it. The contour extraction is done by using the itk::ContourExtractor2DImageFilter.

The output is a mitk::Surface.

Author
fetzer

Definition at line 41 of file mitkImageToContourFilter.h.

Member Typedef Documentation

◆ ContourPath

typedef PolyLineParametricPath2D::VertexListType mitk::ImageToContourFilter::ContourPath

Definition at line 58 of file mitkImageToContourFilter.h.

◆ PolyLineParametricPath2D

typedef itk::PolyLineParametricPath<2> mitk::ImageToContourFilter::PolyLineParametricPath2D

Definition at line 57 of file mitkImageToContourFilter.h.

Constructor & Destructor Documentation

◆ ImageToContourFilter()

mitk::ImageToContourFilter::ImageToContourFilter ( )
protected

◆ ~ImageToContourFilter()

mitk::ImageToContourFilter::~ImageToContourFilter ( )
overrideprotected

Member Function Documentation

◆ Clone()

Pointer mitk::ImageToContourFilter::Clone ( ) const

◆ GenerateData()

void mitk::ImageToContourFilter::GenerateData ( )
overrideprotected

◆ GenerateOutputInformation()

void mitk::ImageToContourFilter::GenerateOutputInformation ( )
overrideprotected

◆ mitkClassMacro()

mitk::ImageToContourFilter::mitkClassMacro ( ImageToContourFilter  ,
ImageToSurfaceFilter   
)

◆ New()

static Pointer mitk::ImageToContourFilter::New ( )
static

◆ SetContourValue()

virtual void mitk::ImageToContourFilter::SetContourValue ( ScalarType  _arg)
virtual

Sets the contour value to be extracted if there are multiple contours.

◆ SetProgressStepSize()

void mitk::ImageToContourFilter::SetProgressStepSize ( unsigned int  stepSize)

Set the stepsize which the progress bar should proceed.

Parameter The stepsize for progressing

◆ SetSliceGeometry()

virtual void mitk::ImageToContourFilter::SetSliceGeometry ( BaseGeometry *  _arg)
virtual

Set macro for the geometry of the slice. If it is not set explicitly the geometry will be taken from the slice.

Parameter The slice's geometry

◆ SetUseProgressBar()

void mitk::ImageToContourFilter::SetUseProgressBar ( bool  )

Set whether the mitkProgressBar should be used.

Parameter true for using the progress bar, false otherwise


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