OpenVDB  12.0.0
Classes | Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Friends | List of all members
InternalNode< ChildT, Log2Dim > Class Template Reference

Internal nodes of a VDB tree. More...

#include <nanovdb/NanoVDB.h>

Inherits InternalData< ChildT, Log2Dim >.

Classes

class  ChildIter
 Visits child nodes of this node only. More...
 
class  DenseIterator
 Visits all tile values and child nodes of this node. More...
 
class  ValueIterator
 Visits all tile values in this node, i.e. both inactive and active tiles. More...
 
class  ValueOnIterator
 Visits active tile values of this node only. More...
 

Public Types

using DataType = InternalData< ChildT, Log2Dim >
 
using ValueType = typename DataType::ValueT
 
using FloatType = typename DataType::StatsT
 
using BuildType = typename DataType::BuildT
 
using LeafNodeType = typename ChildT::LeafNodeType
 
using ChildNodeType = ChildT
 
using CoordType = typename ChildT::CoordType
 
template<uint32_t LOG2>
using MaskType = typename ChildT::template MaskType< LOG2 >
 
template<bool On>
using MaskIterT = typename Mask< Log2Dim >::template Iterator< On >
 
using ChildIterator = ChildIter< InternalNode >
 
using ConstChildIterator = ChildIter< const InternalNode >
 
using ValueT = typename ChildT::ValueType
 
using BuildT = typename ChildT::BuildType
 
using StatsT = typename ChildT::FloatType
 
using CoordT = typename ChildT::CoordType
 
using MaskT = typename ChildT::template MaskType< LOG2DIM >
 

Public Member Functions

__hostdev__ ChildIterator beginChild ()
 
__hostdev__ ConstChildIterator cbeginChild () const
 
__hostdev__ ValueIterator beginValue () const
 
__hostdev__ ValueIterator cbeginValueAll () const
 
__hostdev__ ValueOnIterator beginValueOn () const
 
__hostdev__ ValueOnIterator cbeginValueOn () const
 
__hostdev__ DenseIterator beginDense () const
 
__hostdev__ DenseIterator cbeginChildAll () const
 
 InternalNode ()=delete
 This class cannot be constructed or deleted. More...
 
 InternalNode (const InternalNode &)=delete
 
InternalNodeoperator= (const InternalNode &)=delete
 
 ~InternalNode ()=delete
 
__hostdev__ DataTypedata ()
 
__hostdev__ const DataTypedata () const
 
__hostdev__ const MaskType< LOG2DIM > & valueMask () const
 Return a const reference to the bit mask of active voxels in this internal node. More...
 
__hostdev__ const MaskType< LOG2DIM > & getValueMask () const
 
__hostdev__ const MaskType< LOG2DIM > & childMask () const
 Return a const reference to the bit mask of child nodes in this internal node. More...
 
__hostdev__ const MaskType< LOG2DIM > & getChildMask () const
 
__hostdev__ CoordType origin () const
 Return the origin in index space of this leaf node. More...
 
__hostdev__ const ValueTypeminimum () const
 Return a const reference to the minimum active value encoded in this internal node and any of its child nodes. More...
 
__hostdev__ const ValueTypemaximum () const
 Return a const reference to the maximum active value encoded in this internal node and any of its child nodes. More...
 
__hostdev__ const FloatTypeaverage () const
 Return a const reference to the average of all the active values encoded in this internal node and any of its child nodes. More...
 
__hostdev__ FloatType variance () const
 Return the variance of all the active values encoded in this internal node and any of its child nodes. More...
 
__hostdev__ const FloatTypestdDeviation () const
 Return a const reference to the standard deviation of all the active values encoded in this internal node and any of its child nodes. More...
 
__hostdev__ const math::BBox< CoordType > & bbox () const
 Return a const reference to the bounding box in index space of active values in this internal node and any of its child nodes. More...
 
__hostdev__ ValueType getFirstValue () const
 If the first entry in this node's table is a tile, return the tile's value. Otherwise, return the result of calling getFirstValue() on the child. More...
 
