OpenVDB 11.0.0
Loading...
Searching...
No Matches
Classes | Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Friends | List of all members
LeafNode< BuildT, CoordT, MaskT, Log2Dim > Class Template Reference

Leaf nodes of the VDB tree. (defaults to 8x8x8 = 512 voxels) More...

#include <nanovdb/NanoVDB.h>

Inheritance diagram for LeafNode< BuildT, CoordT, MaskT, Log2Dim >:
LeafData< ValueT, CoordT, MaskT, LOG2DIM >

Classes

struct  ChildNodeType
 
class  ValueIterator
 Visits all values in a leaf node, i.e. both active and inactive values. More...
 
class  ValueOffIterator
 Visits all inactive values in a leaf node. More...
 
class  ValueOnIterator
 Visits all active values in a leaf node. More...
 

Public Types

using LeafNodeType = LeafNode< BuildT, CoordT, MaskT, Log2Dim >
 
using DataType = LeafData< BuildT, CoordT, MaskT, Log2Dim >
 
using ValueType = typename DataType::ValueType
 
using FloatType = typename DataType::FloatType
 
using BuildType = typename DataType::BuildType
 
using CoordType = CoordT
 
template<uint32_t LOG2>
using MaskType = MaskT< LOG2 >
 
template<bool ON>
using MaskIterT = typename Mask< Log2Dim >::template Iterator< ON >
 
using ArrayType = ValueT
 

Public Member Functions

ValueOnIterator beginValueOn () const
 
ValueOnIterator cbeginValueOn () const
 
ValueOffIterator beginValueOff () const
 
ValueOffIterator cbeginValueOff () const
 
ValueIterator beginValue () const
 
ValueIterator cbeginValueAll () const
 
DataTypedata ()
 
const DataTypedata () const
 
const MaskType< LOG2DIM > & valueMask () const
 Return a const reference to the bit mask of active voxels in this leaf node.
 
const MaskType< LOG2DIM > & getValueMask () const
 
ValueType minimum () const
 Return a const reference to the minimum active value encoded in this leaf node.
 
ValueType maximum () const
 Return a const reference to the maximum active value encoded in this leaf node.
 
FloatType average () const
 Return a const reference to the average of all the active values encoded in this leaf node.
 
FloatType variance () const
 Return the variance of all the active values encoded in this leaf node.
 
FloatType stdDeviation () const
 Return a const reference to the standard deviation of all the active values encoded in this leaf node.
 
uint8_t flags () const
 
CoordT origin () const
 Return the origin in index space of this leaf node.
 
void localToGlobalCoord (Coord &ijk) const
 Converts (in place) a local index coordinate to a global index coordinate.
 
CoordT offsetToGlobalCoord (uint32_t n) const
 
BBox< CoordT > bbox () const
 Return the bounding box in index space of active values in this leaf node.
 
uint64_t memUsage () const
 return memory usage in bytes for the leaf node
 
 LeafNode ()=delete
 This class cannot be constructed or deleted.
 
 LeafNode (const LeafNode &)=delete
 
LeafNodeoperator= (const LeafNode &)=delete
 
 ~LeafNode ()=delete
 
ValueType getValue (uint32_t offset) const
 Return the voxel value at the given offset.
 
ValueType getValue (const CoordT &ijk) const
 Return the voxel value at the given coordinate.
 
ValueType getFirstValue () const
 Return the first value in this leaf node.
 
ValueType getLastValue () const
 Return the last value in this leaf node.
 
void setValue (const CoordT &ijk, const ValueType &v)
 Sets the value at the specified location and activate its state.
 
void setValueOnly (uint32_t offset, const ValueType &v)
 Sets the value at the specified location but leaves its state unchanged.
 
void setValueOnly (const CoordT &ijk, const ValueType &v)
 
bool isActive (const CoordT &ijk) const
 Return true if the voxel value at the given coordinate is active.
 
bool isActive (uint32_t n) const
 
bool isActive () const
 Return true if any of the voxel value are active in this leaf node.
 
bool hasBBox () const
 
