Field3D
ProceduralField< Data_T > Class Template Referenceabstract

#include <ProceduralField.h>

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

Public Types

typedef ProceduralField< Data_T > class_type
 
typedef ProceduralFieldLookup< Data_T > CubicInterp
 
typedef ProceduralFieldLookup< Data_T > LinearInterp
 
typedef boost::intrusive_ptr< ProceduralFieldPtr
 
- 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 Data_T lsSample (const V3d &lsP) const =0
 
Data_T typedFloatMetadata (const std::string &name, const Data_T &defaultVal) const
 Calls either sampleFloatMetadata() if the ProceduralField is scalar (half, float, or double), or sampleVecFloatMetadata() if the field is vector (V3h, V3f, V3d) More...
 
template<>
half typedFloatMetadata (const std::string &name, const half &defaultVal) const
 
template<>
float typedFloatMetadata (const std::string &name, const float &defaultVal) const
 
template<>
double typedFloatMetadata (const std::string &name, const double &defaultVal) const
 
template<>
V3h typedFloatMetadata (const std::string &name, const V3h &defaultVal) const
 
template<>
V3f typedFloatMetadata (const std::string &name, const V3f &defaultVal) const
 
template<>
V3d typedFloatMetadata (const std::string &name, const V3d &defaultVal) const
 
Data_T typedIntMetadata (const std::string &name, const Data_T &defaultVal) const
 Calls either sampleIntMetadata() if the ProceduralField is scalar (half, float, or double), or sampleVecIntMetadata() if the field is vector (V3h, V3f, V3d) More...
 
template<>
half typedIntMetadata (const std::string &name, const half &defaultVal) const
 
template<>
float typedIntMetadata (const std::string &name, const float &defaultVal) const
 
template<>
double typedIntMetadata (const std::string &name, const double &defaultVal) const
 
template<>
V3h typedIntMetadata (const std::string &name, const V3h &defaultVal) const
 
template<>
V3f typedIntMetadata (const std::string &name, const V3f &defaultVal) const
 
template<>
V3d typedIntMetadata (const std::string &name, const V3d &defaultVal) const
 
virtual FIELD3D_CLASSNAME_CLASSTYPE_IMPLEMENTATION Data_T value (int i, int j, int k) const =0
 Transforms the point from voxel space to subclass's space and calls the appropriate sample function. More...
 
virtual ~ProceduralField ()
 Destructor. 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 ~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 DEFINE_FIELD_RTTI_ABSTRACT_CLASS 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 ()
 

Private Types

typedef Field< Data_T > base
 

Static Private Attributes

static TemplatedFieldType< ProceduralField< Data_T > > ms_classType
 

Additional Inherited Members

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

Detailed Description

template<class Data_T>
class ProceduralField< Data_T >

This class generalizes the Field concept to fields that don't necessarily contain voxel data. This is technically wrong (it's not true that a perlin noise volume IS-A Field) but it lends great flexibility to the Field concept.

So what happens when a ProceduralField is accessed using the Field interface? ProceduralField itself implements value() such that it automatically point-samples the field instead of accessing a particular voxel. This makes the ProceduralField seem as a regular Field to anyone using that interface.

The interesting part comes when we look at interpolation. Regular Field objects use Interpolator objects to produce values in-between voxels. For ProceduralField, we instead want to point-sample in space, but other than that the resultant value can be handled the same.

It is also fine to interpolate the ProceduralField outside its bounds - just as it is with regular Fields. The difference is that ProceduralFields still return valid values outside its bounds.

By using ProceduralField, we can support purely procedural and hybrid procedural/discrete volumes, but to the functions that use them, they all function the same.

Definition at line 120 of file ProceduralField.h.

Member Typedef Documentation

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

Definition at line 127 of file ProceduralField.h.

template<class Data_T>
typedef ProceduralFieldLookup<Data_T> ProceduralField< Data_T >::LinearInterp

Definition at line 129 of file ProceduralField.h.

