Main Page   Groups   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Concepts
Public Types | Public Member Functions | Static Public Member Functions | Public Attributes

itk::Index< VIndexDimension > Class Template Reference
[Image Access ObjectsImage Representation Objects]

Represent a n-dimensional index in a n-dimensional image. More...

#include <itkIndex.h>

Inheritance diagram for itk::Index< VIndexDimension >:
Inheritance graph
[legend]

List of all members.

Public Types

typedef Index< VIndexDimension > IndexType
typedef long IndexValueType
typedef
Functor::IndexLexicographicCompare
< VIndexDimension > 
LexicographicCompare
typedef Offset< VIndexDimension > OffsetType
typedef OffsetType::OffsetValueType OffsetValueType
typedef Index Self
typedef Size< VIndexDimension > SizeType

Public Member Functions

void Fill (IndexValueType value)
IndexValueType GetElement (unsigned long element) const
const IndexValueTypeGetIndex () const
IndexValueType operator[] (unsigned int dim) const
IndexValueTypeoperator[] (unsigned int dim)
void SetElement (unsigned long element, IndexValueType val)
void SetIndex (const IndexValueType val[VIndexDimension])

const Self operator+ (const SizeType &size) const

const Selfoperator+= (const SizeType &size)

const Self operator- (const SizeType &size) const

const Selfoperator-= (const SizeType &size)

const Self operator+ (const OffsetType &offset) const

const Selfoperator+= (const OffsetType &offset)

const Selfoperator-= (const OffsetType &offset)

const Self operator- (const OffsetType &off) const

const OffsetType operator- (const Self &vec) const

const Self operator* (const SizeType &vec) const

bool operator== (const Self &vec) const

bool operator!= (const Self &vec) const

template<class TCoordRep >
void CopyWithRound (const FixedArray< TCoordRep, VIndexDimension > &point)

template<class TCoordRep >
void CopyWithCast (const FixedArray< TCoordRep, VIndexDimension > &point)

Static Public Member Functions

static Self GetBasisIndex (unsigned int dim)
static unsigned int GetIndexDimension ()

Public Attributes

IndexValueType m_Index [VIndexDimension]

Detailed Description

template<unsigned int VIndexDimension = 2>
class itk::Index< VIndexDimension >

Represent a n-dimensional index in a n-dimensional image.

Index is a templated class to represent a multi-dimensional index, i.e. (i,j,k,...). Index is templated over the dimension of the index. ITK assumes the first element of an index is the fastest moving index.

For efficiency sake, Index does not define a default constructor, a copy constructor, or an operator=. We rely on the compiler to provide efficient bitwise copies.

Index is an "aggregate" class. Its data is public (m_Index) allowing for fast and convenient instantiations/assignments.

The following syntax for assigning an index is allowed/suggested:

Index<3> index = {{5, 2, 7}};

The double braces {{ and }} are needed to prevent a compiler warning about a partly bracketed initializer.

Remarks:
Should there be an itkBoundedIndex to handle bounds checking? Or should there be an API to perform bounded increments in the iterator.
Examples:

Common/itkImageSliceIteratorTest.cxx.

Definition at line 68 of file itkIndex.h.


Member Typedef Documentation

template<unsigned int VIndexDimension = 2>
typedef Index<VIndexDimension> itk::Index< VIndexDimension >::IndexType

Compatible Index and value typedef

Definition at line 74 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
typedef long itk::Index< VIndexDimension >::IndexValueType

Definition at line 75 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
typedef Functor::IndexLexicographicCompare<VIndexDimension> itk::Index< VIndexDimension >::LexicographicCompare

Lexicographic ordering functor type.

Definition at line 88 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
typedef Offset<VIndexDimension> itk::Index< VIndexDimension >::OffsetType

Compatible Offset and Offset value typedef.

Definition at line 84 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
typedef OffsetType::OffsetValueType itk::Index< VIndexDimension >::OffsetValueType

Definition at line 85 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
typedef Index itk::Index< VIndexDimension >::Self

Standard class typedefs.

Definition at line 71 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
typedef Size<VIndexDimension> itk::Index< VIndexDimension >::SizeType

Compatible Size typedef.

Definition at line 81 of file itkIndex.h.


Member Function Documentation

template<unsigned int VIndexDimension = 2>
template<class TCoordRep >
void itk::Index< VIndexDimension >::CopyWithCast ( const FixedArray< TCoordRep, VIndexDimension > &  point  )  [inline]

Copy values from a FixedArray by casting each one of the components

Definition at line 293 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
template<class TCoordRep >
void itk::Index< VIndexDimension >::CopyWithRound ( const FixedArray< TCoordRep, VIndexDimension > &  point  )  [inline]

Copy values from a FixedArray by rounding each one of the components

Definition at line 278 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
void itk::Index< VIndexDimension >::Fill ( IndexValueType  value  )  [inline]