bool probeValue (const CoordT &ijk, ValueType &v) const
 Return true if the voxel value at the given coordinate is active and updates v with the value.
 
const LeafNodeprobeLeaf (const CoordT &) const
 
bool updateBBox ()
 Updates the local bounding box of active voxels in this node. Return true if bbox was updated.
 
template<typename OpT , typename... ArgsT>
auto get (const CoordType &ijk, ArgsT &&... args) const
 
template<typename OpT , typename... ArgsT>
auto get (const uint32_t n, ArgsT &&... args) const
 
template<typename OpT , typename... ArgsT>
auto set (const CoordType &ijk, ArgsT &&... args)
 
template<typename OpT , typename... ArgsT>
auto set (const uint32_t n, ArgsT &&... args)
 
void setValue (uint32_t offset, const ValueType &value)
 
void setOn (uint32_t offset)
 
ValueType getMin () const
 
ValueType getMax () const
 
FloatType getAvg () const
 
FloatType getDev () const
 
void setMin (const ValueType &v)
 
void setMax (const ValueType &v)
 
void setAvg (const FloatType &v)
 
void setDev (const FloatType &v)
 
template<typename T >
void setOrigin (const T &ijk)
 
void fill (const ValueType &v)
 

Static Public Member Functions

static CoordT OffsetToLocalCoord (uint32_t n)
 Compute the local coordinates from a linear offset.
 
static uint32_t dim ()
 Return the dimension, in index space, of this leaf node (typically 8 as for openvdb leaf nodes!)
 
static uint32_t voxelCount ()
 Return the total number of voxels (e.g. values) encoded in this leaf node.
 
static uint32_t padding ()
 
static uint32_t CoordToOffset (const CoordT &ijk)
 Return the linear offset corresponding to the given coordinate.
 
static uint64_t memUsage ()
 
static bool hasStats ()
 

Public Attributes

CoordT mBBoxMin
 
uint8_t mBBoxDif [3]
 
uint8_t mFlags
 
MaskT< LOG2DIMmValueMask
 
ValueType mMinimum
 
ValueType mMaximum
 
FloatType mAverage
 
FloatType mStdDevi
 
