#include <itkImageBase.h>

Detailed Description

template<unsigned int VImageDimension = 2>
class itk::ImageBase< VImageDimension >

Base class for templated image classes.

ImageBase is the base class for the templated Image classes. ImageBase is templated over the dimension of the image. It provides the API and ivars that depend solely on the dimension of the image. ImageBase does not store any of the image (pixel) data. Storage for the pixels and the pixel access methods are defined in subclasses of ImageBase, namely Image and ImageAdaptor.

ImageBase manages the geometry of an image. The geometry of an image is defined by its position, orientation, spacing, and extent.

The position and orientation of an image is defined by its "Origin" and its "Directions". The "Origin" is the physical position of the pixel whose "Index" is all zeros. The "Direction" of an image is a matrix whose columns indicate the direction in physical space that each dimension of the image traverses. The first column defines the direction that the fastest moving index in the image traverses in physical space while the last column defines the direction that the slowest moving index in the image traverses in physical space.

The extent of an image is defined by the pixel spacing and a set of regions. The "Spacing" is the size of a pixel in physical space along each dimension. Regions describe a portion of an image grid via a starting index for the image array and a size (or number of pixels) in each dimension. The ivar LargestPossibleRegion defines the size and starting index of the image dataset. The entire image dataset, however, may not be resident in memory. The region of the image that is resident in memory is defined by the "BufferedRegion". The Buffer is a contiguous block of memory. The third set of meta-data defines a region of interest, called the "RequestedRegion". The RequestedRegion is used by the pipeline execution model to define what a filter is requested to produce.

[RegionIndex, RegionSize] C [BufferIndex, BufferSize] C [ImageIndex, ImageSize]

ImageBase provides all the methods for converting between the physical space and index coordinate frames. TransformIndexToPhysicalPoint() converts an Index in the pixel array into its coordinates in physical space. TransformPhysicalPointToIndex() converts a position in physical space into an Index into the pixel array (using rounding). Subpixel locations are supported by methods that convert to and from ContinuousIndex types.

ImageBase also provides helper routines for the ImageIterators which convert an Index to an offset in memory from the first pixel address as well as convert an offset in memory from the first pixel address to an Index.

Definition at line 114 of file itkImageBase.h.

Inheritance diagram for itk::ImageBase< VImageDimension >:

Collaboration diagram for itk::ImageBase< VImageDimension >:

Public Types
using	ConstPointer = SmartPointer< const Self >

using	DirectionType = Matrix< SpacePrecisionType, VImageDimension, VImageDimension >

using	ImageDimensionType = unsigned int

using	IndexType = Index< VImageDimension >

using	IndexValueType = typename IndexType::IndexValueType

using	OffsetType = Offset< VImageDimension >

using	OffsetValueType = typename OffsetType::OffsetValueType

using	Pointer = SmartPointer< Self >

using	PointType = Point< PointValueType, VImageDimension >

using	PointValueType = SpacePrecisionType

using	RegionType = ImageRegion< VImageDimension >

using	Self = ImageBase

using	SizeType = Size< VImageDimension >

using	SizeValueType = typename SizeType::SizeValueType

using	SpacingType = Vector< SpacingValueType, VImageDimension >

using	SpacingValueType = SpacePrecisionType

using	Superclass = DataObject

Public Types inherited from itk::DataObject
using	ConstPointer = SmartPointer< const Self >

using	DataObjectIdentifierType = std::string

using	DataObjectPointerArraySizeType = std::vector< Pointer >::size_type

using	Pointer = SmartPointer< Self >

using	Self = DataObject

using	Superclass = Object

Public Types inherited from itk::Object
using	ConstPointer = SmartPointer< const Self >

using	Pointer = SmartPointer< Self >

using	Self = Object

using	Superclass = LightObject

Public Types inherited from itk::LightObject
using	ConstPointer = SmartPointer< const Self >

using	Pointer = SmartPointer< Self >

using	Self = LightObject

Public Member Functions
virtual void	Allocate (bool initialize=false)

void	AllocateInitialized ()

OffsetValueType	ComputeOffset (const IndexType &ind) const

void	CopyInformation (const DataObject *data) override

virtual const RegionType &	GetBufferedRegion () const

virtual const DirectionType &	GetDirection () const

virtual const DirectionType &	GetInverseDirection () const

virtual const RegionType &	GetLargestPossibleRegion () const

const char *	GetNameOfClass () const override

virtual const PointType &	GetOrigin () const

virtual const RegionType &	GetRequestedRegion () const

virtual const SpacingType &	GetSpacing () const

virtual void	Graft (const Self *image)

void	Initialize () override

bool	IsCongruentImageGeometry (const ImageBase *otherImage, double coordinateTolerance, double directionTolerance) const

bool	IsSameImageGeometryAs (const ImageBase *otherImage, double coordinateTolerance=DefaultImageCoordinateTolerance, double directionTolerance=DefaultImageDirectionTolerance) const

bool	RequestedRegionIsOutsideOfTheBufferedRegion () override

virtual void	SetBufferedRegion (const RegionType &region)

virtual void	SetDirection (const DirectionType &direction)

virtual void	SetLargestPossibleRegion (const RegionType &region)

virtual void	SetRegions (const SizeType &size)

void	SetRequestedRegion (const DataObject *data) override

virtual void	SetRequestedRegion (const RegionType &region)

void	SetRequestedRegionToLargestPossibleRegion () override

template<typename TCoordRep >
void	TransformLocalVectorToPhysicalVector (const FixedArray< TCoordRep, VImageDimension > &inputGradient, FixedArray< TCoordRep, VImageDimension > &outputGradient) const

template<typename TIndexRep , typename TCoordRep >
ContinuousIndex< TIndexRep, VImageDimension >	TransformPhysicalPointToContinuousIndex (const Point< TCoordRep, VImageDimension > &point) const

template<typename TCoordRep , typename TIndexRep >
bool	TransformPhysicalPointToContinuousIndex (const Point< TCoordRep, VImageDimension > &point, ContinuousIndex< TIndexRep, VImageDimension > &index) const

template<typename TCoordRep >
bool	TransformPhysicalPointToIndex (const Point< TCoordRep, VImageDimension > &point, IndexType &index) const

template<typename TCoordRep >
void	TransformPhysicalVectorToLocalVector (const FixedArray< TCoordRep, VImageDimension > &inputGradient, FixedArray< TCoordRep, VImageDimension > &outputGradient) const

void	UpdateOutputData () override

void	UpdateOutputInformation () override

bool	VerifyRequestedRegion () override


virtual void	SetOrigin (PointType _arg)

virtual void	SetOrigin (const double origin[VImageDimension])

