#include <itkImageToImageFilter.h>

Inherits itk::ImageSource< TOutputImage >.

Collaboration diagram for itk::ImageToImageFilter< TInputImage, TOutputImage >:

List of all members.

Public Types
typedef SmartPointer< const Self >	ConstPointer
typedef InputImageType::ConstPointer	InputImageConstPointer
typedef InputImageType::PixelType	InputImagePixelType
typedef InputImageType::Pointer	InputImagePointer
typedef InputImageType::RegionType	InputImageRegionType
typedef TInputImage	InputImageType
typedef Superclass::OutputImagePixelType	OutputImagePixelType
typedef Superclass::OutputImageRegionType	OutputImageRegionType
typedef SmartPointer< Self >	Pointer
typedef ImageToImageFilter	Self
typedef ImageSource< TOutputImage >	Superclass
Public Member Functions
const InputImageType *	GetInput (void) const
const InputImageType *	GetInput (unsigned int idx) const
virtual const char *	GetNameOfClass () const
virtual void	PopBackInput ()
virtual void	PopFrontInput ()
virtual void	PushBackInput (const InputImageType *image)
virtual void	PushFrontInput (const InputImageType *image)
virtual void	SetInput (const InputImageType *image)
virtual void	SetInput (unsigned int, const TInputImage *image)
Static Public Attributes

static const unsigned int	InputImageDimension = TInputImage::ImageDimension
static const unsigned int	OutputImageDimension = TOutputImage::ImageDimension
Protected Types
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension) >	InputToOutputRegionCopierType
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension) >	OutputToInputRegionCopierType
Protected Member Functions
virtual void	CallCopyInputRegionToOutputRegion (OutputImageRegionType &destRegion, const InputImageRegionType &srcRegion)
virtual void	CallCopyOutputRegionToInputRegion (InputImageRegionType &destRegion, const OutputImageRegionType &srcRegion)
virtual void	GenerateInputRequestedRegion ()
	ImageToImageFilter ()
virtual void	PrintSelf (std::ostream &os, Indent indent) const
virtual void	VerifyInputInformation ()
	~ImageToImageFilter ()
void	PushBackInput (const DataObject *input)
void	PushFrontInput (const DataObject *input)
	ImageToImageFilter (const Self &)
void	operator= (const Self &)

Detailed Description

template<class TInputImage, class TOutputImage>
class itk::ImageToImageFilter< TInputImage, TOutputImage >

Base class for filters that take an image as input and produce an image as output.

ImageToImageFilter is the base class for all process objects that output image data and require image data as input. Specifically, this class defines the SetInput() method for defining the input to a filter.

This class provides the infrastructure for supporting multithreaded processing of images. If a filter provides an implementation of GenerateData(), the image processing will run in a single thread and the implementation is responsible for allocating its output data. If a filter provides an implementation of ThreadedGenerateData() instead, the image will be divided into a number of pieces, a number of threads will be spawned, and ThreadedGenerateData() will be called in each thread. Here, the output memory will be allocated by this superclass prior to calling ThreadedGenerateData().

ImageToImageFilter provides an implementation of GenerateInputRequestedRegion(). The base assumption to this point in the hierarchy is that a process object would ask for the largest possible region on input in order to produce any output. Imaging filters, however, can usually answer this question more precisely. The default implementation of GenerateInputRequestedRegion() in this class is to request an input that matches the size of the requested output. If a filter requires more input (say a filter that uses neighborhood information) or less input (for instance a magnify filter), then these filters will have to provide another implmentation of this method. By convention, such implementations should call the Superclass' method first.

Wiki Examples:

All Examples

Filter an image

Write a filter with multiple inputs of the same type.

Write a filter with multiple inputs of different types.

Write a filter with multiple outputs of the same type.

Multi-threaded oil painting image filter

Write a filter with multiple outputs of different types.

Definition at line 80 of file itkImageToImageFilter.h.

Member Typedef Documentation

template<class TInputImage, class TOutputImage>

typedef SmartPointer< const Self > itk::ImageToImageFilter< TInputImage, TOutputImage >::ConstPointer

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 87 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef InputImageType::ConstPointer itk::ImageToImageFilter< TInputImage, TOutputImage >::InputImageConstPointer

