Table of subdivision stencils. More...

#include <stencilTable.h>

Inheritance diagram for StencilTableReal< REAL >:

Public Member Functions
virtual	~StencilTableReal ()

int	GetNumStencils () const
	Returns the number of stencils in the table.

int	GetNumControlVertices () const
	Returns the number of control vertices indexed in the table.

StencilReal< REAL >	GetStencil (Index i) const
	Returns a Stencil at index i in the table.

std::vector< int > const &	GetSizes () const
	Returns the number of control vertices of each stencil in the table.

std::vector< Index > const &	GetOffsets () const
	Returns the offset to a given stencil (factory may leave empty)

std::vector< Index > const &	GetControlIndices () const
	Returns the indices of the control vertices.

std::vector< REAL > const &	GetWeights () const
	Returns the stencil interpolation weights.

StencilReal< REAL >	operator[] (Index index) const
	Returns the stencil at index i in the table.

template<class T , class U >
void	UpdateValues (T const &srcValues, U &dstValues, Index start=-1, Index end=-1) const
	Updates point values based on the control values.

template<class T1 , class T2 , class U >
void	UpdateValues (T1 const &srcBase, int numBase, T2 const &srcRef, U &dstValues, Index start=-1, Index end=-1) const

template<class T , class U >
void	UpdateValues (T const src, U dst, Index start=-1, Index end=-1) const

template<class T1 , class T2 , class U >
void	UpdateValues (T1 const srcBase, int numBase, T2 const srcRef, U *dst, Index start=-1, Index end=-1) const

void	Clear ()
	Clears the stencils from the table.

Protected Member Functions
	StencilTableReal (int numControlVerts, std::vector< int > const &offsets, std::vector< int > const &sizes, std::vector< int > const &sources, std::vector< REAL > const &weights, bool includeCoarseVerts, size_t firstOffset)

template<class T , class U >
void	update (T const &srcValues, U &dstValues, std::vector< REAL > const &valueWeights, Index start, Index end) const

template<class T1 , class T2 , class U >
void	update (T1 const &srcBase, int numBase, T2 const &srcRef, U &dstValues, std::vector< REAL > const &valueWeights, Index start, Index end) const

void	generateOffsets ()

void	resize (int nstencils, int nelems)

void	reserve (int nstencils, int nelems)

void	shrinkToFit ()

void	finalize ()

	StencilTableReal ()

	StencilTableReal (int numControlVerts)

Protected Attributes
int	_numControlVertices

std::vector< int >	_sizes

std::vector< Index >	_offsets

std::vector< Index >	_indices

std::vector< REAL >	_weights

Friends
class	StencilTableFactoryReal< REAL >

class	Far::PatchTableBuilder

Detailed Description

template<typename REAL>
class OpenSubdiv::OPENSUBDIV_VERSION::Far::StencilTableReal< REAL >

Table of subdivision stencils.

Stencils are the most direct method of evaluation of locations on the limit of a surface. Every point of a limit surface can be computed by linearly blending a collection of coarse control vertices.

A stencil assigns a series of control vertex indices with a blending weight that corresponds to a unique parametric location of the limit surface. When the control vertices move in space, the limit location can be very efficiently recomputed simply by applying the blending weights to the series of coarse control vertices.

Definition at line 25 of file stencilTableFactory.h.

Constructor & Destructor Documentation

◆ StencilTableReal() [1/3]

template<typename REAL >

StencilTableReal	(	int	numControlVerts,
		std::vector< int > const &	offsets,
		std::vector< int > const &	sizes,
		std::vector< int > const &	sources,
		std::vector< REAL > const &	weights,
		bool	includeCoarseVerts,
		size_t	firstOffset )

protected

◆ ~StencilTableReal()

template<typename REAL >

virtual ~StencilTableReal ( )

inlinevirtual

Definition at line 136 of file stencilTable.h.

◆ StencilTableReal() [2/3]

template<typename REAL >

StencilTableReal ( )

inlineprotected

Definition at line 238 of file stencilTable.h.

◆ StencilTableReal() [3/3]

template<typename REAL >

StencilTableReal ( int numControlVerts )

inlineprotected

Definition at line 239 of file stencilTable.h.

Member Function Documentation

◆ Clear()

template<typename REAL >

void Clear ( )

Clears the stencils from the table.

◆ finalize()

template<typename REAL >

void finalize ( )

inlineprotected

Definition at line 697 of file stencilTable.h.

◆ generateOffsets()

template<typename REAL >

void generateOffsets ( )

inlineprotected

Definition at line 661 of file stencilTable.h.

◆ GetControlIndices()

template<typename REAL >

std::vector< Index > const & GetControlIndices ( ) const

inline

Returns the indices of the control vertices.

Definition at line 162 of file stencilTable.h.

◆ GetNumControlVertices()

template<typename REAL >

int GetNumControlVertices ( ) const

inline

Returns the number of control vertices indexed in the table.

Definition at line 144 of file stencilTable.h.

◆ GetNumStencils()

template<typename REAL >

int GetNumStencils ( ) const

inline

Returns the number of stencils in the table.

Definition at line 139 of file stencilTable.h.

◆ GetOffsets()

template<typename REAL >

std::vector< Index > const & GetOffsets ( ) const

inline

Returns the offset to a given stencil (factory may leave empty)

Definition at line 157 of file stencilTable.h.

◆ GetSizes()

template<typename REAL >

std::vector< int > const & GetSizes ( ) const

inline