virtual void	SetOrigin (const float origin[VImageDimension])


virtual void	SetRegions (const RegionType &region)


const OffsetValueType *	GetOffsetTable () const


IndexType	ComputeIndex (OffsetValueType offset) const


virtual void	SetSpacing (const SpacingType &spacing)

virtual void	SetSpacing (const double spacing[VImageDimension])

virtual void	SetSpacing (const float spacing[VImageDimension])


template<typename TCoordRep >
IndexType	TransformPhysicalPointToIndex (const Point< TCoordRep, VImageDimension > &point) const


template<typename TCoordRep , typename TIndexRep >
void	TransformContinuousIndexToPhysicalPoint (const ContinuousIndex< TIndexRep, VImageDimension > &index, Point< TCoordRep, VImageDimension > &point) const


template<typename TCoordRep , typename TIndexRep >
Point< TCoordRep, VImageDimension >	TransformContinuousIndexToPhysicalPoint (const ContinuousIndex< TIndexRep, VImageDimension > &index) const


template<typename TCoordRep >
void	TransformIndexToPhysicalPoint (const IndexType &index, Point< TCoordRep, VImageDimension > &point) const


template<typename TCoordRep >
Point< TCoordRep, VImageDimension >	TransformIndexToPhysicalPoint (const IndexType &index) const


template<typename TVector >
TVector	TransformLocalVectorToPhysicalVector (const TVector &inputGradient) const


template<typename TVector >
TVector	TransformPhysicalVectorToLocalVector (const TVector &inputGradient) const


virtual unsigned int	GetNumberOfComponentsPerPixel () const

virtual void	SetNumberOfComponentsPerPixel (unsigned int)

Public Member Functions inherited from itk::DataObject
virtual void	CopyInformation (const DataObject *)

virtual void	DataHasBeenGenerated ()

void	DisconnectPipeline ()

bool	GetDataReleased () const

const char *	GetNameOfClass () const override

virtual const bool &	GetReleaseDataFlag () const

SmartPointer< ProcessObject >	GetSource () const

DataObjectPointerArraySizeType	GetSourceOutputIndex () const

const DataObjectIdentifierType &	GetSourceOutputName () const

virtual ModifiedTimeType	GetUpdateMTime () const

virtual void	Graft (const DataObject *)

virtual void	Initialize ()

virtual void	PrepareForNewData ()

virtual void	PropagateRequestedRegion ()

void	ReleaseData ()

virtual void	ReleaseDataFlagOn ()

virtual bool	RequestedRegionIsOutsideOfTheBufferedRegion ()

virtual void	ResetPipeline ()

void	SetReleaseDataFlag (bool flag)

virtual void	SetRequestedRegion (const DataObject *)

virtual void	SetRequestedRegionToLargestPossibleRegion ()

bool	ShouldIReleaseData () const

virtual void	Update ()

virtual void	UpdateOutputData ()

virtual void	UpdateOutputInformation ()

void	UpdateSource () const

virtual bool	VerifyRequestedRegion ()

void	SetPipelineMTime (ModifiedTimeType time)

virtual const ModifiedTimeType &	GetPipelineMTime () const

virtual void	SetRealTimeStamp (RealTimeStamp _arg)

virtual const RealTimeStamp &	GetRealTimeStamp () const

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *cmd) const

unsigned long	AddObserver (const EventObject &event, std::function< void(const EventObject &)> function) const

LightObject::Pointer	CreateAnother () const override

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary ()

const MetaDataDictionary &	GetMetaDataDictionary () const

virtual ModifiedTimeType	GetMTime () const

const char *	GetNameOfClass () const override

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

void	Register () const override

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag) const

void	SetDebug (bool debugFlag) const

void	SetReferenceCount (int) override

void	UnRegister () const noexcept override

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

void	SetMetaDataDictionary (MetaDataDictionary &&rrhs)

virtual void	SetObjectName (std::string _arg)

virtual const std::string &	GetObjectName () const

Public Member Functions inherited from itk::LightObject
Pointer	Clone () const

virtual Pointer	CreateAnother () const

virtual void	Delete ()

virtual const char *	GetNameOfClass () const

virtual int	GetReferenceCount () const

void	Print (std::ostream &os, Indent indent=0) const

virtual void	Register () const

virtual void	SetReferenceCount (int)

virtual void	UnRegister () const noexcept

Static Public Member Functions
static constexpr unsigned int	GetImageDimension ()

static Pointer	New ()

Static Public Member Functions inherited from itk::DataObject
static bool	GetGlobalReleaseDataFlag ()

static void	GlobalReleaseDataFlagOff ()

static void	GlobalReleaseDataFlagOn ()

static Pointer	New ()

static void	SetGlobalReleaseDataFlag (bool val)

Static Public Member Functions inherited from itk::Object
static bool	GetGlobalWarningDisplay ()

static void	GlobalWarningDisplayOff ()

static void	GlobalWarningDisplayOn ()

static Pointer	New ()

static void	SetGlobalWarningDisplay (bool val)

Static Public Member Functions inherited from itk::LightObject
static void	BreakOnError ()

static Pointer	New ()

Static Public Attributes
static constexpr ImageDimensionType	ImageDimension = VImageDimension

Protected Member Functions
virtual void	ComputeIndexToPhysicalPointMatrices ()

void	ComputeOffsetTable ()

void	Graft (const DataObject *data) override

	ImageBase ()=default

virtual void	InitializeBufferedRegion ()

void	PrintSelf (std::ostream &os, Indent indent) const override

	~ImageBase () override=default


OffsetValueType	FastComputeOffset (const IndexType &ind) const


IndexType	FastComputeIndex (OffsetValueType offset) const

Protected Member Functions inherited from itk::DataObject
	DataObject ()

void	PrintSelf (std::ostream &os, Indent indent) const override

virtual void	PropagateResetPipeline ()

	~DataObject () override

Protected Member Functions inherited from itk::Object
	Object ()

bool	PrintObservers (std::ostream &os, Indent indent) const

void	PrintSelf (std::ostream &os, Indent indent) const override

virtual void	SetTimeStamp (const TimeStamp &timeStamp)

	~Object () override

Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer	InternalClone () const

	LightObject ()

virtual void	PrintHeader (std::ostream &os, Indent indent) const

virtual void	PrintSelf (std::ostream &os, Indent indent) const

virtual void	PrintTrailer (std::ostream &os, Indent indent) const

virtual	~LightObject ()

Protected Attributes

SpacingType	m_Spacing { MakeFilled<SpacingType>(1.0) }

PointType	m_Origin {}

DirectionType	m_Direction { DirectionType::GetIdentity() }

DirectionType	m_InverseDirection { DirectionType::GetIdentity() }