Definition at line 99 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef InputImageType::PixelType itk::ImageToImageFilter< TInputImage, TOutputImage >::InputImagePixelType

Definition at line 101 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef InputImageType::Pointer itk::ImageToImageFilter< TInputImage, TOutputImage >::InputImagePointer

Definition at line 98 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef InputImageType::RegionType itk::ImageToImageFilter< TInputImage, TOutputImage >::InputImageRegionType

Definition at line 100 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef TInputImage itk::ImageToImageFilter< TInputImage, TOutputImage >::InputImageType

Some convenient typedefs.

Definition at line 97 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef ImageToImageFilterDetail::ImageRegionCopier< itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension) > itk::ImageToImageFilter< TInputImage, TOutputImage >::InputToOutputRegionCopierType [protected]

Typedef for the region copier function object that converts an input region to an output region.

Definition at line 204 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef Superclass::OutputImagePixelType itk::ImageToImageFilter< TInputImage, TOutputImage >::OutputImagePixelType

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 94 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef Superclass::OutputImageRegionType itk::ImageToImageFilter< TInputImage, TOutputImage >::OutputImageRegionType

Superclass typedefs.

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 90 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef ImageToImageFilterDetail::ImageRegionCopier< itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension) > itk::ImageToImageFilter< TInputImage, TOutputImage >::OutputToInputRegionCopierType [protected]

Typedef for the region copier function object that converts an output region to an input region.

Definition at line 210 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef SmartPointer< Self > itk::ImageToImageFilter< TInputImage, TOutputImage >::Pointer

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 86 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef ImageToImageFilter itk::ImageToImageFilter< TInputImage, TOutputImage >::Self

Standard class typedefs.

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 84 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

typedef ImageSource< TOutputImage > itk::ImageToImageFilter< TInputImage, TOutputImage >::Superclass

Reimplemented from itk::ImageSource< TOutputImage >.

Definition at line 85 of file itkImageToImageFilter.h.

Constructor & Destructor Documentation

template<class TInputImage, class TOutputImage>

itk::ImageToImageFilter< TInputImage, TOutputImage >::ImageToImageFilter ( ) [protected]

template<class TInputImage, class TOutputImage>

itk::ImageToImageFilter< TInputImage, TOutputImage >::~ImageToImageFilter ( ) [protected]

template<class TInputImage, class TOutputImage>

itk::ImageToImageFilter< TInputImage, TOutputImage >::ImageToImageFilter ( const Self & ) [private]

PushBackInput(), PushFronInput() in the public section force the input to be the type expected by an ImageToImageFilter. However, these methods end of "hiding" the versions from the superclass (ProcessObject) whose arguments are DataObjects. Here, we re-expose the versions from ProcessObject to avoid warnings about hiding methods from the superclass.

Member Function Documentation

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::CallCopyInputRegionToOutputRegion	(	OutputImageRegionType &	destRegion,
		const InputImageRegionType &	srcRegion
	)		`[protected, virtual]`

This function calls the actual region copier to do the mapping from input image space to output image space. It uses a Function object used for dispatching to various routines to copy an input region (start index and size) to an output region. For most filters, this is a trivial copy because most filters require the input dimension to match the output dimension. However, some filters like itk::UnaryFunctorImageFilter can support output images of a higher dimension that the input.

This function object is used by the default implementation of GenerateOutputInformation(). It can also be used in routines like ThreadedGenerateData() where a filter may need to map an input region to an output region.

The default copier uses a "dispatch pattern" to call one of three overloaded functions depending on whether the input and output images are the same dimension, the input is a higher dimension that the output, or the input is of a lower dimension than the output. The use of an overloaded function is required for proper compilation of the various cases.

For the latter two cases, trivial implementations are used. If the input image is a higher dimension than the output, the first portion of the input region is copied to the output region. If the input region is a lower dimension than the output, the input region information is copied into the first portion of the output region and the rest of the output region is set to zero.

If a filter needs a different default behavior, it can override this method.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::CallCopyOutputRegionToInputRegion	(	InputImageRegionType &	destRegion,
		const OutputImageRegionType &	srcRegion
	)		`[protected, virtual]`