Returns the number of control vertices of each stencil in the table.

Definition at line 152 of file stencilTable.h.

◆ GetStencil()

template<typename REAL >

StencilReal< REAL > GetStencil ( Index i ) const

inline

Returns a Stencil at index i in the table.

Definition at line 705 of file stencilTable.h.

◆ GetWeights()

template<typename REAL >

std::vector< REAL > const & GetWeights ( ) const

inline

Returns the stencil interpolation weights.

Definition at line 167 of file stencilTable.h.

◆ operator[]()

template<typename REAL >

StencilReal< REAL > operator[] ( Index index ) const

inline

Returns the stencil at index i in the table.

Definition at line 717 of file stencilTable.h.

◆ reserve()

template<typename REAL >

void reserve	(	int	nstencils,
		int	nelems )

inlineprotected

Definition at line 681 of file stencilTable.h.

◆ resize()

template<typename REAL >

void resize	(	int	nstencils,
		int	nelems )

inlineprotected

Definition at line 673 of file stencilTable.h.

◆ shrinkToFit()

template<typename REAL >

void shrinkToFit ( )

inlineprotected

Definition at line 689 of file stencilTable.h.

◆ update() [1/2]

template<typename REAL >

template<class T , class U >

void update	(	T const &	srcValues,
		U &	dstValues,
		std::vector< REAL > const &	valueWeights,
		Index	start,
		Index	end ) const

protected

Definition at line 633 of file stencilTable.h.

◆ update() [2/2]

template<typename REAL >

template<class T1 , class T2 , class U >

void update	(	T1 const &	srcBase,
		int	numBase,
		T2 const &	srcRef,
		U &	dstValues,
		std::vector< REAL > const &	valueWeights,
		Index	start,
		Index	end ) const

protected

Definition at line 601 of file stencilTable.h.

◆ UpdateValues() [1/4]

template<typename REAL >

template<class T , class U >

void UpdateValues	(	T const &	srcValues,
		U &	dstValues,
		Index	start = -1,
		Index	end = -1 ) const

inline

Updates point values based on the control values.

Note: The destination buffers are assumed to have allocated at least GetNumStencils() elements.

Parameters

srcValues	Buffer with primvar data for the control vertices
dstValues	Destination buffer for the interpolated primvar data
start	Index of first destination value to update
end	Index of last destination value to update

Definition at line 188 of file stencilTable.h.

◆ UpdateValues() [2/4]

template<typename REAL >

template<class T , class U >

void UpdateValues	(	T const *	src,
		U *	dst,
		Index	start = -1,
		Index	end = -1 ) const

inline

Definition at line 200 of file stencilTable.h.

◆ UpdateValues() [3/4]

template<typename REAL >

template<class T1 , class T2 , class U >

void UpdateValues	(	T1 const &	srcBase,
		int	numBase,
		T2 const &	srcRef,
		U &	dstValues,
		Index	start = -1,
		Index	end = -1 ) const

inline

Definition at line 193 of file stencilTable.h.

◆ UpdateValues() [4/4]

template<typename REAL >

template<class T1 , class T2 , class U >

void UpdateValues	(	T1 const *	srcBase,
		int	numBase,
		T2 const *	srcRef,
		U *	dst,
		Index	start = -1,
		Index	end = -1 ) const

inline

Definition at line 204 of file stencilTable.h.

Friends And Related Symbol Documentation

◆ Far::PatchTableBuilder

template<typename REAL >

friend class Far::PatchTableBuilder

friend

Definition at line 244 of file stencilTable.h.

◆ StencilTableFactoryReal< REAL >

template<typename REAL >

friend class StencilTableFactoryReal< REAL >

friend

Definition at line 239 of file stencilTable.h.

Member Data Documentation

◆ _indices

template<typename REAL >

std::vector<Index> _indices

protected

Definition at line 250 of file stencilTable.h.

◆ _numControlVertices

template<typename REAL >

int _numControlVertices

protected

Definition at line 246 of file stencilTable.h.

◆ _offsets

template<typename REAL >

std::vector<Index> _offsets

protected

Definition at line 249 of file stencilTable.h.

◆ _sizes

template<typename REAL >

std::vector<int> _sizes

protected

Definition at line 248 of file stencilTable.h.

◆ _weights

template<typename REAL >

std::vector<REAL> _weights

protected

Definition at line 251 of file stencilTable.h.

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

opensubdiv/far/stencilTable.h
opensubdiv/far/stencilTableFactory.h

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ StencilTableReal() [1/3]

◆ ~StencilTableReal()

◆ StencilTableReal() [2/3]

◆ StencilTableReal() [3/3]

Member Function Documentation

◆ Clear()

◆ finalize()

◆ generateOffsets()

◆ GetControlIndices()

◆ GetNumControlVertices()

◆ GetNumStencils()

◆ GetOffsets()

◆ GetSizes()

◆ GetStencil()

◆ GetWeights()

◆ operator[]()

◆ reserve()

◆ resize()

◆ shrinkToFit()

◆ update() [1/2]

◆ update() [2/2]

◆ UpdateValues() [1/4]

◆ UpdateValues() [2/4]

◆ UpdateValues() [3/4]

◆ UpdateValues() [4/4]

Friends And Related Symbol Documentation

◆ Far::PatchTableBuilder

◆ StencilTableFactoryReal< REAL >

Member Data Documentation

◆ _indices

◆ _numControlVertices

◆ _offsets

◆ _sizes

◆ _weights