DirectionType	m_IndexToPhysicalPoint { DirectionType::GetIdentity() }

DirectionType	m_PhysicalPointToIndex { DirectionType::GetIdentity() }

Protected Attributes inherited from itk::LightObject
std::atomic< int >	m_ReferenceCount {}

Private Attributes
RegionType	m_BufferedRegion {}

RegionType	m_LargestPossibleRegion {}

OffsetValueType	m_OffsetTable [VImageDimension+1] {}

RegionType	m_RequestedRegion {}

Member Typedef Documentation

◆ ConstPointer

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::ConstPointer = SmartPointer<const Self>

Definition at line 123 of file itkImageBase.h.

◆ DirectionType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::DirectionType = Matrix<SpacePrecisionType, VImageDimension, VImageDimension>

Direction type alias support. The Direction is a matrix of direction cosines that specify the direction in physical space between samples along each dimension.

Definition at line 171 of file itkImageBase.h.

◆ ImageDimensionType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::ImageDimensionType = unsigned int

Type of image dimension

Definition at line 132 of file itkImageBase.h.

◆ IndexType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::IndexType = Index<VImageDimension>

Index type alias support. An index is used to access pixel values.

Definition at line 141 of file itkImageBase.h.

◆ IndexValueType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::IndexValueType = typename IndexType::IndexValueType

Definition at line 142 of file itkImageBase.h.

◆ OffsetType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::OffsetType = Offset<VImageDimension>

Offset type alias support. An offset represent relative position between indices.

Definition at line 146 of file itkImageBase.h.

◆ OffsetValueType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::OffsetValueType = typename OffsetType::OffsetValueType

Definition at line 147 of file itkImageBase.h.

◆ Pointer

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::Pointer = SmartPointer<Self>

Definition at line 122 of file itkImageBase.h.

◆ PointType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::PointType = Point<PointValueType, VImageDimension>

Definition at line 166 of file itkImageBase.h.

◆ PointValueType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::PointValueType = SpacePrecisionType

Origin type alias support. The origin is the geometric coordinates of the index (0,0).

Definition at line 165 of file itkImageBase.h.

◆ RegionType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::RegionType = ImageRegion<VImageDimension>

Region type alias support. A region is used to specify a subset of an image.

Definition at line 154 of file itkImageBase.h.

◆ Self

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::Self = ImageBase

Standard type alias.

Definition at line 120 of file itkImageBase.h.

◆ SizeType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::SizeType = Size<VImageDimension>

Size type alias support. A size is used to define region bounds.

Definition at line 150 of file itkImageBase.h.

◆ SizeValueType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::SizeValueType = typename SizeType::SizeValueType

Definition at line 151 of file itkImageBase.h.

◆ SpacingType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::SpacingType = Vector<SpacingValueType, VImageDimension>

Definition at line 161 of file itkImageBase.h.

◆ SpacingValueType

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::SpacingValueType = SpacePrecisionType

Spacing type alias support. Spacing holds the size of a pixel. The spacing is the geometric distance between image samples along each dimension. ITK only supports positive spacing values: negative values may cause undesirable results.

Definition at line 160 of file itkImageBase.h.

◆ Superclass

template<unsigned int VImageDimension = 2>

using itk::ImageBase< VImageDimension >::Superclass = DataObject

Definition at line 121 of file itkImageBase.h.

Constructor & Destructor Documentation

◆ ImageBase()

template<unsigned int VImageDimension = 2>

itk::ImageBase< VImageDimension >::ImageBase ( )

protecteddefault

◆ ~ImageBase()

template<unsigned int VImageDimension = 2>

itk::ImageBase< VImageDimension >::~ImageBase ( )

overrideprotecteddefault

Member Function Documentation

◆ Allocate()

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::Allocate ( bool initialize = false )

virtual

Allocate the image memory. The size of the image must already be set, e.g. by calling SetRegions() or SetBufferedRegion().

This method should be pure virtual, if backwards compatibility was not required.

◆ AllocateInitialized()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::AllocateInitialized ( )

inline

Allocates the pixel buffer of the image, zero-initializing its pixels. AllocateInitialized() is equivalent to Allocate(true). It is just intended to make the code more readable.

Definition at line 258 of file itkImageBase.h.

◆ ComputeIndex()

template<unsigned int VImageDimension = 2>

IndexType itk::ImageBase< VImageDimension >::ComputeIndex ( OffsetValueType offset ) const

inline

Compute the index of the pixel at a specified offset from the beginning of the buffered region. Bounds checking is not performed. Thus, the computed index could be outside the BufferedRegion. To ensure a valid index, the parameter "offset" should be between 0 and the number of pixels in the BufferedRegion (the latter can be found using ImageRegion::GetNumberOfPixels()).

Definition at line 408 of file itkImageBase.h.

References itk::ImageHelper< VImageDimension, VLoop >::ComputeIndex(), and itk::Index< VDimension >::GetIndex().

◆ ComputeIndexToPhysicalPointMatrices()

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::ComputeIndexToPhysicalPointMatrices ( )

protectedvirtual

Compute helper matrices used to transform Index coordinates to PhysicalPoint coordinates and back. This method is virtual and will be overloaded in derived classes in order to provide backward compatibility behavior in classes that did not used to take image orientation into account.

Reimplemented in itk::Image< TPixel, VImageDimension >, itk::Image< TPixel, 2 >, and itk::Image< TNode *, 2 >.

◆ ComputeOffset()

template<unsigned int VImageDimension = 2>

OffsetValueType itk::ImageBase< VImageDimension >::ComputeOffset ( const IndexType & ind ) const

inline

Compute an offset from the beginning of the buffer for a pixel at the specified index. The index is not checked as to whether it is inside the current buffer, so the computed offset could conceivably be outside the buffer. If bounds checking is needed, one can call ImageRegion::IsInside(ind) on the BufferedRegion prior to calling ComputeOffset.

Definition at line 374 of file itkImageBase.h.

References itk::ImageHelper< VImageDimension, VLoop >::ComputeOffset().

◆ ComputeOffsetTable()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::ComputeOffsetTable ( )

protected

Calculate the offsets needed to move from one pixel to the next along a row, column, slice, volume, etc. These offsets are based on the size of the BufferedRegion. This should be called after the BufferedRegion is set.

◆ CopyInformation()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::CopyInformation ( const DataObject * data )

overridevirtual

Copy information from the specified data set. This method is part of the pipeline execution model. By default, a ProcessObject will copy meta-data from the first input to all of its outputs. See ProcessObject::GenerateOutputInformation(). Each subclass of DataObject is responsible for being able to copy whatever meta-data it needs from from another DataObject. ImageBase has more meta-data than its DataObject. Thus, it must provide its own version of CopyInformation() in order to copy the LargestPossibleRegion from the input parameter.

