#include <itkIndexRange.h>

Classes
class	const_iterator

Public Types
using	const_reverse_iterator = std::reverse_iterator< const_iterator >

using	IndexType = Index< VDimension >

using	iterator = const_iterator

using	reverse_iterator = std::reverse_iterator< iterator >

using	SizeType = Size< VDimension >

Public Member Functions
	IndexRange ()=default

	IndexRange (const SizeType &gridSize)

Static Public Attributes
constexpr static unsigned	Dimension = VDimension

using	MinIndexType = typename iterator::MinIndexType

MinIndexType	m_MinIndex = MinIndexType()

IndexType	m_MaxIndex = IndexType::Filled(-1)

template<bool VIsSubstitutionFailure = VBeginAtZero, typename TVoid = typename std::enable_if<!VIsSubstitutionFailure>::type>
	IndexRange (const ImageRegion< VDimension > &imageRegion)

iterator	begin () const noexcept

iterator	end () const noexcept

const_iterator	cbegin () const noexcept

const_iterator	cend () const noexcept

reverse_iterator	rbegin () const noexcept

reverse_iterator	rend () const noexcept

const_reverse_iterator	crbegin () const noexcept

const_reverse_iterator	crend () const noexcept

std::vcl_size_t	size () const noexcept

bool	empty () const noexcept

static IndexType	CalculateMaxIndex (const MinIndexType &minIndex, const SizeType &size)

Detailed Description

template<unsigned VDimension, bool VBeginAtZero>
class itk::Experimental::IndexRange< VDimension, VBeginAtZero >

Modern C++11 range, supporting efficient iteration over the indices of an image grid space.

The following example prints all indices of an 2-D grid space of size 2x3.

constexpr unsigned Dimension = 2;
const Size<Dimension> size = { {2, 3} };
const ZeroBasedIndexRange<Dimension> indexRange{ size };
 
for (const Index<Dimension> index : indexRange)
{
  std::cout << index;
}
// Output: "[0, 0][1, 0][0, 1][1, 1][0, 2][1, 2]"

The indices from IndexRange can also be used as consecutive locations of a ShapedImageNeighborhoodRange, for example:

for (const auto index : indexRange)
{
  shapedImageNeighborhoodRange.SetLocation(index);
 
  for (const PixelType neighborPixel : shapedImageNeighborhoodRange)
  {
    // Process neighbor pixel...
  }
}

IndexRange is designed to conform to Standard C++ Iterator requirements, so that it can be used in range-based for loop, and its iterators can be passed to Standard C++ algorithms.

Author: Niels Dekker, LKEB, Leiden University Medical Center

See also: ShapedImageNeighborhoodRange

Definition at line 80 of file itkIndexRange.h.

Member Typedef Documentation

◆ const_reverse_iterator

template<unsigned VDimension, bool VBeginAtZero>

using itk::Experimental::IndexRange< VDimension, VBeginAtZero >::const_reverse_iterator = std::reverse_iterator<const_iterator>

Definition at line 295 of file itkIndexRange.h.

◆ IndexType

template<unsigned VDimension, bool VBeginAtZero>

using itk::Experimental::IndexRange< VDimension, VBeginAtZero >::IndexType = Index<VDimension>

Definition at line 85 of file itkIndexRange.h.

◆ iterator

template<unsigned VDimension, bool VBeginAtZero>

using itk::Experimental::IndexRange< VDimension, VBeginAtZero >::iterator = const_iterator

Definition at line 293 of file itkIndexRange.h.

◆ MinIndexType

template<unsigned VDimension, bool VBeginAtZero>

using itk::Experimental::IndexRange< VDimension, VBeginAtZero >::MinIndexType = typename iterator::MinIndexType

private

Constructs a range of indices for the specified image region.

Note: This function is unavailable when VBeginAtZero is true (in case there is a substitution failure, and C++ "SFINAE" kicks in).

Definition at line 425 of file itkIndexRange.h.

◆ reverse_iterator

template<unsigned VDimension, bool VBeginAtZero>

using itk::Experimental::IndexRange< VDimension, VBeginAtZero >::reverse_iterator = std::reverse_iterator<iterator>

