Field3D
Field< Data_T >::const_iterator Class Referenceabstract

#include <Field.h>

Inheritance diagram for Field< Data_T >::const_iterator:
FieldRes FieldBase RefBase MetadataCallback

Public Types

typedef Field< Data_T > class_type
 
typedef boost::intrusive_ptr< FieldPtr
 
typedef Data_T value_type
 Allows us to reference the template class.
 
typedef std::vector< PtrVec
 This is a convenience typedef for the list that Field3DInputFile::readScalarLayers() and Field3DInputFile::readVectorLayers() will return its data in.
 
- Public Types inherited from FieldRes
typedef FieldRes class_type
 
typedef boost::intrusive_ptr< FieldResPtr
 
typedef std::vector< PtrVec
 
- Public Types inherited from FieldBase
typedef FieldBase class_type
 
typedef boost::intrusive_ptr< FieldBasePtr
 
- Public Types inherited from RefBase
typedef boost::intrusive_ptr< RefBasePtr
 
typedef boost::weak_ptr< RefBaseWeakPtr
 

Public Member Functions

const_iterator cbegin () const
 Const iterator to first element. "cbegin" matches the tr1 c++ standard.
 
const_iterator cbegin (const Box3i &subset) const
 Const iterator to first element of specific subset.
 
const_iterator cend () const
 Const iterator pointing one element past the last valid one.
 
const_iterator cend (const Box3i &subset) const
 Const iterator pointing one element past the last valid one (for a subset)
 
 const_iterator (const const_iterator &i)
 
 const_iterator (const Field< Data_T > &field, const Box3i &window, const V3i &currentPos)
 
virtual std::string dataTypeString () const
 
template<class Iter_T>
bool operator!= (const Iter_T &rhs) const
 
Data_T operator* () const
 
const const_iteratoroperator++ ()
 
template<class Iter_T>
bool operator== (const Iter_T &rhs) const
 
virtual Data_T value (int i, int j, int k) const=0
 Read access to a voxel. The coordinates are in integer voxel space .
 
virtual ~Field ()
 Dtor.
 
- Public Member Functions inherited from FieldRes
V3i const dataResolution () const
 
const Box3idataWindow () const
 Returns the data window. Any coordinate inside this window is safe to pass to value() in the Field subclass.
 
const Box3iextents () const
 Returns the extents of the data. This signifies the relevant area that the data exists over. However, the data window (below) may be smaller than the extents, in which case it is only safe to call value() for those coordinate inside the data window.
 
 FieldRes ()
 This constructor ensures that we have a valid mapping at all times.
 
 FieldRes (const FieldRes &src)
 Base class copy constructor.
 
bool isInBounds (int i, int j, int k) const
 Returns true is the indicies are in bounds of the data window.
 
FieldMapping::Ptr mapping ()
 Returns a pointer to the mapping.
 
const FieldMapping::Ptr mapping () const
 Returns a pointer to the mapping.
 
virtual void mappingChanged ()
 Tells the subclass that the mapping changed.
 
virtual long long int memSize () const
 Returns the memory usage (in bytes)
 
void setMapping (FieldMapping::Ptr mapping)
 Sets the field's mapping.
 
virtual size_t voxelCount () const
 Counts the number of voxels. For most fields, this is just the volume of the data window, but sparse data structures can override this to return a better value.
 
- Public Member Functions inherited from FieldBase
 FieldBase ()
 Constructor.
 
 FieldBase (const FieldBase &)
 Copy Constructor.
 
virtual ~FieldBase ()
 Destructor.
 
virtual std::string className () const =0
 Returns the class name of the object. Used by the class pool and when writing the data to disk.
 
virtual std::string classType () const =0
 Returns the full class type string.
 
virtual Ptr clone () const =0
 Returns a pointer to a copy of the field, pure virtual so ensure derived classes properly implement it.
 
FieldMetadatametadata ()
 accessor to the m_metadata class
 
const FieldMetadatametadata () const
 Read only access to the m_metadata class.
 
void copyMetadata (const FieldBase &field)
 Copies the metadata from a second field.
 
- Public Member Functions inherited from RefBase
void ref () const
 Used by boost::intrusive_pointer.
 
size_t refcnt ()
 Used by boost::intrusive_pointer.
 
void unref () const
 Used by boost::intrusive_pointer.
 
WeakPtr weakPtr () const
 
 RefBase ()
 
 RefBase (const RefBase &)
 Copy constructor.
 
RefBaseoperator= (const RefBase &)
 Assignment operator.
 
virtual ~RefBase ()
 Destructor.
 
virtual bool checkRTTI (const char *typenameStr)=0
 This function is only implemented by concrete classes and triggers the actual RTTI check through matchRTTI();.
 
bool matchRTTI (const char *typenameStr)
 Performs a check to see if the given typename string matches this class' This needs to be implemented in -all- subclasses, even abstract ones.
 