This function calls the actual region copier to do the mapping from output image space to input image space. It uses a Function object used for dispatching to various routines to copy an output region (start index and size) to an input region. For most filters, this is a trivial copy because most filters require the input dimension to match the output dimension. However, some filters like itk::ExtractImageFilter can support output images of a lower dimension that the input.

This function object can be used by GenerateOutputInformation() to copy the input LargestPossibleRegion to the output LargestPossibleRegion and can also be used in GenerateData or ThreadedGenerateData() where a filter may need to map an output region to an input region.

The default copier uses a "dispatch pattern" to call one of three overloaded functions depending on whether the input and output images are the same dimension, the input is a higher dimension that the output, or the input is of a lower dimension than the output. The use of an overloaded function is required for proper compilation of the various cases.

For the latter two cases, trivial implementations are used. If the input image is a higher dimension than the output, the output region information is copied into the first portion of the input region and the rest of the input region is set to zero. If the input region is a lower dimension than the output, the first portion of the output region is copied to the input region.

If a filter needs a different default behavior, it can override this method. The ExtractImageFilter overrides this function object so that if the input image is a higher dimension than the output image, the filter can control "where" in the input image the output subimage is extracted (as opposed to mapping to first few dimensions of the input).

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::GenerateInputRequestedRegion ( ) [protected, virtual]

What is the input requested region that is required to produce the output requested region? The base assumption for image processing filters is that the input requested region can be set to match the output requested region. If a filter requires more input (for instance a filter that uses neighborhoods needs more input than output to avoid introducing artificial boundary conditions) or less input (for instance a magnify filter) will have to override this method. In doing so, it should call its superclass' implementation as its first step. Note that imaging filters operate differently than the classes to this point in the class hierachy. Up till now, the base assumption has been that the largest possible region will be requested of the input.

This implementation of GenerateInputRequestedRegion() only processes the inputs that are a subclass of the ImageBase<InputImageDimension>. If an input is another type of DataObject (including an Image of a different dimension), they are skipped by this method. The subclasses of ImageToImageFilter are responsible for providing an implementation of GenerateInputRequestedRegion() when there are multiple inputs of different types.

See also:: ProcessObject::GenerateInputRequestedRegion(), ImageSource::GenerateInputRequestedRegion()

Reimplemented from itk::ProcessObject.

template<class TInputImage, class TOutputImage>

const InputImageType* itk::ImageToImageFilter< TInputImage, TOutputImage >::GetInput ( void ) const

Referenced by itk::ComposeDisplacementFieldsImageFilter< TInputImage, TOutputImage >::GetDisplacementField(), itk::InvertDisplacementFieldImageFilter< TInputImage, TOutputImage >::GetDisplacementField(), itk::ComposeDisplacementFieldsImageFilter< TInputImage, TOutputImage >::GetWarpingField(), itk::ComposeDisplacementFieldsImageFilter< TInputImage, TOutputImage >::SetDisplacementField(), itk::InvertDisplacementFieldImageFilter< TInputImage, TOutputImage >::SetDisplacementField(), and itk::ComposeDisplacementFieldsImageFilter< TInputImage, TOutputImage >::SetWarpingField().

template<class TInputImage, class TOutputImage>

const InputImageType* itk::ImageToImageFilter< TInputImage, TOutputImage >::GetInput ( unsigned int idx ) const

template<class TInputImage, class TOutputImage>

virtual const char* itk::ImageToImageFilter< TInputImage, TOutputImage >::GetNameOfClass ( ) const [virtual]

Run-time type information (and related methods).

Reimplemented from itk::ImageSource< TOutputImage >.

template<class TInputImage, class TOutputImage>

void itk::ImageToImageFilter< TInputImage, TOutputImage >::operator= ( const Self & ) [private]

PushBackInput(), PushFronInput() in the public section force the input to be the type expected by an ImageToImageFilter. However, these methods end of "hiding" the versions from the superclass (ProcessObject) whose arguments are DataObjects. Here, we re-expose the versions from ProcessObject to avoid warnings about hiding methods from the superclass.

Reimplemented from itk::ImageSource< TOutputImage >.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::PopBackInput ( ) [virtual]

