Field3D
MIPBase< Data_T > Class Template Referenceabstract

#include <MIPBase.h>

Inheritance diagram for MIPBase< Data_T >:
Field< Data_T > FieldRes FieldBase RefBase

Public Types

typedef MIPBase< Data_T > class_type
 
typedef boost::intrusive_ptr< MIPBasePtr
 
- Public Types inherited from Field< Data_T >
typedef Field< Data_T > class_type
 
typedef boost::intrusive_ptr< FieldPtr
 
typedef Data_T value_type
 Allows us to reference the template class. More...
 
typedef std::vector< PtrVec
 This is a convenience typedef for the list that Field3DInputFile::readScalarLayers() and Field3DInputFile::readVectorLayers() will return its data in. More...
 
- 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

virtual void getVsMIPCoord (const V3f &vsP, const size_t level, V3f &outVsP) const =0
 Given a voxel space coordinate in the 0-level field, computes the coordinate in another level. More...
 
virtual bool levelLoaded (const size_t level) const =0
 Whether a given MIP level is loaded. More...
 
size_t lowestLevel () const
 Lowest MIP level to use. More...
 
 MIPBase ()
 
virtual Field< Data_T >::Ptr mipLevel (const size_t level) const =0
 Returns a MIP level field. More...
 
virtual V3i mipResolution (size_t level) const =0
 Returns the resolution of a given MIP level. More...
 
virtual Data_T mipValue (size_t level, int i, int j, int k) const =0
 Read access to a voxel in a given MIP level. More...
 
size_t numLevels () const
 Number of MIP levels. More...
 
void setLowestLevel (size_t level)
 Sets the lowest MIP level to use. Defaults to zero, but can be set higher to prevent high resolution levels from being accessed. More...
 
- Public Member Functions inherited from Field< Data_T >
const_iterator cbegin () const
 Const iterator to first element. "cbegin" matches the tr1 c++ standard. More...
 
const_iterator cbegin (const Box3i &subset) const
 Const iterator to first element of specific subset. More...
 
const_iterator cend () const
 Const iterator pointing one element past the last valid one. More...
 
const_iterator cend (const Box3i &subset) const
 Const iterator pointing one element past the last valid one (for a subset) More...
 
virtual std::string dataTypeString () 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 . More...
 
virtual ~Field ()
 Dtor. More...
 
- 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. More...
 
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. More...
 
 FieldRes ()
 This constructor ensures that we have a valid mapping at all times. More...
 
 FieldRes (const FieldRes &src)
 Base class copy constructor. More...
 
bool isInBounds (int i, int j, int k) const
 Returns true is the indicies are in bounds of the data window. More...
 
FieldMapping::Ptr mapping ()
 Returns a pointer to the mapping. More...
 
const FieldMapping::Ptr mapping () const
 Returns a pointer to the mapping. More...
 
virtual void mappingChanged ()
 Tells the subclass that the mapping changed. More...
 
virtual long long int memSize () const
 Returns the memory usage (in bytes) More...
 
void setMapping (FieldMapping::Ptr mapping)
 Sets the field's mapping. More...
 
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. More...
 
- Public Member Functions inherited from FieldBase
 FieldBase ()
 Constructor. More...
 
 FieldBase (const FieldBase &)
 Copy Constructor. More...
 
virtual ~FieldBase ()
 Destructor. More...
 
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. More...
 
virtual std::string classType () const =0
 Returns the full class type string. More...
 
virtual Ptr clone () const =0
 Returns a pointer to a copy of the field, pure virtual so ensure derived classes properly implement it. More...
 
FieldMetadata< FieldBase > & metadata ()
 accessor to the m_metadata class More...
 
const FieldMetadata< FieldBase > & metadata () const
 Read only access to the m_metadata class. More...
 
virtual void metadataHasChanged (const std::string &)
 This function should implemented by concrete classes to get the callback when metadata changes. More...
 
void copyMetadata (const FieldBase &field)
 Copies the metadata from a second field. More...
 
- Public Member Functions inherited from RefBase
void ref () const
 Used by boost::intrusive_pointer. More...
 
size_t refcnt ()
 Used by boost::intrusive_pointer. More...
 
void unref () const
 Used by boost::intrusive_pointer. More...
 
WeakPtr weakPtr () const
 
 RefBase ()
 
 RefBase (const RefBase &)
 Copy constructor. More...
 
RefBaseoperator= (const RefBase &)
 Assignment operator. More...
 
virtual ~RefBase ()
 Destructor. More...
 
virtual bool checkRTTI (const char *typenameStr)=0
 This function is only implemented by concrete classes and triggers the actual RTTI check through matchRTTI();. More...
 
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. More...
 

Static Public Member Functions

static const char * staticClassName ()
 
static const char * staticClassType ()
 
- Static Public Member Functions inherited from Field< Data_T >
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 Public Member Functions inherited from RefBase
static const char * staticClassType ()
 

Public Attributes

 DEFINE_FIELD_RTTI_ABSTRACT_CLASS
 
- Public Attributes inherited from Field< Data_T >
 DEFINE_FIELD_RTTI_ABSTRACT_CLASS
 
- 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. More...
 
std::string name
 Optional name of the field. More...
 

Protected Types

typedef Field< Data_T > base
 
- Protected Types inherited from FieldRes
typedef MatrixFieldMapping default_mapping
 

Protected Attributes

size_t m_lowestLevel
 The lowest MIP level to use. Defaults to 0, but can be set higher to prevent high resolution levels from being accessed. More...
 
size_t m_numLevels
 Number of MIP levels. The default is 1. More...
 
- 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. More...
 
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. More...
 
FieldMapping::Ptr m_mapping
 Pointer to the field's mapping. More...
 