template<class Data_T>
typedef ProceduralFieldLookup<Data_T> ProceduralField< Data_T >::CubicInterp

Definition at line 130 of file ProceduralField.h.

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

Definition at line 134 of file ProceduralField.h.

template<class Data_T>
typedef Field<Data_T> ProceduralField< Data_T >::base
private

Definition at line 188 of file ProceduralField.h.

Constructor & Destructor Documentation

Member Function Documentation

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

Definition at line 137 of file ProceduralField.h.

138  {
139  return "ProceduralField";
140  }
template<class Data_T>
static const char* ProceduralField< Data_T >::staticClassType ( )
inlinestatic

Definition at line 142 of file ProceduralField.h.

References FieldBase::name.

143  {
145  }
std::string name
Optional name of the field.
Definition: Field.h:176
template<class Data_T>
virtual Data_T ProceduralField< Data_T >::lsSample ( const V3d lsP) const
pure virtual
template<class Data_T>
virtual FIELD3D_CLASSNAME_CLASSTYPE_IMPLEMENTATION Data_T ProceduralField< Data_T >::value ( int  i,
int  j,
int  k 
) const
pure virtual

Transforms the point from voxel space to subclass's space and calls the appropriate sample function.

Implements Field< Data_T >.

Referenced by ProceduralField< Data_T >::~ProceduralField().

template<class Data_T>
Data_T ProceduralField< Data_T >::typedIntMetadata ( const std::string &  name,
const Data_T &  defaultVal 
) const

Calls either sampleIntMetadata() if the ProceduralField is scalar (half, float, or double), or sampleVecIntMetadata() if the field is vector (V3h, V3f, V3d)

Referenced by ProceduralField< Data_T >::~ProceduralField().

template<class Data_T>
Data_T ProceduralField< Data_T >::typedFloatMetadata ( const std::string &  name,
const Data_T &  defaultVal 
) const

Calls either sampleFloatMetadata() if the ProceduralField is scalar (half, float, or double), or sampleVecFloatMetadata() if the field is vector (V3h, V3f, V3d)

Referenced by ProceduralField< Data_T >::~ProceduralField().

template<>
half ProceduralField< half >::typedIntMetadata ( const std::string &  name,
const half defaultVal 
) const
inline

Definition at line 215 of file ProceduralField.h.

References FieldMetadata< CallBack_T >::intMetadata(), and FieldBase::metadata().