Reimplemented from itk::DataObject.

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ FastComputeIndex()

template<unsigned int VImageDimension = 2>

IndexType itk::ImageBase< VImageDimension >::FastComputeIndex ( OffsetValueType offset ) const

inlineprotected

Directly computes the index of the pixel at a specified offset from the beginning of the buffered region. Bounds checking is not performed. Thus, the computed index could be outside the BufferedRegion. To ensure a valid index, the parameter offset should be between 0 and the number of pixels in the BufferedRegion (the latter can be found using ImageRegion::GetNumberOfPixels()).

Warning: unlike ComputeOffset(), this version does not incur a virtual call. It's meant to be used only for itk::Image<>, itk::VectorImage<> and itk::SpecialCoordinatesImage<>.

Definition at line 918 of file itkImageBase.h.

References itk::ImageHelper< VImageDimension, VLoop >::ComputeIndex(), and itk::Index< VDimension >::GetIndex().

◆ FastComputeOffset()

template<unsigned int VImageDimension = 2>

OffsetValueType itk::ImageBase< VImageDimension >::FastComputeOffset ( const IndexType & ind ) const

inlineprotected

Directly computes an offset from the beginning of the buffer for a pixel at the specified index. The index is not checked as to whether it is inside the current buffer, so the computed offset could conceivably be outside the buffer. If bounds checking is needed, one can call ImageRegion::IsInside(ind) on the BufferedRegion prior to calling ComputeOffset.

Warning: unlike ComputeOffset(), this version does not incur a virtual call. It's meant to be used only for itk::Image<>, itk::VectorImage<> and itk::SpecialCoordinatesImage<>.

Definition at line 897 of file itkImageBase.h.

References itk::ImageHelper< VImageDimension, VLoop >::ComputeOffset().

◆ GetBufferedRegion()

template<unsigned int VImageDimension = 2>

virtual const RegionType & itk::ImageBase< VImageDimension >::GetBufferedRegion ( ) const

inlinevirtual

Get the region object that defines the size and starting index of the region of the image currently loaded in memory.

See also: ImageRegion, SetLargestPossibleRegion(), SetRequestedRegion()

Definition at line 294 of file itkImageBase.h.

◆ GetDirection()

template<unsigned int VImageDimension = 2>

virtual const DirectionType & itk::ImageBase< VImageDimension >::GetDirection ( ) const

virtual

Get the direction cosines of the image. The direction cosines are vectors that point from one pixel to the next. For ImageBase and Image, the default direction is identity.

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ GetImageDimension()

template<unsigned int VImageDimension = 2>

static constexpr unsigned int itk::ImageBase< VImageDimension >::GetImageDimension ( )

inlinestaticconstexpr

Image dimension. The dimension of an image is fixed at compile-time.

Definition at line 179 of file itkImageBase.h.

◆ GetInverseDirection()

template<unsigned int VImageDimension = 2>

virtual const DirectionType & itk::ImageBase< VImageDimension >::GetInverseDirection ( ) const

virtual

Get the inverse direction cosines of the image. These are calculated automatically in SetDirection, thus there is no Set accessor.

◆ GetLargestPossibleRegion()

template<unsigned int VImageDimension = 2>

virtual const RegionType & itk::ImageBase< VImageDimension >::GetLargestPossibleRegion ( ) const

inlinevirtual

Get the region object that defines the size and starting index for the largest possible region this image could represent. This is used in determining how much memory would be needed to load an entire dataset. It is also used to determine boundary true conditions.

See also: ImageRegion, GetBufferedRegion(), GetRequestedRegion()

Definition at line 279 of file itkImageBase.h.

Referenced by itk::FastMarchingImageFilter< TLevelSet, TSpeedImage >::SetBinaryMask().

◆ GetNameOfClass()

template<unsigned int VImageDimension = 2>

const char * itk::ImageBase< VImageDimension >::GetNameOfClass ( ) const

overridevirtual

See also: LightObject::GetNameOfClass()

Reimplemented from itk::DataObject.

◆ GetNumberOfComponentsPerPixel()

template<unsigned int VImageDimension = 2>

virtual unsigned int itk::ImageBase< VImageDimension >::GetNumberOfComponentsPerPixel ( ) const

virtual

INTERNAL This method is used internally by filters to copy meta-data from the output to the input. Users should not have a need to use this method.

Filters that override the ProcessObject's GenerateOutputInformation() should generally have the following line if they want to propagate meta- data for both Image and VectorImage

outputImage->SetNumberOfComponentsPerPixel(

inputImage->GetNumberOfComponentsPerPixel() )

See also: ImageBase, VectorImage

Returns/Sets the number of components in the image. Note that in the ImageBase implementation, this always returns 1. Image returns the

returned from NumericTraits for the pixel type, and VectorImage

returns the vector length set by the user.

Reimplemented in itk::Image< TPixel, VImageDimension >, itk::Image< TPixel, 2 >, itk::Image< TNode *, 2 >, and itk::VectorImage< TPixel, VImageDimension >.

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ GetOffsetTable()

template<unsigned int VImageDimension = 2>

const OffsetValueType * itk::ImageBase< VImageDimension >::GetOffsetTable ( ) const

inline

Get the offset table. The offset table gives increments for moving from one pixel to next in the current row, column, slice, etc.. This table if of size [VImageDimension+1], because its values are computed progressively as: {1, N1, N1*N2, N1*N2*N3,...,(N1*...*Nn)} Where the values {N1,...,Nn} are the elements of the BufferedRegion::Size array. The last element of the OffsetTable is equivalent to the BufferSize. Having a [VImageDimension+1] size array, simplifies the implementation of some data accessing algorithms. The entries in the offset table are only valid after the BufferedRegion is set.

Definition at line 361 of file itkImageBase.h.

◆ GetOrigin()

template<unsigned int VImageDimension = 2>

virtual const PointType & itk::ImageBase< VImageDimension >::GetOrigin ( ) const

virtual

Get the origin of the image. The origin is the geometric coordinates of the index (0,0). The value returned is a Point<double, VImageDimension>. For ImageBase and Image, the default origin is 0.

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ GetRequestedRegion()

template<unsigned int VImageDimension = 2>

virtual const RegionType & itk::ImageBase< VImageDimension >::GetRequestedRegion ( ) const

inlinevirtual

Get the region object that defines the size and starting index for the region of the image requested (i.e., the region of the image to be operated on by a filter).

See also: ImageRegion, SetLargestPossibleRegion(), SetBufferedRegion()

Definition at line 324 of file itkImageBase.h.