__hostdev__ ValueType getLastValue () const
 If the last entry in this node's table is a tile, return the tile's value. Otherwise, return the result of calling getLastValue() on the child. More...
 
__hostdev__ ValueType getValue (const CoordType &ijk) const
 Return the value of the given voxel. More...
 
__hostdev__ bool isActive (const CoordType &ijk) const
 
__hostdev__ bool probeValue (const CoordType &ijk, ValueType &v) const
 return the state and updates the value of the specified voxel More...
 
__hostdev__ const LeafNodeTypeprobeLeaf (const CoordType &ijk) const
 
__hostdev__ ChildNodeTypeprobeChild (const CoordType &ijk)
 
__hostdev__ const ChildNodeTypeprobeChild (const CoordType &ijk) const
 
__hostdev__ void localToGlobalCoord (Coord &ijk) const
 modifies local coordinates to global coordinates of a tile or child node More...
 
__hostdev__ Coord offsetToGlobalCoord (uint32_t n) const
 
__hostdev__ bool isActive () const
 Return true if this node or any of its child nodes contain active values. More...
 
template<typename OpT , typename... ArgsT>
__hostdev__ auto get (const CoordType &ijk, ArgsT &&...args) const
 
__hostdev__ void setChild (uint32_t n, const void *ptr)
 
__hostdev__ void setValue (uint32_t n, const ValueT &v)
 
__hostdev__ ChildT * getChild (uint32_t n)
 Returns a pointer to the child node at the specifed linear offset. More...
 
__hostdev__ const ChildT * getChild (uint32_t n) const
 
__hostdev__ ValueT getValue (uint32_t n) const
 
__hostdev__ bool isActive (uint32_t n) const
 
__hostdev__ bool isChild (uint32_t n) const
 
__hostdev__ void setOrigin (const T &ijk)
 
__hostdev__ const ValueTgetMin () const
 
__hostdev__ const ValueTgetMax () const
 
__hostdev__ void setMin (const ValueT &v)
 
__hostdev__ void setMax (const ValueT &v)
 
__hostdev__ void setAvg (const StatsT &v)
 
__hostdev__ void setDev (const StatsT &v)
 

Static Public Member Functions

static __hostdev__ uint32_t dim ()
 Return the dimension, in voxel units, of this internal node (typically 8*16 or 8*16*32) More...
 
static __hostdev__ size_t memUsage ()
 Return memory usage in bytes for the class. More...
 
static __hostdev__ uint32_t CoordToOffset (const CoordType &ijk)
 Return the linear offset corresponding to the given coordinate. More...
 
static __hostdev__ Coord OffsetToLocalCoord (uint32_t n)
 
static __hostdev__ constexpr uint32_t padding ()
 Return padding of this class in bytes, due to aliasing and 32B alignment. More...
 

Public Attributes

template<typename OpT , typename... ArgsT>
decltype(OpT::set(util::declval< InternalNode & >(), util::declval< uint32_t >(), util::declval< ArgsT >()...)) __hostdev__ set (const CoordType &ijk, ArgsT &&...args)
 
math::BBox< CoordTmBBox
 
uint64_t mFlags
 
MaskT mValueMask
 
MaskT mChildMask
 
ValueT mMinimum
 
ValueT mMaximum
 
StatsT mAverage
 
StatsT mStdDevi
 
Tile mTable [1u<< (3 *LOG2DIM)]
 

Static Public Attributes

static constexpr bool FIXED_SIZE = DataType::FIXED_SIZE
 
static constexpr uint32_t LOG2DIM = Log2Dim
 
static constexpr uint32_t TOTAL = LOG2DIM + ChildT::TOTAL
 
static constexpr uint32_t DIM = 1u << TOTAL
 
static constexpr uint32_t SIZE = 1u << (3 * LOG2DIM)
 
static constexpr uint32_t MASK = (1u << TOTAL) - 1u
 
static constexpr uint32_t LEVEL = 1 + ChildT::LEVEL
 
static constexpr uint64_t NUM_VALUES = uint64_t(1) << (3 * TOTAL)
 

Friends

template<typename , int , int , int >
class ReadAccessor
 
template<typename >
class RootNode
 