Definition at line 294 of file itkIndexRange.h.

◆ SizeType

template<unsigned VDimension, bool VBeginAtZero>

using itk::Experimental::IndexRange< VDimension, VBeginAtZero >::SizeType = Size<VDimension>

Definition at line 84 of file itkIndexRange.h.

Constructor & Destructor Documentation

◆ IndexRange() [1/3]

template<unsigned VDimension, bool VBeginAtZero>

itk::Experimental::IndexRange< VDimension, VBeginAtZero >::IndexRange ( )

default

Explicitly defaulted default-constructor. Constructs an empty range.

Note: The other five "special member functions" (copy-constructor, copy-assignment operator, move-constructor, move-assignment operator, and destructor) are implicitly defaulted, following the C++ "Rule of Zero".

◆ IndexRange() [2/3]

template<unsigned VDimension, bool VBeginAtZero>

itk::Experimental::IndexRange< VDimension, VBeginAtZero >::IndexRange ( const SizeType & gridSize )

inlineexplicit

Constructs a range of indices for the specified grid size.

Definition at line 307 of file itkIndexRange.h.

◆ IndexRange() [3/3]

template<unsigned VDimension, bool VBeginAtZero>

template<bool VIsSubstitutionFailure = VBeginAtZero, typename TVoid = typename std::enable_if<!VIsSubstitutionFailure>::type>

itk::Experimental::IndexRange< VDimension, VBeginAtZero >::IndexRange ( const ImageRegion< VDimension > & imageRegion )

inlineexplicit

Constructs a range of indices for the specified image region.

Note: This function is unavailable when VBeginAtZero is true (in case there is a substitution failure, and C++ "SFINAE" kicks in).

Definition at line 321 of file itkIndexRange.h.

Member Function Documentation

◆ begin()

template<unsigned VDimension, bool VBeginAtZero>

iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::begin ( ) const

inlinenoexcept

Returns an iterator to the first index.

Definition at line 339 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MaxIndex, and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MinIndex.

Referenced by itk::Experimental::IndexRange< VDimension, VBeginAtZero >::cbegin(), and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::rend().

◆ CalculateMaxIndex()

template<unsigned VDimension, bool VBeginAtZero>

static IndexType itk::Experimental::IndexRange< VDimension, VBeginAtZero >::CalculateMaxIndex	(	const MinIndexType &	minIndex,
		const SizeType &	size
	)

inlinestaticprivate

Constructs a range of indices for the specified image region.

Note: This function is unavailable when VBeginAtZero is true (in case there is a substitution failure, and C++ "SFINAE" kicks in).

Definition at line 428 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::size().

◆ cbegin()

template<unsigned VDimension, bool VBeginAtZero>

const_iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::cbegin ( ) const

inlinenoexcept

Returns a const iterator to the first index. Provides only read-only access to the index data.

Definition at line 357 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::begin().

◆ cend()

template<unsigned VDimension, bool VBeginAtZero>

const_iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::cend ( ) const

inlinenoexcept

Returns a const 'end iterator' for this range.

Definition at line 364 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::end().

◆ crbegin()

template<unsigned VDimension, bool VBeginAtZero>

const_reverse_iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::crbegin ( ) const

inlinenoexcept

Returns a const reverse 'begin iterator' for this range.

Definition at line 385 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::rbegin().

◆ crend()

template<unsigned VDimension, bool VBeginAtZero>

const_reverse_iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::crend ( ) const

inlinenoexcept

Returns a const reverse 'end iterator' for this range.

Definition at line 392 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::rend().

◆ empty()

template<unsigned VDimension, bool VBeginAtZero>

bool itk::Experimental::IndexRange< VDimension, VBeginAtZero >::empty ( ) const

inlinenoexcept

Tells whether the range is empty.

Definition at line 414 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MaxIndex, and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MinIndex.

◆ end()

template<unsigned VDimension, bool VBeginAtZero>

iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::end ( ) const

inlinenoexcept

Returns an 'end iterator' for this range.

Definition at line 346 of file itkIndexRange.h.

References itk::Index< VDimension >::back(), itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MaxIndex, and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MinIndex.