217 {
218  return metadata().intMetadata(name, static_cast<int>(defaultVal));
219 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
int intMetadata(const std::string &name, const int defaultVal) const
Tries to retrieve an int metadata value. Returns the specified default value if no metadata was found...
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
float ProceduralField< float >::typedIntMetadata ( const std::string &  name,
const float &  defaultVal 
) const
inline

Definition at line 225 of file ProceduralField.h.

References FieldMetadata< CallBack_T >::intMetadata(), and FieldBase::metadata().

227 {
228  return metadata().intMetadata(name, static_cast<int>(defaultVal));
229 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
int intMetadata(const std::string &name, const int defaultVal) const
Tries to retrieve an int metadata value. Returns the specified default value if no metadata was found...
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
double ProceduralField< double >::typedIntMetadata ( const std::string &  name,
const double &  defaultVal 
) const
inline

Definition at line 235 of file ProceduralField.h.

References FieldMetadata< CallBack_T >::intMetadata(), and FieldBase::metadata().

237 {
238  return metadata().intMetadata(name, static_cast<int>(defaultVal));
239 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
int intMetadata(const std::string &name, const int defaultVal) const
Tries to retrieve an int metadata value. Returns the specified default value if no metadata was found...
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
V3h ProceduralField< V3h >::typedIntMetadata ( const std::string &  name,
const V3h defaultVal 
) const
inline

Definition at line 245 of file ProceduralField.h.

References FieldBase::metadata().

247 {
248  return V3h(metadata().vecIntMetadata(name, defaultVal));
249 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
Imath::Vec3< half > V3h
Definition: SpiMathLib.h:72
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
V3f ProceduralField< V3f >::typedIntMetadata ( const std::string &  name,
const V3f defaultVal 
) const
inline

Definition at line 255 of file ProceduralField.h.

References FieldBase::metadata().

257 {
258  return V3f(metadata().vecIntMetadata(name, defaultVal));
259 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
Imath::V3f V3f
Definition: SpiMathLib.h:73
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
V3d ProceduralField< V3d >::typedIntMetadata ( const std::string &  name,
const V3d defaultVal 
) const
inline

Definition at line 265 of file ProceduralField.h.

References half, and FieldBase::metadata().

267 {
268  return V3d(metadata().vecIntMetadata(name, defaultVal));
269 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
Imath::V3d V3d
Definition: SpiMathLib.h:74
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
half ProceduralField< half >::typedFloatMetadata ( const std::string &  name,
const half defaultVal 
) const
inline

Definition at line 275 of file ProceduralField.h.

References FieldMetadata< CallBack_T >::floatMetadata(), and FieldBase::metadata().

277 {
278  return metadata().floatMetadata(name, static_cast<float>(defaultVal));
279 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
float floatMetadata(const std::string &name, const float defaultVal) const
Tries to retrieve a float metadata value. Returns the specified default value if no metadata was foun...
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
float ProceduralField< float >::typedFloatMetadata ( const std::string &  name,
const float &  defaultVal 
) const
inline

Definition at line 285 of file ProceduralField.h.

References FieldMetadata< CallBack_T >::floatMetadata(), and FieldBase::metadata().

287 {
288  return metadata().floatMetadata(name, defaultVal);
289 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
float floatMetadata(const std::string &name, const float defaultVal) const
Tries to retrieve a float metadata value. Returns the specified default value if no metadata was foun...
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
double ProceduralField< double >::typedFloatMetadata ( const std::string &  name,
const double &  defaultVal 
) const
inline

Definition at line 295 of file ProceduralField.h.

References FieldMetadata< CallBack_T >::floatMetadata(), and FieldBase::metadata().

297 {
298  return metadata().floatMetadata(name, static_cast<float>(defaultVal));
299 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
float floatMetadata(const std::string &name, const float defaultVal) const
Tries to retrieve a float metadata value. Returns the specified default value if no metadata was foun...
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
V3h ProceduralField< V3h >::typedFloatMetadata ( const std::string &  name,
const V3h defaultVal 
) const
inline

Definition at line 305 of file ProceduralField.h.

References FieldBase::metadata().

307 {
308  return V3h(metadata().vecFloatMetadata(name, defaultVal));
309 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
Imath::Vec3< half > V3h
Definition: SpiMathLib.h:72
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
V3f ProceduralField< V3f >::typedFloatMetadata ( const std::string &  name,
const V3f defaultVal 
) const
inline

Definition at line 315 of file ProceduralField.h.

References FieldBase::metadata().

317 {
318  return V3f(metadata().vecFloatMetadata(name, defaultVal));
319 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
Imath::V3f V3f
Definition: SpiMathLib.h:73
std::string name
Optional name of the field.
Definition: Field.h:176
template<>
V3d ProceduralField< V3d >::typedFloatMetadata ( const std::string &  name,
const V3d defaultVal 
) const
inline

Definition at line 325 of file ProceduralField.h.

References FIELD3D_NAMESPACE_HEADER_CLOSE, and FieldBase::metadata().

327 {
328  return V3d(metadata().vecFloatMetadata(name, defaultVal));
329 }
FieldMetadata< FieldBase > & metadata()
accessor to the m_metadata class
Definition: Field.h:155
Imath::V3d V3d
Definition: SpiMathLib.h:74
std::string name
Optional name of the field.
Definition: Field.h:176

Member Data Documentation

template<class Data_T>
TemplatedFieldType<ProceduralField<Data_T> > ProceduralField< Data_T >::ms_classType
staticprivate

Definition at line 184 of file ProceduralField.h.


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