Set one value for the index in all dimensions. Useful for initializing an offset to zero.

Definition at line 266 of file itkIndex.h.

Referenced by itk::ImageIORegionAdaptor< VDimension >::Convert().

template<unsigned int VIndexDimension>
Index< VIndexDimension > itk::Index< VIndexDimension >::GetBasisIndex ( unsigned int  dim  )  [static]

Return a basis vector of the form [0, ..., 0, 1, 0, ... 0] where the "1" is positioned in the location specified by the parameter "dim". Valid values of "dim" are 0, ..., VIndexDimension-1.

Definition at line 346 of file itkIndex.h.

References itk::Index< VIndexDimension >::m_Index.

template<unsigned int VIndexDimension = 2>
IndexValueType itk::Index< VIndexDimension >::GetElement ( unsigned long  element  )  const [inline]

Gets the value of one of the elements in the index. This method is mainly intended to facilitate the access to elements from Tcl and Python where C++ notation is not very convenient.

Warning:
No bound checking is performed
See also:
GetIndex()
SetElement()

Definition at line 256 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const IndexValueType* itk::Index< VIndexDimension >::GetIndex ( void   )  const [inline]

Get the index. This provides a read only reference to the index.

See also:
SetIndex()

Definition at line 232 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
static unsigned int itk::Index< VIndexDimension >::GetIndexDimension (  )  [inline, static]

Get the dimension (size) of the index.

Definition at line 78 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
bool itk::Index< VIndexDimension >::operator!= ( const Self vec  )  const [inline]

Compare two indices.

Definition at line 210 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self itk::Index< VIndexDimension >::operator* ( const SizeType vec  )  const [inline]

Multiply an index by a size (elementwise product). This method models a random access Index.

Definition at line 188 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self itk::Index< VIndexDimension >::operator+ ( const SizeType size  )  const [inline]

Add a size to an index. This method models a random access Index.

Definition at line 92 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self itk::Index< VIndexDimension >::operator+ ( const OffsetType offset  )  const [inline]

Add an offset to an index.

Definition at line 134 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self& itk::Index< VIndexDimension >::operator+= ( const SizeType size  )  [inline]

Increment index by a size. This method models a random access Index.

Definition at line 103 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self& itk::Index< VIndexDimension >::operator+= ( const OffsetType offset  )  [inline]

Increment index by an offset. This method models a random access Index.

Definition at line 145 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self itk::Index< VIndexDimension >::operator- ( const SizeType size  )  const [inline]

Subtract a size from an index. This method models a random access Index.

Definition at line 113 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self itk::Index< VIndexDimension >::operator- ( const OffsetType off  )  const [inline]

Subtract an offset from an index.

Definition at line 165 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const OffsetType itk::Index< VIndexDimension >::operator- ( const Self vec  )  const [inline]

Subtract two indices. This method models a random access Index.

Definition at line 176 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self& itk::Index< VIndexDimension >::operator-= ( const OffsetType offset  )  [inline]

Decrement index by an offset. This method models a random access Index.

Definition at line 155 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
const Self& itk::Index< VIndexDimension >::operator-= ( const SizeType size  )  [inline]

Decrement index by a size. This method models a random access Index.

Definition at line 124 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
bool itk::Index< VIndexDimension >::operator== ( const Self vec  )  const [inline]

Compare two indices.

Definition at line 199 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
IndexValueType itk::Index< VIndexDimension >::operator[] ( unsigned int  dim  )  const [inline]

Access an element of the index. Elements are numbered 0, ..., VIndexDimension-1. This version can only be an rvalue. No bounds checking is performed.

Definition at line 227 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
IndexValueType& itk::Index< VIndexDimension >::operator[] ( unsigned int  dim  )  [inline]

Access an element of the index. Elements are numbered 0, ..., VIndexDimension-1. No bounds checking is performed.

Definition at line 221 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
void itk::Index< VIndexDimension >::SetElement ( unsigned long  element,
IndexValueType  val 
) [inline]

Sets the value of one of the elements in the index. This method is mainly intended to facilitate the access to elements from Tcl and Python where C++ notation is not very convenient.

Warning:
No bound checking is performed
See also:
SetIndex()
GetElement()

Definition at line 247 of file itkIndex.h.

template<unsigned int VIndexDimension = 2>
void itk::Index< VIndexDimension >::SetIndex ( const IndexValueType  val[VIndexDimension]  )  [inline]

Set the index. Try to prototype this function so that val has to point to a block of memory that is the appropriate size.

See also:
GetIndex()

Definition at line 238 of file itkIndex.h.


Member Data Documentation

template<unsigned int VIndexDimension = 2>
IndexValueType itk::Index< VIndexDimension >::m_Index[VIndexDimension]

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

Generated at Mon Jul 12 2010 23:26:42 for ITK by doxygen 1.7.1 written by Dimitri van Heesch, © 1997-2000