◆ GetSpacing()

template<unsigned int VImageDimension = 2>

virtual const SpacingType & itk::ImageBase< VImageDimension >::GetSpacing ( ) const

virtual

Get the spacing (size of a pixel) `of the image. The spacing is the geometric distance between image samples along each dimension. The value returned is a Vector<double, VImageDimension>. For ImageBase and Image, the default data spacing is unity.

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ Graft() [1/2]

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::Graft ( const DataObject * )

overrideprotectedvirtual

Method for grafting the content of one data object into another one. This method is intended to be overloaded by derived classes. Each one of them should use dynamic_casting in order to verify that the grafted object is actually of the same type as the class on which the Graft() method was invoked.

Reimplemented from itk::DataObject.

◆ Graft() [2/2]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::Graft ( const Self * image )

virtual

Graft the data and information from one image to another. This is a convenience method to setup a second image with all the meta information of another image and use the same pixel container. Note that this method is different than just using two SmartPointers to the same image since separate DataObjects are still maintained. This method is similar to ImageSource::GraftOutput(). The implementation in ImageBase simply calls CopyInformation() and copies the region ivars. Subclasses of ImageBase are responsible for copying the pixel container.

Reimplemented from itk::DataObject.

◆ Initialize()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::Initialize ( )

overridevirtual

Restore object to initialized state.

Reimplemented from itk::DataObject.

◆ InitializeBufferedRegion()

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::InitializeBufferedRegion ( )

protectedvirtual

Restores the buffered region to its default state This method does not call Modify because Initialization is called by ReleaseData and can not modify the MTime

See also: ReleaseData, Initialize, SetBufferedRegion

◆ IsCongruentImageGeometry()

template<unsigned int VImageDimension = 2>

bool itk::ImageBase< VImageDimension >::IsCongruentImageGeometry	(	const ImageBase< VImageDimension > *	otherImage,
		double	coordinateTolerance,
		double	directionTolerance
	)		const

Checks whether the images' pixels with the same index occupy the same physical space. Compares the origin, spacing, and direction for equality within provided tolerances. There is no check for valid regions in between the images.

◆ IsSameImageGeometryAs()

template<unsigned int VImageDimension = 2>

bool itk::ImageBase< VImageDimension >::IsSameImageGeometryAs	(	const ImageBase< VImageDimension > *	otherImage,
		double	coordinateTolerance = `DefaultImageCoordinateTolerance`,
		double	directionTolerance = `DefaultImageDirectionTolerance`
	)		const

Check whether this image and the other image have the same grid in physical space. Compares largest possible regions for equality, and the origin, spacing, and direction cosines for equality within provided tolerances. See also: ImageToImageFilter, namely: https://github.com/InsightSoftwareConsortium/ITK/blob/v5.3.0/Modules/Core/Common/include/itkImageToImageFilter.h#L78-L92 https://github.com/InsightSoftwareConsortium/ITK/blob/v5.3.0/Modules/Core/Common/src/itkImageToImageFilterCommon.cxx#L26-L27

◆ New()

template<unsigned int VImageDimension = 2>

static Pointer itk::ImageBase< VImageDimension >::New ( )

static

Method for creation through the object factory.

◆ PrintSelf()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::PrintSelf	(	std::ostream &	os,
		Indent	indent
	)		const

overrideprotectedvirtual

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

◆ RequestedRegionIsOutsideOfTheBufferedRegion()

template<unsigned int VImageDimension = 2>

bool itk::ImageBase< VImageDimension >::RequestedRegionIsOutsideOfTheBufferedRegion ( )

overridevirtual

Determine whether the RequestedRegion is outside of the BufferedRegion. This method returns true if the RequestedRegion is outside the BufferedRegion (true if at least one pixel is outside). This is used by the pipeline mechanism to determine whether a filter needs to re-execute in order to satisfy the current request. If the current RequestedRegion is already inside the BufferedRegion from the previous execution (and the current filter is up to date), then a given filter does not need to re-execute

Reimplemented from itk::DataObject.

◆ SetBufferedRegion()

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetBufferedRegion ( const RegionType & region )

virtual

Set the region object that defines the size and starting index of the region of the image currently loaded in memory.

See also: ImageRegion, SetLargestPossibleRegion(), SetRequestedRegion()

◆ SetDirection()

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetDirection ( const DirectionType & direction )

virtual

Set the direction cosines of the image. The direction cosines are vectors that point from one pixel to the next.

Each column of the matrix indicates the direction cosines of the unit vector that is parallel to the lines of the image grid corresponding to that dimension. For example, an image with Direction matrix

0.866 0.500 -0.500 0.866

has an image grid were the fastest changing index (dimension[0]) walks over a line that in physical space is oriented parallel to the vector (0.866, -0.5). The second fastest changing index (dimension[1]) walks along a line that in Physical space is oriented parallel to the vector (0.5, 0.866)

The columns of the Direction matrix are expected to form an orthogonal right handed coordinate system. But this is not checked nor enforced in itk::ImageBase.

For details, please see:

https://www.itk.org/Wiki/Proposals:Orientation#Some_notes_on_the_DICOM_convention_and_current_ITK_usage

See also: GetDirection()

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ SetLargestPossibleRegion()

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetLargestPossibleRegion ( const RegionType & region )

virtual

Set the region object that defines the size and starting index for the largest possible region this image could represent. This is used in determining how much memory would be needed to load an entire dataset. It is also used to determine boundary true conditions.

See also: ImageRegion, SetBufferedRegion(), SetRequestedRegion()

◆ SetNumberOfComponentsPerPixel()

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetNumberOfComponentsPerPixel ( unsigned int )

virtual

INTERNAL This method is used internally by filters to copy meta-data from the output to the input. Users should not have a need to use this method.

Filters that override the ProcessObject's GenerateOutputInformation() should generally have the following line if they want to propagate meta- data for both Image and VectorImage

outputImage->SetNumberOfComponentsPerPixel(

inputImage->GetNumberOfComponentsPerPixel() )

See also: ImageBase, VectorImage

Returns/Sets the number of components in the image. Note that in the ImageBase implementation, this always returns 1. Image returns the

returned from NumericTraits for the pixel type, and VectorImage

returns the vector length set by the user.

Reimplemented in itk::VectorImage< TPixel, VImageDimension >.

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ SetOrigin() [1/3]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetOrigin ( const double origin[VImageDimension] )

virtual

Set the origin of the image. The origin is the geometric coordinates of the image origin (pixel [0,0]). It is stored internally as SpacePrecisionType but may be set from float or double.

See also: GetOrigin()

Reimplemented in itk::SpecialCoordinatesImage< TPixel, VImageDimension >, and itk::SpecialCoordinatesImage< TPixel, 3 >.

◆ SetOrigin() [2/3]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetOrigin ( const float origin[VImageDimension] )

virtual

Set the origin of the image. The origin is the geometric coordinates of the image origin (pixel [0,0]). It is stored internally as SpacePrecisionType but may be set from float or double.

See also: GetOrigin()

Reimplemented in itk::SpecialCoordinatesImage< TPixel, VImageDimension >, and itk::SpecialCoordinatesImage< TPixel, 3 >.

◆ SetOrigin() [3/3]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetOrigin ( PointType _arg )

virtual

Set the origin of the image. The origin is the geometric coordinates of the image origin (pixel [0,0]). It is stored internally as SpacePrecisionType but may be set from float or double.

See also: GetOrigin()

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ SetRegions() [1/2]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetRegions ( const RegionType & region )

inlinevirtual

Convenience methods to set the LargestPossibleRegion, BufferedRegion and RequestedRegion. Allocate must still be called.

Definition at line 333 of file itkImageBase.h.

◆ SetRegions() [2/2]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetRegions ( const SizeType & size )

inlinevirtual

Definition at line 342 of file itkImageBase.h.

References itk::ImageRegion< VImageDimension >::SetSize().

◆ SetRequestedRegion() [1/2]

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::SetRequestedRegion ( const DataObject * data )

overridevirtual

Set the requested region from this data object to match the requested region of the data object passed in as a parameter. This method implements the API from DataObject. The data object parameter must be castable to an ImageBase. Setting the RequestedRegion does not cause the object to be modified. This method is called internally by the pipeline and therefore bypasses the modified time calculation.

Reimplemented from itk::DataObject.

◆ SetRequestedRegion() [2/2]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetRequestedRegion ( const RegionType & region )

virtual

Set the region object that defines the size and starting index for the region of the image requested (i.e., the region of the image to be operated on by a filter). Setting the RequestedRegion does not cause the object to be modified. This method is called internally by the pipeline and therefore bypasses the modified time calculation.

See also: ImageRegion, SetLargestPossibleRegion(), SetBufferedRegion()

◆ SetRequestedRegionToLargestPossibleRegion()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::SetRequestedRegionToLargestPossibleRegion ( )

overridevirtual

Set the RequestedRegion to the LargestPossibleRegion. This forces a filter to produce all of the output in one execution (i.e. not streaming) on the next call to Update().

Reimplemented from itk::DataObject.

◆ SetSpacing() [1/3]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetSpacing ( const double spacing[VImageDimension] )

virtual

Set the spacing (size of a pixel) of the image. The spacing is the geometric distance between image samples along each dimension. It is stored internally as double, but may be set from float. These methods also pre-compute the Index to Physical point transforms of the image.

See also: GetSpacing()

Reimplemented in itk::SpecialCoordinatesImage< TPixel, VImageDimension >, and itk::SpecialCoordinatesImage< TPixel, 3 >.

◆ SetSpacing() [2/3]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetSpacing ( const float spacing[VImageDimension] )

virtual

Set the spacing (size of a pixel) of the image. The spacing is the geometric distance between image samples along each dimension. It is stored internally as double, but may be set from float. These methods also pre-compute the Index to Physical point transforms of the image.

See also: GetSpacing()

Reimplemented in itk::SpecialCoordinatesImage< TPixel, VImageDimension >, and itk::SpecialCoordinatesImage< TPixel, 3 >.

◆ SetSpacing() [3/3]

template<unsigned int VImageDimension = 2>

virtual void itk::ImageBase< VImageDimension >::SetSpacing ( const SpacingType & spacing )

virtual

Set the spacing (size of a pixel) of the image. The spacing is the geometric distance between image samples along each dimension. It is stored internally as double, but may be set from float. These methods also pre-compute the Index to Physical point transforms of the image.

See also: GetSpacing()

Referenced by itk::ImageToImageFilterDetail::ImageToImageFilterDefaultCopyInformation().

◆ TransformContinuousIndexToPhysicalPoint() [1/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep , typename TIndexRep >

Point< TCoordRep, VImageDimension > itk::ImageBase< VImageDimension >::TransformContinuousIndexToPhysicalPoint ( const ContinuousIndex< TIndexRep, VImageDimension > & index ) const

inline

Returns a physical point (in the space which the origin and spacing information comes from) from a continuous index (in the index space)

See also: Transform

Definition at line 582 of file itkImageBase.h.

References itk::point().

◆ TransformContinuousIndexToPhysicalPoint() [2/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep , typename TIndexRep >

void itk::ImageBase< VImageDimension >::TransformContinuousIndexToPhysicalPoint	(	const ContinuousIndex< TIndexRep, VImageDimension > &	index,
		Point< TCoordRep, VImageDimension > &	point
	)		const

inline

Get a physical point (in the space which the origin and spacing information comes from) from a continuous index (in the index space)

See also: Transform

Definition at line 561 of file itkImageBase.h.

References itk::point().

◆ TransformIndexToPhysicalPoint() [1/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep >

Point< TCoordRep, VImageDimension > itk::ImageBase< VImageDimension >::TransformIndexToPhysicalPoint ( const IndexType & index ) const

inline

Returns a physical point (in the space which the origin and spacing information comes from) from a discrete index (in the index space)

See also: Transform

Definition at line 617 of file itkImageBase.h.

References itk::point().

◆ TransformIndexToPhysicalPoint() [2/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep >

void itk::ImageBase< VImageDimension >::TransformIndexToPhysicalPoint	(	const IndexType &	index,
		Point< TCoordRep, VImageDimension > &	point
	)		const

inline

Get a physical point (in the space which the origin and spacing information comes from) from a discrete index (in the index space)

See also: Transform

Definition at line 597 of file itkImageBase.h.

References itk::point().

◆ TransformLocalVectorToPhysicalVector() [1/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep >

void itk::ImageBase< VImageDimension >::TransformLocalVectorToPhysicalVector	(	const FixedArray< TCoordRep, VImageDimension > &	inputGradient,
		FixedArray< TCoordRep, VImageDimension > &	outputGradient
	)		const

inline

Take a vector or covariant vector that has been computed in the coordinate system parallel to the image grid and rotate it by the direction cosines in order to get it in terms of the coordinate system of the image acquisition device. This implementation in the Image multiply the array (vector or covariant vector) by the matrix of Direction Cosines. The arguments of the method are of type FixedArray to make possible to use this method with both Vector and CovariantVector. The Method is implemented differently in the itk::Image.

The inputGradient and the outputGradient must not refer to the same data.

See also: Image

Definition at line 641 of file itkImageBase.h.

References itk::FixedArray< TValue, VLength >::GetDataPointer().

◆ TransformLocalVectorToPhysicalVector() [2/2]

template<unsigned int VImageDimension = 2>

template<typename TVector >

TVector itk::ImageBase< VImageDimension >::TransformLocalVectorToPhysicalVector ( const TVector & inputGradient ) const

inline

Take a vector or covariant vector that has been computed in the coordinate system parallel to the image grid and rotate it by the direction cosines in order to get it in terms of the coordinate system of the image acquisition device. Returns the resulting gradient.

See also: Image

Definition at line 668 of file itkImageBase.h.

◆ TransformPhysicalPointToContinuousIndex() [1/2]

template<unsigned int VImageDimension = 2>

template<typename TIndexRep , typename TCoordRep >

ContinuousIndex< TIndexRep, VImageDimension > itk::ImageBase< VImageDimension >::TransformPhysicalPointToContinuousIndex ( const Point< TCoordRep, VImageDimension > & point ) const

inline

Returns the continuous index from a physical point.

Note: This specific overload does not figure out whether or not the returned index is inside the image. Of course, the user can still test this afterwards by calling ImageRegion::IsInside(index):
auto index = image->TransformPhysicalPointToContinuousIndex<double>(point);

if (image->GetLargestPossibleRegion().IsInside(index)) // Et cetera...

itk::point
*par Constraints *The filter image with at least two dimensions and a vector *length of at least The theory supports extension to scalar but *the implementation of the itk vector classes do not **The template parameter TRealType must be floating point(float or double) or *a user-defined "real" numerical type with arithmetic operations defined *sufficient to compute derivatives. **\par Performance *This filter will automatically multithread if run with *SetUsePrincipleComponents

Which is equivalent to the following code, which calls the other overload:
itk::ContinuousIndex<double, ImageDimension> index;

if (image->TransformPhysicalPointToContinuousIndex(point, index)) // Et cetera...

itk::ContinuousIndex
A templated class holding a point in n-Dimensional image space.
Definition: itkContinuousIndex.h:47

See also: Transform

Definition at line 518 of file itkImageBase.h.

References itk::point().

◆ TransformPhysicalPointToContinuousIndex() [2/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep , typename TIndexRep >

bool itk::ImageBase< VImageDimension >::TransformPhysicalPointToContinuousIndex	(	const Point< TCoordRep, VImageDimension > &	point,
		ContinuousIndex< TIndexRep, VImageDimension > &	index
	)		const

inline

Get the continuous index from a physical point.

Returns true if the resulting index is within the image, false otherwise.

Note: For performance reasons, if you do not need to use the bool return value, please call the corresponding overload instead, which has only one parameter (the point), and returns the continuous index.

See also: Transform

Definition at line 545 of file itkImageBase.h.

References itk::point().

◆ TransformPhysicalPointToIndex() [1/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep >

IndexType itk::ImageBase< VImageDimension >::TransformPhysicalPointToIndex ( const Point< TCoordRep, VImageDimension > & point ) const

inline

Returns the index (discrete) of a voxel from a physical point. Floating point index results are rounded to integers

Note: This specific overload does not figure out whether or not the returned index is inside the image. Of course, the user can still test this afterwards by calling ImageRegion::IsInside(index):
auto index = image->TransformPhysicalPointToIndex(point);

if (image->GetLargestPossibleRegion().IsInside(index)) // Et cetera...

Which is equivalent to the following code, which calls the other overload:
IndexType index;

if (image->TransformPhysicalPointToIndex(point, index)) // Et cetera...

itk::ImageBase::IndexType
Index< VImageDimension > IndexType
Definition: itkImageBase.h:141

See also: Transform

Definition at line 465 of file itkImageBase.h.

References itk::point().

◆ TransformPhysicalPointToIndex() [2/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep >

bool itk::ImageBase< VImageDimension >::TransformPhysicalPointToIndex	(	const Point< TCoordRep, VImageDimension > &	point,
		IndexType &	index
	)		const

inline

Get the index (discrete) of a voxel from a physical point. Floating point index results are rounded to integers Returns true if the resulting index is within the image, false otherwise

Note: For performance reasons, if you do not need to use the bool return value, please call the corresponding overload instead, which has only one parameter (the point), and returns the index.

See also: Transform

Definition at line 492 of file itkImageBase.h.

References itk::point().

◆ TransformPhysicalVectorToLocalVector() [1/2]

template<unsigned int VImageDimension = 2>

template<typename TCoordRep >

void itk::ImageBase< VImageDimension >::TransformPhysicalVectorToLocalVector	(	const FixedArray< TCoordRep, VImageDimension > &	inputGradient,
		FixedArray< TCoordRep, VImageDimension > &	outputGradient
	)		const

inline

Take a vector or covariant vector that has been computed in terms of the coordinate system of the image acquisition device, and rotate it by the inverse direction cosines in order to get it in the coordinate system parallel to the image grid. This implementation in the Image multiply the array (vector or covariant vector) by the inverse of Direction Cosines. The arguments of the method are of type FixedArray to make possible to use this method with both Vector and CovariantVector.

The inputGradient and the outputGradient must not refer to the same data.

Definition at line 691 of file itkImageBase.h.

References itk::FixedArray< TValue, VLength >::GetDataPointer().

◆ TransformPhysicalVectorToLocalVector() [2/2]

template<unsigned int VImageDimension = 2>

template<typename TVector >

TVector itk::ImageBase< VImageDimension >::TransformPhysicalVectorToLocalVector ( const TVector & inputGradient ) const

inline

Take a vector or covariant vector that has been computed in terms of the coordinate system of the image acquisition device, and rotate it by the inverse direction cosines in order to get it in the coordinate system parallel to the image grid. Returns the result.

Definition at line 718 of file itkImageBase.h.

◆ UpdateOutputData()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::UpdateOutputData ( )

overridevirtual

UpdateOutputData() is part of the pipeline infrastructure to communicate between ProcessObjects and DataObjects. The method of the superclass is overridden to check if the requested image region has zero pixels. This is needed so that filters can set an input's requested region to zero, to indicate that it does not need to be updated or executed.

Reimplemented from itk::DataObject.

◆ UpdateOutputInformation()

template<unsigned int VImageDimension = 2>

void itk::ImageBase< VImageDimension >::UpdateOutputInformation ( )

overridevirtual

Update the information for this DataObject so that it can be used as an output of a ProcessObject. This method is used the pipeline mechanism to propagate information and initialize the meta data associated with a DataObject. This method calls its source's ProcessObject::UpdateOutputInformation() which determines modified times, LargestPossibleRegions, and any extra meta data like spacing, origin, etc.

Reimplemented from itk::DataObject.

◆ VerifyRequestedRegion()

template<unsigned int VImageDimension = 2>

bool itk::ImageBase< VImageDimension >::VerifyRequestedRegion ( )

overridevirtual

Verify that the RequestedRegion is within the LargestPossibleRegion. If the RequestedRegion is not within the LargestPossibleRegion, then the filter cannot possible satisfy the request. This method returns true if the request can be satisfied and returns fails if the request cannot. This method is used by PropagateRequestedRegion(). PropagateRequestedRegion() throws a InvalidRequestedRegionError exception is the requested region is not within the LargestPossibleRegion.

Reimplemented from itk::DataObject.

Member Data Documentation

◆ ImageDimension

template<unsigned int VImageDimension = 2>

constexpr ImageDimensionType itk::ImageBase< VImageDimension >::ImageDimension = VImageDimension

staticconstexpr

Dimension of the image. This constant is used by functions that are templated over image type (as opposed to being templated over pixel type and dimension) when they need compile time access to the dimension of the image.

Definition at line 138 of file itkImageBase.h.

◆ m_BufferedRegion

template<unsigned int VImageDimension = 2>

RegionType itk::ImageBase< VImageDimension >::m_BufferedRegion {}

private

Definition at line 935 of file itkImageBase.h.

◆ m_Direction

template<unsigned int VImageDimension = 2>

DirectionType itk::ImageBase< VImageDimension >::m_Direction { DirectionType::GetIdentity() }

protected

Origin, spacing, and direction in physical coordinates. This variables are protected for efficiency. They are referenced frequently by inner loop calculations.

Definition at line 869 of file itkImageBase.h.

◆ m_IndexToPhysicalPoint

template<unsigned int VImageDimension = 2>

DirectionType itk::ImageBase< VImageDimension >::m_IndexToPhysicalPoint { DirectionType::GetIdentity() }

protected

Matrices intended to help with the conversion of Index coordinates to PhysicalPoint coordinates

Definition at line 875 of file itkImageBase.h.

◆ m_InverseDirection

template<unsigned int VImageDimension = 2>

DirectionType itk::ImageBase< VImageDimension >::m_InverseDirection { DirectionType::GetIdentity() }

protected

Origin, spacing, and direction in physical coordinates. This variables are protected for efficiency. They are referenced frequently by inner loop calculations.

Definition at line 870 of file itkImageBase.h.

◆ m_LargestPossibleRegion

template<unsigned int VImageDimension = 2>

RegionType itk::ImageBase< VImageDimension >::m_LargestPossibleRegion {}

private

Definition at line 933 of file itkImageBase.h.

◆ m_OffsetTable

template<unsigned int VImageDimension = 2>

OffsetValueType itk::ImageBase< VImageDimension >::m_OffsetTable[VImageDimension+1] {}

private

Definition at line 931 of file itkImageBase.h.

◆ m_Origin

template<unsigned int VImageDimension = 2>

PointType itk::ImageBase< VImageDimension >::m_Origin {}

protected

Origin, spacing, and direction in physical coordinates. This variables are protected for efficiency. They are referenced frequently by inner loop calculations.

Definition at line 868 of file itkImageBase.h.

◆ m_PhysicalPointToIndex

template<unsigned int VImageDimension = 2>

DirectionType itk::ImageBase< VImageDimension >::m_PhysicalPointToIndex { DirectionType::GetIdentity() }

protected

Matrices intended to help with the conversion of Index coordinates to PhysicalPoint coordinates

Definition at line 876 of file itkImageBase.h.

◆ m_RequestedRegion

template<unsigned int VImageDimension = 2>

RegionType itk::ImageBase< VImageDimension >::m_RequestedRegion {}

private

Definition at line 934 of file itkImageBase.h.

◆ m_Spacing

template<unsigned int VImageDimension = 2>

SpacingType itk::ImageBase< VImageDimension >::m_Spacing { MakeFilled<SpacingType>(1.0) }

protected

Origin, spacing, and direction in physical coordinates. This variables are protected for efficiency. They are referenced frequently by inner loop calculations.

Definition at line 867 of file itkImageBase.h.

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

itkImageBase.h

Detailed Description

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Private Attributes

Member Typedef Documentation

◆ ConstPointer

◆ DirectionType

◆ ImageDimensionType

◆ IndexType

◆ IndexValueType

◆ OffsetType

◆ OffsetValueType

◆ Pointer

◆ PointType

◆ PointValueType

◆ RegionType

◆ Self

◆ SizeType

◆ SizeValueType

◆ SpacingType

◆ SpacingValueType

◆ Superclass

Constructor & Destructor Documentation

◆ ImageBase()

◆ ~ImageBase()

Member Function Documentation

◆ Allocate()

◆ AllocateInitialized()

◆ ComputeIndex()

◆ ComputeIndexToPhysicalPointMatrices()

◆ ComputeOffset()

◆ ComputeOffsetTable()

◆ CopyInformation()

◆ FastComputeIndex()

◆ FastComputeOffset()

◆ GetBufferedRegion()

◆ GetDirection()

◆ GetImageDimension()

◆ GetInverseDirection()

◆ GetLargestPossibleRegion()

◆ GetNameOfClass()

◆ GetNumberOfComponentsPerPixel()

returned from NumericTraits for the pixel type, and VectorImage

◆ GetOffsetTable()

◆ GetOrigin()

◆ GetRequestedRegion()

◆ GetSpacing()

◆ Graft() [1/2]

◆ Graft() [2/2]

◆ Initialize()

◆ InitializeBufferedRegion()

◆ IsCongruentImageGeometry()

◆ IsSameImageGeometryAs()

◆ New()

◆ PrintSelf()

◆ RequestedRegionIsOutsideOfTheBufferedRegion()

◆ SetBufferedRegion()

◆ SetDirection()

◆ SetLargestPossibleRegion()

◆ SetNumberOfComponentsPerPixel()

returned from NumericTraits for the pixel type, and VectorImage

◆ SetOrigin() [1/3]

◆ SetOrigin() [2/3]

◆ SetOrigin() [3/3]

◆ SetRegions() [1/2]

◆ SetRegions() [2/2]

◆ SetRequestedRegion() [1/2]

◆ SetRequestedRegion() [2/2]

◆ SetRequestedRegionToLargestPossibleRegion()

◆ SetSpacing() [1/3]

◆ SetSpacing() [2/3]

◆ SetSpacing() [3/3]

◆ TransformContinuousIndexToPhysicalPoint() [1/2]

◆ TransformContinuousIndexToPhysicalPoint() [2/2]

◆ TransformIndexToPhysicalPoint() [1/2]

◆ TransformIndexToPhysicalPoint() [2/2]