template<typename , uint32_t >
class InternalNode
 

Detailed Description

template<typename ChildT, uint32_t Log2Dim = ChildT::LOG2DIM + 1>
class nanovdb::InternalNode< ChildT, Log2Dim >

Internal nodes of a VDB tree.

Member Typedef Documentation

using BuildT = typename ChildT::BuildType
inherited
using BuildType = typename DataType::BuildT
using ChildNodeType = ChildT
using CoordT = typename ChildT::CoordType
inherited
using CoordType = typename ChildT::CoordType
using DataType = InternalData<ChildT, Log2Dim>
using FloatType = typename DataType::StatsT
using LeafNodeType = typename ChildT::LeafNodeType
using MaskIterT = typename Mask<Log2Dim>::template Iterator<On>
using MaskT = typename ChildT::template MaskType<LOG2DIM>
inherited
using MaskType = typename ChildT::template MaskType<LOG2>
using StatsT = typename ChildT::FloatType
inherited
using ValueT = typename ChildT::ValueType
inherited
using ValueType = typename DataType::ValueT

Constructor & Destructor Documentation

InternalNode ( )
delete

This class cannot be constructed or deleted.

InternalNode ( const InternalNode< ChildT, Log2Dim > &  )
delete
~InternalNode ( )
delete

Member Function Documentation

__hostdev__ const FloatType& average ( ) const
inline

Return a const reference to the average of all the active values encoded in this internal node and any of its child nodes.

__hostdev__ const math::BBox<CoordType>& bbox ( ) const
inline

Return a const reference to the bounding box in index space of active values in this internal node and any of its child nodes.

__hostdev__ ChildIterator beginChild ( )
inline
__hostdev__ DenseIterator beginDense ( ) const
inline
__hostdev__ ValueIterator beginValue ( ) const
inline
__hostdev__ ValueOnIterator beginValueOn ( ) const
inline
__hostdev__ ConstChildIterator cbeginChild ( ) const
inline
__hostdev__ DenseIterator cbeginChildAll ( ) const
inline
__hostdev__ ValueIterator cbeginValueAll ( ) const
inline
__hostdev__ ValueOnIterator cbeginValueOn ( ) const
inline
__hostdev__ const MaskType<LOG2DIM>& childMask ( ) const
inline

Return a const reference to the bit mask of child nodes in this internal node.

static __hostdev__ uint32_t CoordToOffset ( const CoordType ijk)
inlinestatic

Return the linear offset corresponding to the given coordinate.

__hostdev__ DataType* data ( )
inline
__hostdev__ const DataType* data ( ) const
inline
static __hostdev__ uint32_t dim ( )
inlinestatic

Return the dimension, in voxel units, of this internal node (typically 8*16 or 8*16*32)

__hostdev__ auto get ( const CoordType ijk,
ArgsT &&...  args 
) const
inline
__hostdev__ ChildT* getChild ( uint32_t  n)
inlineinherited

Returns a pointer to the child node at the specifed linear offset.

__hostdev__ const ChildT* getChild ( uint32_t  n) const
inlineinherited
__hostdev__ const MaskType<LOG2DIM>& getChildMask ( ) const
inline
__hostdev__ ValueType getFirstValue ( ) const
inline

If the first entry in this node's table is a tile, return the tile's value. Otherwise, return the result of calling getFirstValue() on the child.

__hostdev__ ValueType getLastValue ( ) const
inline

If the last entry in this node's table is a tile, return the tile's value. Otherwise, return the result of calling getLastValue() on the child.

__hostdev__ const ValueT& getMax ( ) const
inlineinherited
__hostdev__ const ValueT& getMin ( ) const
inlineinherited
__hostdev__ ValueT getValue ( uint32_t  n) const
inlineinherited
__hostdev__ ValueType getValue ( const CoordType ijk) const
inline

Return the value of the given voxel.

__hostdev__ const MaskType<LOG2DIM>& getValueMask ( ) const
inline
__hostdev__ bool isActive ( uint32_t  n) const
inlineinherited
__hostdev__ bool isActive ( const CoordType ijk) const
inline
__hostdev__ bool isActive ( ) const
inline

