A utility class that knows how to sample an element from a type-tagged buffer (like HdVtBufferSource). More...

#include <sampler.h>

Public Member Functions
	HdEmbreeBufferSampler (HdVtBufferSource const &buffer)
	The constructor takes a reference to a buffer source.

bool	Sample (int index, void *value, HdTupleType dataType) const
	Sample the buffer at element index `index`, and write the sample to `value`.

template<typename T >
bool	Sample (int index, T *value) const

Detailed Description

A utility class that knows how to sample an element from a type-tagged buffer (like HdVtBufferSource).

This class provides templated accessors to let the caller directly get the final sample type; it also does bounds checks and type checks.

Definition at line 79 of file sampler.h.

Constructor & Destructor Documentation

◆ HdEmbreeBufferSampler()

HdEmbreeBufferSampler ( HdVtBufferSource const & buffer )

inline

The constructor takes a reference to a buffer source.

The data is owned externally; the caller is responsible for ensuring the buffer is alive while Sample() is being called.

Parameters

buffer The buffer being sampled.

Definition at line 85 of file sampler.h.

Member Function Documentation

◆ Sample() [1/2]

template<typename T >

bool Sample	(	int	index,
		T *	value ) const

inline

Definition at line 104 of file sampler.h.

◆ Sample() [2/2]

bool Sample	(	int	index,
		void *	value,
		HdTupleType	dataType ) const

Sample the buffer at element index index, and write the sample to value.

Interpret value as having arity numComponents, each of type componentType. These parameters may not match the datatype declaration of the underlying buffer, in which case Sample returns false. Sample also returns false if index is out of bounds.

For example, to sample data as GfVec3, dataType would be HdTupleType { HdTypeFloatVec3, 1 }.