Referenced by itk::Experimental::IndexRange< VDimension, VBeginAtZero >::cend(), and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::rbegin().

◆ rbegin()

template<unsigned VDimension, bool VBeginAtZero>

reverse_iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::rbegin ( ) const

inlinenoexcept

Returns a reverse 'begin iterator' for this range.

Definition at line 371 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::end().

Referenced by itk::Experimental::IndexRange< VDimension, VBeginAtZero >::crbegin().

◆ rend()

template<unsigned VDimension, bool VBeginAtZero>

reverse_iterator itk::Experimental::IndexRange< VDimension, VBeginAtZero >::rend ( ) const

inlinenoexcept

Returns a reverse 'end iterator' for this range.

Definition at line 378 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::begin().

Referenced by itk::Experimental::IndexRange< VDimension, VBeginAtZero >::crend().

◆ size()

template<unsigned VDimension, bool VBeginAtZero>

std::vcl_size_t itk::Experimental::IndexRange< VDimension, VBeginAtZero >::size ( ) const

inlinenoexcept

Returns the size of the range, that is the number of indices.

Definition at line 400 of file itkIndexRange.h.

References itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MaxIndex, and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MinIndex.

Referenced by itk::Experimental::IndexRange< VDimension, VBeginAtZero >::CalculateMaxIndex().

Member Data Documentation

◆ Dimension

template<unsigned VDimension, bool VBeginAtZero>

constexpr static unsigned itk::Experimental::IndexRange< VDimension, VBeginAtZero >::Dimension = VDimension

staticconstexpr

Definition at line 83 of file itkIndexRange.h.

◆ m_MaxIndex

template<unsigned VDimension, bool VBeginAtZero>

IndexType itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MaxIndex = IndexType::Filled(-1)

private

Constructs a range of indices for the specified image region.

Note: This function is unavailable when VBeginAtZero is true (in case there is a substitution failure, and C++ "SFINAE" kicks in).

Definition at line 460 of file itkIndexRange.h.

Referenced by itk::Experimental::IndexRange< VDimension, VBeginAtZero >::begin(), itk::Experimental::IndexRange< VDimension, VBeginAtZero >::empty(), itk::Experimental::IndexRange< VDimension, VBeginAtZero >::end(), and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::size().

◆ m_MinIndex

template<unsigned VDimension, bool VBeginAtZero>

MinIndexType itk::Experimental::IndexRange< VDimension, VBeginAtZero >::m_MinIndex = MinIndexType()

private

Constructs a range of indices for the specified image region.

Note: This function is unavailable when VBeginAtZero is true (in case there is a substitution failure, and C++ "SFINAE" kicks in).

Definition at line 457 of file itkIndexRange.h.

Referenced by itk::Experimental::IndexRange< VDimension, VBeginAtZero >::begin(), itk::Experimental::IndexRange< VDimension, VBeginAtZero >::empty(), itk::Experimental::IndexRange< VDimension, VBeginAtZero >::end(), and itk::Experimental::IndexRange< VDimension, VBeginAtZero >::size().

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

itkIndexRange.h

Classes

Public Types

Public Member Functions

Static Public Attributes

Detailed Description

template<unsigned VDimension, bool VBeginAtZero> class itk::Experimental::IndexRange< VDimension, VBeginAtZero >

Member Typedef Documentation

◆ const_reverse_iterator

◆ IndexType

◆ iterator

◆ MinIndexType

◆ reverse_iterator

◆ SizeType

Constructor & Destructor Documentation

◆ IndexRange() [1/3]

◆ IndexRange() [2/3]

◆ IndexRange() [3/3]

Member Function Documentation

◆ begin()

◆ CalculateMaxIndex()

◆ cbegin()

◆ cend()

◆ crbegin()

◆ crend()

◆ empty()

◆ end()

◆ rbegin()

◆ rend()

◆ size()

Member Data Documentation

◆ Dimension

◆ m_MaxIndex

◆ m_MinIndex

template<unsigned VDimension, bool VBeginAtZero>
class itk::Experimental::IndexRange< VDimension, VBeginAtZero >