Push/Pop an indexed input of this process object. These methods allow a filter to model its input vector as a queue or stack. These routines may not be appropriate for all filters, especially filters with different types of inputs. These routines follow the semantics of STL.

Reimplemented from itk::ProcessObject.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::PopFrontInput ( ) [virtual]

Push/Pop an indexed input of this process object. These methods allow a filter to model its input vector as a queue or stack. These routines may not be appropriate for all filters, especially filters with different types of inputs. These routines follow the semantics of STL.

Reimplemented from itk::ProcessObject.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::PrintSelf	(	std::ostream &	os,
		Indent	indent
	)		const `[protected, virtual]`

Methods invoked by Print() to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from itk::ProcessObject.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::PushBackInput ( const InputImageType * image ) [virtual]

Push/Pop the input of this process object. These methods allow a filter to model its input vector as a queue or stack. These routines may not be appropriate for all filters, especially filters with different types of inputs. These routines follow the semantics of STL.

The routines are useful for applications that need to process "rolling" sets of images. For instance, if an application has 10 images and they need to run a filter on images 1, 2, 3, 4, then run the filter on images 2, 3, 4, 5, then run the filter on images 3, 4, 5, 6, the application can accomplish this by popping an input off the front of the input list and push a new image onto the back of input list. Again, this only makes sense for filters that single type of input.

Other uses are also possible. For a single input filter, pushing and popping inputs allow the application to temporarily replace an input to a filter.

template<class TInputImage, class TOutputImage>

void itk::ImageToImageFilter< TInputImage, TOutputImage >::PushBackInput ( const DataObject * input ) [inline, protected, virtual]

PushBackInput(), PushFronInput() in the public section force the input to be the type expected by an ImageToImageFilter. However, these methods end of "hiding" the versions from the superclass (ProcessObject) whose arguments are DataObjects. Here, we re-expose the versions from ProcessObject to avoid warnings about hiding methods from the superclass.

Reimplemented from itk::ProcessObject.

Definition at line 291 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::PushFrontInput ( const InputImageType * image ) [virtual]

template<class TInputImage, class TOutputImage>

void itk::ImageToImageFilter< TInputImage, TOutputImage >::PushFrontInput ( const DataObject * input ) [inline, protected, virtual]

PushBackInput(), PushFronInput() in the public section force the input to be the type expected by an ImageToImageFilter. However, these methods end of "hiding" the versions from the superclass (ProcessObject) whose arguments are DataObjects. Here, we re-expose the versions from ProcessObject to avoid warnings about hiding methods from the superclass.

Reimplemented from itk::ProcessObject.

Definition at line 293 of file itkImageToImageFilter.h.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::SetInput ( const InputImageType * image ) [virtual]

Reimplemented in itk::WatershedImageFilter< TInputImage >, and itk::VoronoiSegmentationRGBImageFilter< TInputImage, TOutputImage >.

Referenced by itk::CannySegmentationLevelSetFunction< TImageType, TFeatureImageType >::AssignCannyInput(), itk::ComposeDisplacementFieldsImageFilter< TInputImage, TOutputImage >::SetDisplacementField(), itk::InvertDisplacementFieldImageFilter< TInputImage, TOutputImage >::SetDisplacementField(), and itk::ComposeDisplacementFieldsImageFilter< TInputImage, TOutputImage >::SetWarpingField().

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::SetInput	(	unsigned	int,
		const TInputImage *	image
	)		`[virtual]`

Reimplemented in itk::WatershedImageFilter< TInputImage >, and itk::VoronoiSegmentationRGBImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage>

virtual void itk::ImageToImageFilter< TInputImage, TOutputImage >::VerifyInputInformation ( ) [protected, virtual]

Verifies that the input images occupy the same physical space and the each index is at the same physical location.

The default implementation of the PropagateRequestedRegion methods copies the index and size from the output to the input. This makes an implicit assumption that the images occupy the same physical location at each voxel. This method enforces that they are the same.

This implementation verifies that all input images of InputImageDimensions have the same origin, spacing and direction.

Filters which do not expect all input images to be at the same physical location should over-ride this method. Also filters whose inputs are different dimensions may need to overide this method.