- Public Member Functions inherited from MetadataCallback
virtual void metadataHasChanged (const std::string &)
 Alerts the callback holder that the metadata has changed.
 

Static Public Member Functions

static const char * staticClassName ()
 
static const char * staticClassType ()
 
- Static Public Member Functions inherited from FieldRes
static const char * staticClassName ()
 
static const char * staticClassType ()
 
- Static Public Member Functions inherited from FieldBase
static const char * staticClassName ()
 
static const char * staticClassType ()
 
static const char * staticClassType ()
 

Public Attributes

 DEFINE_FIELD_RTTI_ABSTRACT_CLASS
 
int x
 Current position.
 
int y
 
int z
 
- Public Attributes inherited from FieldRes
 DEFINE_FIELD_RTTI_ABSTRACT_CLASS
 
- Public Attributes inherited from FieldBase
std::string attribute
 Optional name of the attribute the field represents.
 
std::string name
 Optional name of the field.
 

Private Types

typedef FieldRes base
 Convenience typedef for referring to base class.
 

Private Attributes

const Field< Data_T > & m_field
 Reference to field being iterated over.
 
Box3i m_window
 Window to traverse.
 

Static Private Attributes

static TemplatedFieldType< Field< Data_T > > ms_classType
 

Additional Inherited Members

- Protected Types inherited from FieldRes
typedef MatrixFieldMapping default_mapping
 
- Protected Attributes inherited from FieldRes
Box3i m_dataWindow
 Defines the area where data is allocated. This should be treated as a closed (i.e. inclusive) interval.
 
Box3i m_extents
 Defines the extents of the the storage. This may be larger or smaller than the data window, and in the case where it is larger, care must be taken not to access voxels outside the data window. This should be treated as a closed (i.e. inclusive) interval.
 
FieldMapping::Ptr m_mapping
 Pointer to the field's mapping.
 

Detailed Description

template<class Data_T>
class Field< Data_T >::const_iterator

Definition at line 491 of file Field.h.

Member Typedef Documentation

◆ Ptr

typedef boost::intrusive_ptr<Field> Field< Data_T >::Ptr

Definition at line 395 of file Field.h.

◆ value_type

typedef Data_T Field< Data_T >::value_type

Allows us to reference the template class.

Definition at line 398 of file Field.h.

◆ Vec

typedef std::vector<Ptr> Field< Data_T >::Vec

This is a convenience typedef for the list that Field3DInputFile::readScalarLayers() and Field3DInputFile::readVectorLayers() will return its data in.

Definition at line 403 of file Field.h.

◆ class_type

typedef Field<Data_T> Field< Data_T >::class_type

Definition at line 407 of file Field.h.

◆ base

typedef FieldRes Field< Data_T >::base
private

Convenience typedef for referring to base class.

Definition at line 467 of file Field.h.

Constructor & Destructor Documentation

◆ const_iterator() [1/2]

template<class Data_T>
Field< Data_T >::const_iterator::const_iterator ( const const_iterator & i)
inline

Definition at line 506 of file Field.h.

507 : x(i.x), y(i.y), z(i.z),
508 m_window(i.m_window), m_field(i.m_field)
509 { }
int x
Current position.
Definition Field.h:552
const Field< Data_T > & m_field
Reference to field being iterated over.
Definition Field.h:561
Box3i m_window
Window to traverse.
Definition Field.h:559
Definition Field.h:390

References const_iterator(), m_field, m_window, x, y, and z.

Referenced by const_iterator(), and operator++().

◆ const_iterator() [2/2]

template<class Data_T>
Field< Data_T >::const_iterator::const_iterator ( const Field< Data_T > & field,
const Box3i & window,
const V3i & currentPos )
inline

Definition at line 511 of file Field.h.

513 : x(currentPos.x), y(currentPos.y), z(currentPos.z),
515 { }

References m_field, m_window, x, y, and z.

◆ ~Field()

virtual Field< Data_T >::~Field ( )
inlinevirtual

Dtor.

Definition at line 423 of file Field.h.

424 { /* Empty */ }

Member Function Documentation

◆ operator++()

template<class Data_T>
const const_iterator & Field< Data_T >::const_iterator::operator++ ( )
inline

Definition at line 519 of file Field.h.

520 {
521 if (x == m_window.max.x) {
522 if (y == m_window.max.y) {
523 x = m_window.min.x;
524 y = m_window.min.y;
525 ++z;
526 } else {
527 x = m_window.min.x;
528 ++y;
529 }
530 } else {
531 ++x;
532 }
533 return *this;
534 }

References const_iterator(), m_window, x, y, and z.

◆ operator==()

template<class Data_T>
template<class Iter_T>
bool Field< Data_T >::const_iterator::operator== ( const Iter_T & rhs) const
inline

Definition at line 536 of file Field.h.

537 {
538 return x == rhs.x && y == rhs.y && z == rhs.z;
539 }

References x, y, and z.

◆ operator!=()

template<class Data_T>
template<class Iter_T>
bool Field< Data_T >::const_iterator::operator!= ( const Iter_T & rhs) const
inline