ValueType mValues [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
 
static constexpr uint32_t DIM = 1u << TOTAL
 
static constexpr uint32_t SIZE = 1u << 3 * LOG2DIM
 
static constexpr uint32_t MASK = (1u << LOG2DIM) - 1u
 
static constexpr uint32_t LEVEL = 0
 
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 BuildT, typename CoordT = Coord, template< uint32_t > class MaskT = Mask, uint32_t Log2Dim = 3>
class nanovdb::LeafNode< BuildT, CoordT, MaskT, Log2Dim >

Leaf nodes of the VDB tree. (defaults to 8x8x8 = 512 voxels)

Member Typedef Documentation

◆ ArrayType

using ArrayType = ValueT
inherited

◆ BuildType

using BuildType = typename DataType::BuildType

◆ CoordType

using CoordType = CoordT

◆ DataType

using DataType = LeafData<BuildT, CoordT, MaskT, Log2Dim>

◆ FloatType

using FloatType = typename DataType::FloatType

◆ LeafNodeType

using LeafNodeType = LeafNode<BuildT, CoordT, MaskT, Log2Dim>

◆ MaskIterT

using MaskIterT = typename Mask<Log2Dim>::template Iterator<ON>

◆ MaskType

using MaskType = MaskT<LOG2>

◆ ValueType

using ValueType = typename DataType::ValueType

Constructor & Destructor Documentation

◆ LeafNode() [1/2]

LeafNode ( )
delete

This class cannot be constructed or deleted.

◆ LeafNode() [2/2]

LeafNode ( const LeafNode< BuildT, CoordT, MaskT, Log2Dim > &  )
delete

◆ ~LeafNode()

~LeafNode ( )
delete

Member Function Documentation

◆ average()

FloatType average ( ) const
inline

Return a const reference to the average of all the active values encoded in this leaf node.

◆ bbox()

BBox< CoordT > bbox ( ) const
inline

Return the bounding box in index space of active values in this leaf node.

◆ beginValue()

ValueIterator beginValue ( ) const
inline

◆ beginValueOff()

ValueOffIterator beginValueOff ( ) const
inline

◆ beginValueOn()

ValueOnIterator beginValueOn ( ) const
inline

◆ cbeginValueAll()

ValueIterator cbeginValueAll ( ) const
inline

◆ cbeginValueOff()

ValueOffIterator cbeginValueOff ( ) const
inline

◆ cbeginValueOn()

ValueOnIterator cbeginValueOn ( ) const
inline

◆ CoordToOffset()

static uint32_t CoordToOffset ( const CoordT &  ijk)
inlinestatic

Return the linear offset corresponding to the given coordinate.

◆ data() [1/2]

DataType * data ( )
inline

◆ data() [2/2]

const DataType * data ( ) const
inline

◆ dim()

static uint32_t dim ( )
inlinestatic

Return the dimension, in index space, of this leaf node (typically 8 as for openvdb leaf nodes!)

◆ fill()

void fill ( const ValueType v)
inlineinherited

◆ flags()

uint8_t flags ( ) const
inline

◆ get() [1/2]

auto get ( const CoordType ijk,
ArgsT &&...  args 
) const
inline

◆ get() [2/2]

auto get ( const uint32_t  n,
ArgsT &&...  args 
) const
inline

◆ getAvg()

FloatType getAvg ( ) const
inlineinherited

◆ getDev()

FloatType getDev ( ) const
inlineinherited

◆ getFirstValue()

ValueType getFirstValue ( ) const
inline

Return the first value in this leaf node.

◆ getLastValue()

ValueType getLastValue ( ) const
inline

Return the last value in this leaf node.

◆ getMax()

ValueType getMax ( ) const
inlineinherited

◆ getMin()

ValueType getMin ( ) const
inlineinherited

◆ getValue() [1/2]

ValueType getValue ( const CoordT &  ijk) const
inline

Return the voxel value at the given coordinate.

◆ getValue() [2/2]

ValueType getValue ( uint32_t  offset) const
inline

Return the voxel value at the given offset.

◆ getValueMask()

const MaskType< LOG2DIM > & getValueMask ( ) const
inline

◆ hasBBox()

bool hasBBox ( ) const
inline

◆ hasStats()

static bool hasStats ( )
inlinestaticinherited

◆ isActive() [1/3]

bool isActive ( ) const
inline

Return true if any of the voxel value are active in this leaf node.

◆ isActive() [2/3]

bool isActive ( const CoordT &  ijk) const
inline

Return true if the voxel value at the given coordinate is active.

◆ isActive() [3/3]

bool isActive ( uint32_t  n) const
inline

◆ localToGlobalCoord()

void localToGlobalCoord ( Coord ijk) const
inline

Converts (in place) a local index coordinate to a global index coordinate.

◆ maximum()

ValueType maximum ( ) const
inline

Return a const reference to the maximum active value encoded in this leaf node.

◆ memUsage() [1/2]

static uint64_t memUsage ( )
inlinestaticinherited

◆ memUsage() [2/2]

uint64_t memUsage ( ) const
inline

return memory usage in bytes for the leaf node

◆ minimum()

ValueType minimum ( ) const
inline

Return a const reference to the minimum active value encoded in this leaf node.

◆ offsetToGlobalCoord()

CoordT offsetToGlobalCoord ( uint32_t  n) const
inline

◆ OffsetToLocalCoord()

static CoordT OffsetToLocalCoord ( uint32_t  n)
inlinestatic

Compute the local coordinates from a linear offset.

Parameters
nLinear offset into this nodes dense table
Returns
Local (vs global) 3D coordinates

◆ operator=()

LeafNode & operator= ( const LeafNode< BuildT, CoordT, MaskT, Log2Dim > &  )
delete

◆ origin()

CoordT origin ( ) const
inline

Return the origin in index space of this leaf node.

◆ padding()

static uint32_t padding ( )
inlinestatic

◆ probeLeaf()

const LeafNode * probeLeaf ( const CoordT &  ) const
inline

◆ probeValue()

bool probeValue ( const CoordT &  ijk,
ValueType v 
) const
inline

Return true if the voxel value at the given coordinate is active and updates v with the value.

◆ set() [1/2]

auto set ( const CoordType ijk,
ArgsT &&...  args 
)
inline

◆ set() [2/2]

auto set ( const uint32_t  n,
ArgsT &&...  args 
)
inline

◆ setAvg()

void setAvg ( const FloatType v)
inlineinherited

◆ setDev()

void setDev ( const FloatType v)
inlineinherited

◆ setMax()

void setMax ( const ValueType v)
inlineinherited

◆ setMin()

void setMin ( const ValueType v)
inlineinherited

◆ setOn()

void setOn ( uint32_t  offset)
inlineinherited

◆ setOrigin()

void setOrigin ( const T &  ijk)
inlineinherited

◆ setValue() [1/2]

void setValue ( const CoordT &  ijk,
const ValueType v 
)
inline

Sets the value at the specified location and activate its state.

Note
This is safe since it does not change the topology of the tree (unlike setValue methods on the other nodes)

◆ setValue() [2/2]

void setValue ( uint32_t  offset,
const ValueType value 
)
inlineinherited

◆ setValueOnly() [1/2]

void setValueOnly ( const CoordT &  ijk,
const ValueType v 
)
inline

◆ setValueOnly() [2/2]

void setValueOnly ( uint32_t  offset,
const ValueType v 
)
inline

Sets the value at the specified location but leaves its state unchanged.

Note
This is safe since it does not change the topology of the tree (unlike setValue methods on the other nodes)

◆ stdDeviation()

FloatType stdDeviation ( ) const
inline

Return a const reference to the standard deviation of all the active values encoded in this leaf node.

◆ updateBBox()

bool updateBBox
inline

Updates the local bounding box of active voxels in this node. Return true if bbox was updated.

Warning
It assumes that the origin and value mask have already been set.

This method is based on few (intrinsic) bit operations and hence is relatively fast. However, it should only only be called if either the value mask has changed or if the active bounding box is still undefined. e.g. during construction of this node.

◆ valueMask()

const MaskType< LOG2DIM > & valueMask ( ) const
inline

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

◆ variance()

FloatType variance ( ) const
inline

Return the variance of all the active values encoded in this leaf node.

◆ voxelCount()

static uint32_t voxelCount ( )
inlinestatic

Return the total number of voxels (e.g. values) encoded in this leaf node.

Friends And Related Function Documentation

◆ InternalNode

friend class InternalNode
friend

◆ ReadAccessor

friend class ReadAccessor
friend

◆ RootNode

friend class RootNode
friend

Member Data Documentation

◆ DIM

constexpr uint32_t DIM = 1u << TOTAL
staticconstexpr

◆ FIXED_SIZE

constexpr bool FIXED_SIZE = DataType::FIXED_SIZE
staticconstexpr

◆ LEVEL

constexpr uint32_t LEVEL = 0
staticconstexpr

◆ LOG2DIM

constexpr uint32_t LOG2DIM = Log2Dim
staticconstexpr

◆ MASK

constexpr uint32_t MASK = (1u << LOG2DIM) - 1u
staticconstexpr

◆ mAverage

FloatType mAverage
inherited

◆ mBBoxDif

uint8_t mBBoxDif[3]
inherited

◆ mBBoxMin

CoordT mBBoxMin
inherited

◆ mFlags

uint8_t mFlags
inherited

◆ mMaximum

ValueType mMaximum
inherited

◆ mMinimum

ValueType mMinimum
inherited

◆ mStdDevi

FloatType mStdDevi
inherited

◆ mValueMask

MaskT<LOG2DIM> mValueMask
inherited

◆ mValues

ValueType mValues[1u<< 3 *LOG2DIM]
inherited

◆ NUM_VALUES

constexpr uint64_t NUM_VALUES = uint64_t(1) << (3 * TOTAL)
staticconstexpr

◆ SIZE

constexpr uint32_t SIZE = 1u << 3 * LOG2DIM
staticconstexpr

◆ TOTAL

constexpr uint32_t TOTAL = LOG2DIM
staticconstexpr