Static Protected Attributes

static TemplatedFieldType< MIPBase< Data_T > > ms_classType
 

Detailed Description

template<class Data_T>
class MIPBase< Data_T >

Some assumptions:

MIP fields are neither Resizable nor Writable. They are constructed from an existing field such as DenseField, SparseField, etc.

The highest resolution representation is level 0.

All MIPBase subclasses are delayed-read, so as not to touch high res data unless needed.

The base class provides mipValue() and mipLValue(). It is assumed that concrete subclasses provide fastMipValue() and fastMipLValue().

Definition at line 115 of file MIPBase.h.

Member Typedef Documentation

template<class Data_T>
typedef boost::intrusive_ptr<MIPBase> MIPBase< Data_T >::Ptr

Definition at line 122 of file MIPBase.h.

template<class Data_T>
typedef MIPBase<Data_T> MIPBase< Data_T >::class_type

Definition at line 126 of file MIPBase.h.

template<class Data_T>
typedef Field<Data_T> MIPBase< Data_T >::base
protected

Definition at line 184 of file MIPBase.h.

Constructor & Destructor Documentation

template<typename Data_T >
MIPBase< Data_T >::MIPBase ( )

Definition at line 201 of file MIPBase.h.

202  : m_numLevels(1), m_lowestLevel(0)
203 {
204 
205 }
size_t m_lowestLevel
The lowest MIP level to use. Defaults to 0, but can be set higher to prevent high resolution levels f...
Definition: MIPBase.h:192
size_t m_numLevels
Number of MIP levels. The default is 1.
Definition: MIPBase.h:189

Member Function Documentation

template<class Data_T>
static const char* MIPBase< Data_T >::staticClassName ( )
inlinestatic

Definition at line 129 of file MIPBase.h.

130  {
131  return "MIPBase";
132  }
template<class Data_T>
static const char* MIPBase< Data_T >::staticClassType ( )
inlinestatic

Definition at line 134 of file MIPBase.h.

135  {
137  }
std::string name
Optional name of the field.
Definition: Field.h:176
template<class Data_T>
virtual Data_T MIPBase< Data_T >::mipValue ( size_t  level,
int  i,
int  j,
int  k 
) const
pure virtual

Read access to a voxel in a given MIP level.

Parameters
levelThe MIP level to read from

Implemented in MIPField< Field_T >, MIPField< SparseField< Data_T > >, and MIPField< DenseField< Data_T > >.

template<class Data_T>
virtual V3i MIPBase< Data_T >::mipResolution ( size_t  level) const
pure virtual

Returns the resolution of a given MIP level.

Implemented in MIPField< Field_T >, MIPField< SparseField< Data_T > >, and MIPField< DenseField< Data_T > >.

template<class Data_T>
virtual bool MIPBase< Data_T >::levelLoaded ( const size_t  level) const
pure virtual

Whether a given MIP level is loaded.

Implemented in MIPField< Field_T >, MIPField< SparseField< Data_T > >, and MIPField< DenseField< Data_T > >.

template<class Data_T>
virtual void MIPBase< Data_T >::getVsMIPCoord ( const V3f vsP,
const size_t  level,
V3f outVsP 
) const
pure virtual

Given a voxel space coordinate in the 0-level field, computes the coordinate in another level.

Implemented in MIPField< Field_T >, MIPField< SparseField< Data_T > >, and MIPField< DenseField< Data_T > >.

template<class Data_T>
virtual Field<Data_T>::Ptr MIPBase< Data_T >::mipLevel ( const size_t  level) const
pure virtual
template<typename Data_T >
void MIPBase< Data_T >::setLowestLevel ( size_t  level)

Sets the lowest MIP level to use. Defaults to zero, but can be set higher to prevent high resolution levels from being accessed.

Definition at line 210 of file MIPBase.h.

References FIELD3D_CLASSTYPE_TEMPL_INSTANTIATION(), FIELD3D_NAMESPACE_HEADER_CLOSE, and MIPBase< Data_T >::m_lowestLevel.

211 {
212  m_lowestLevel = level;
213 }
size_t m_lowestLevel
The lowest MIP level to use. Defaults to 0, but can be set higher to prevent high resolution levels f...
Definition: MIPBase.h:192
template<class Data_T>
size_t MIPBase< Data_T >::lowestLevel ( ) const
inline

Lowest MIP level to use.

Definition at line 170 of file MIPBase.h.

171  { return m_lowestLevel; }
size_t m_lowestLevel
The lowest MIP level to use. Defaults to 0, but can be set higher to prevent high resolution levels f...
Definition: MIPBase.h:192
template<class Data_T>
size_t MIPBase< Data_T >::numLevels ( ) const
inline

Number of MIP levels.

Definition at line 173 of file MIPBase.h.

174  { return m_numLevels; }
size_t m_numLevels
Number of MIP levels. The default is 1.
Definition: MIPBase.h:189

Member Data Documentation

template<class Data_T>
MIPBase< Data_T >::DEFINE_FIELD_RTTI_ABSTRACT_CLASS

Definition at line 127 of file MIPBase.h.

template<class Data_T>
TemplatedFieldType<MIPBase<Data_T> > MIPBase< Data_T >::ms_classType
staticprotected

Definition at line 180 of file MIPBase.h.

template<class Data_T>
size_t MIPBase< Data_T >::m_lowestLevel
protected

The lowest MIP level to use. Defaults to 0, but can be set higher to prevent high resolution levels from being accessed.

Definition at line 192 of file MIPBase.h.

Referenced by MIPField< Field_T >::clear(), MIPBase< Data_T >::setLowestLevel(), MIPField< Field_T >::setup(), and MIPField< Field_T >::setupLazyLoad().


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