Return true if this node or any of its child nodes contain active values.

__hostdev__ bool isChild ( uint32_t  n) const
inlineinherited
__hostdev__ void localToGlobalCoord ( Coord &  ijk) const
inline

modifies local coordinates to global coordinates of a tile or child node

__hostdev__ const ValueType& maximum ( ) const
inline

Return a const reference to the maximum active value encoded in this internal node and any of its child nodes.

static __hostdev__ size_t memUsage ( )
inlinestatic

Return memory usage in bytes for the class.

__hostdev__ const ValueType& minimum ( ) const
inline

Return a const reference to the minimum active value encoded in this internal node and any of its child nodes.

__hostdev__ Coord offsetToGlobalCoord ( uint32_t  n) const
inline
static __hostdev__ Coord OffsetToLocalCoord ( uint32_t  n)
inlinestatic
Returns
the local coordinate of the n'th tile or child node
InternalNode& operator= ( const InternalNode< ChildT, Log2Dim > &  )
delete
__hostdev__ CoordType origin ( ) const
inline

Return the origin in index space of this leaf node.

static __hostdev__ constexpr uint32_t padding ( )
inlinestaticinherited

Return padding of this class in bytes, due to aliasing and 32B alignment.

Note
The extra bytes are not necessarily at the end, but can come from aliasing of individual data members.
__hostdev__ ChildNodeType* probeChild ( const CoordType ijk)
inline
__hostdev__ const ChildNodeType* probeChild ( const CoordType ijk) const
inline
__hostdev__ const LeafNodeType* probeLeaf ( const CoordType ijk) const
inline
__hostdev__ bool probeValue ( const CoordType ijk,
ValueType v 
) const
inline

return the state and updates the value of the specified voxel

__hostdev__ void setAvg ( const StatsT v)
inlineinherited
__hostdev__ void setChild ( uint32_t  n,
const void *  ptr 
)
inlineinherited
__hostdev__ void setDev ( const StatsT v)
inlineinherited
__hostdev__ void setMax ( const ValueT v)
inlineinherited
__hostdev__ void setMin ( const ValueT v)
inlineinherited
__hostdev__ void setOrigin ( const T &  ijk)
inlineinherited
__hostdev__ void setValue ( uint32_t  n,
const ValueT v 
)
inlineinherited
__hostdev__ const FloatType& stdDeviation ( ) const
inline

Return a const reference to the standard deviation of all the active values encoded in this internal node and any of its child nodes.

__hostdev__ const MaskType<LOG2DIM>& valueMask ( ) const
inline

Return a const reference to the bit mask of active voxels in this internal node.

__hostdev__ FloatType variance ( ) const
inline

Return the variance of all the active values encoded in this internal node and any of its child nodes.

Friends And Related Function Documentation

friend class InternalNode
friend
friend class ReadAccessor
friend
friend class RootNode
friend

Member Data Documentation

constexpr uint32_t DIM = 1u << TOTAL
static
constexpr bool FIXED_SIZE = DataType::FIXED_SIZE
static
constexpr uint32_t LEVEL = 1 + ChildT::LEVEL
static
constexpr uint32_t LOG2DIM = Log2Dim
static
constexpr uint32_t MASK = (1u << TOTAL) - 1u
static
StatsT mAverage
inherited
math::BBox<CoordT> mBBox
inherited
MaskT mChildMask
inherited
uint64_t mFlags
inherited
ValueT mMaximum
inherited
ValueT mMinimum
inherited
StatsT mStdDevi
inherited
Tile mTable[1u<< (3 *LOG2DIM)]
inherited
MaskT mValueMask
inherited
constexpr uint64_t NUM_VALUES = uint64_t(1) << (3 * TOTAL)
static
decltype(OpT::set(util::declval<InternalNode&>(), util::declval<uint32_t>(), util::declval<ArgsT>()...)) __hostdev__ set(const CoordType &ijk, ArgsT &&...args)
inline
constexpr uint32_t SIZE = 1u << (3 * LOG2DIM)
static
constexpr uint32_t TOTAL = LOG2DIM + ChildT::TOTAL
static