Definition at line 541 of file Field.h.

542 {
543 return x != rhs.x || y != rhs.y || z != rhs.z;
544 }

References x, y, and z.

◆ operator*()

template<class Data_T>
Data_T Field< Data_T >::const_iterator::operator* ( ) const
inline

Definition at line 545 of file Field.h.

546 {
547 return m_field.value(x, y, z);
548 }

References m_field, x, y, and z.

◆ staticClassName()

static const char * Field< Data_T >::staticClassName ( )
inlinestatic

Definition at line 410 of file Field.h.

411 {
412 return "Field";
413 }

◆ staticClassType()

static const char * Field< Data_T >::staticClassType ( )
inlinestatic

Definition at line 415 of file Field.h.

416 {
418 }
std::string name
Optional name of the field.
Definition Field.h:171

◆ cbegin() [1/2]

Field< Data_T >::const_iterator Field< Data_T >::cbegin ( ) const

Const iterator to first element. "cbegin" matches the tr1 c++ standard.

Definition at line 433 of file Field.h.

570{
571 if (FieldRes::dataResolution() == V3i(0))
572 return cend();
573 return const_iterator(*this, m_dataWindow, m_dataWindow.min);
574}
Imath::V3i V3i
Definition SpiMathLib.h:71
Box3i m_dataWindow
Defines the area where data is allocated. This should be treated as a closed (i.e....
Definition Field.h:310
const_iterator(const const_iterator &i)
Definition Field.h:506
const_iterator cend() const
Definition Field.h:591

◆ cbegin() [2/2]

Field< Data_T >::const_iterator Field< Data_T >::cbegin ( const Box3i & subset) const

Const iterator to first element of specific subset.

Definition at line 435 of file Field.h.

581{
582 if (subset.isEmpty())
583 return cend(subset);
584 return const_iterator(*this, subset, subset.min);
585}

◆ cend() [1/2]

Field< Data_T >::const_iterator Field< Data_T >::cend ( ) const

Const iterator pointing one element past the last valid one.

Definition at line 437 of file Field.h.

592{
593 return const_iterator(*this, m_dataWindow,
594 V3i(m_dataWindow.min.x,
595 m_dataWindow.min.y,
596 m_dataWindow.max.z + 1));
597}

◆ cend() [2/2]

Field< Data_T >::const_iterator Field< Data_T >::cend ( const Box3i & subset) const

Const iterator pointing one element past the last valid one (for a subset)

Definition at line 440 of file Field.h.

604{
605 return const_iterator(*this, subset, V3i(subset.min.x,
606 subset.min.y,
607 subset.max.z + 1));
608}

◆ value()

virtual Data_T Field< Data_T >::value ( int i,
int j,
int k ) const
pure virtual

Read access to a voxel. The coordinates are in integer voxel space .

Note
Before the internal storage is accessed, the subclass must compute the data window coordinates by looking at Field::m_dataWindow.
Virtual functions are known not to play nice with threading. Therefor, concrete classes can implement (by convention) fastValue() as a non-virtual function.

◆ dataTypeString()

virtual std::string Field< Data_T >::dataTypeString ( ) const
inlinevirtual

Reimplemented from FieldRes.

Definition at line 454 of file Field.h.

455 { return DataTypeTraits<Data_T>::name(); }
static std::string name()
Definition Traits.h:267

Member Data Documentation

◆ x

template<class Data_T>
int Field< Data_T >::const_iterator::x

Current position.

Definition at line 552 of file Field.h.

Referenced by const_iterator(), const_iterator(), operator!=(), operator*(), operator++(), and operator==().

◆ y

template<class Data_T>
int Field< Data_T >::const_iterator::y

Definition at line 552 of file Field.h.

Referenced by const_iterator(), const_iterator(), operator!=(), operator*(), operator++(), and operator==().

◆ z

template<class Data_T>
int Field< Data_T >::const_iterator::z

Definition at line 552 of file Field.h.

Referenced by const_iterator(), const_iterator(), operator!=(), operator*(), operator++(), and operator==().

◆ m_window

template<class Data_T>
Box3i Field< Data_T >::const_iterator::m_window
private

Window to traverse.

Definition at line 559 of file Field.h.

Referenced by const_iterator(), const_iterator(), and operator++().

◆ m_field

template<class Data_T>
const Field<Data_T>& Field< Data_T >::const_iterator::m_field
private

Reference to field being iterated over.

Definition at line 561 of file Field.h.

Referenced by const_iterator(), const_iterator(), and operator*().

◆ DEFINE_FIELD_RTTI_ABSTRACT_CLASS

Field< Data_T >::DEFINE_FIELD_RTTI_ABSTRACT_CLASS

Definition at line 408 of file Field.h.

◆ ms_classType

TemplatedFieldType<Field<Data_T> > Field< Data_T >::ms_classType
staticprivate

Definition at line 462 of file Field.h.


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