PrimvarRefinerReal< REAL > Class Template Reference

Applies refinement operations to generic primvar data. More...

`#include <primvarRefiner.h>`

## Public Member Functions

| PrimvarRefinerReal (TopologyRefiner const &refiner)
| ~PrimvarRefinerReal ()
TopologyRefiner const & | GetTopologyRefiner () const

## Primvar data interpolation

Note
  Interpolation methods template both the source and destination data buffer classes. Client-code is expected to provide interfaces that implement the functions specific to its primitive variable data layout. Template APIs must implement the following:
  class MySource {
  MySource & operator[](int index);
  };
  class MyDestination {
  void Clear();
  void AddWithWeight(MySource const & value, float weight);
  void AddWithWeight(MyDestination const & value, float weight);
  };
  It is possible to implement a single interface only and use it as both source and destination.
  Primitive variable buffers are expected to be arrays of instances, passed either as direct pointers or with a container (ex. std::vector<MyVertex>). Some interpolation methods however allow passing the buffers by reference: this allows to work transparently with arrays and containers (or other schemes that overload the '[]' operator)
  See the Far tutorials for code examples.

template<class T , class U >
void | Interpolate (int level, T const &src, U &dst) const
| Apply vertex interpolation weights to a primvar buffer for a single level of refinement. More...
template<class T , class U >
void | InterpolateVarying (int level, T const &src, U &dst) const
| Apply only varying interpolation weights to a primvar buffer for a single level of refinement. More...
template<class T , class U >
void | InterpolateFaceUniform (int level, T const &src, U &dst) const
| Refine uniform (per-face) primvar data between levels. More...
template<class T , class U >
void | InterpolateFaceVarying (int level, T const &src, U &dst, int channel=0) const
| Apply face-varying interpolation weights to a primvar buffer associated with a particular face-varying channel. More...
template<class T , class U >
void | Limit (T const &src, U &dstPos) const
| Apply limit weights to a primvar buffer. More...
template<class T , class U , class U1 , class U2 >
void | Limit (T const &src, U &dstPos, U1 &dstTan1, U2 &dstTan2) const
template<class T , class U >
void | LimitFaceVarying (T const &src, U &dst, int channel=0) const

## Detailed Description

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

Applies refinement operations to generic primvar data.

Definition at line 56 of file primvarRefiner.h.

## Constructor & Destructor Documentation

## PrimvarRefinerReal()

PrimvarRefinerReal | ( | TopologyRefiner const & | refiner | ) |

inline

Definition at line 59 of file primvarRefiner.h.

## ~PrimvarRefinerReal()

~PrimvarRefinerReal | ( |  | ) |

inline

Definition at line 60 of file primvarRefiner.h.

## Member Function Documentation

## GetTopologyRefiner()

TopologyRefiner const & GetTopologyRefiner | ( |  | ) | const

inline

Definition at line 62 of file primvarRefiner.h.

## Interpolate()

void Interpolate | ( | int | level,
|  | T const & | src,
|  | U & | dst
| ) |  | const

inline

Apply vertex interpolation weights to a primvar buffer for a single level of refinement.

The destination buffer must allocate an array of data for all the refined vertices, i.e. at least refiner.GetLevel(level).GetNumVertices()

Parameters

  level | The refinement level
  src | Source primvar buffer (templating control vertex data)
  dst | Destination primvar buffer (templating refined vertex data)

Definition at line 267 of file primvarRefiner.h.

## InterpolateFaceUniform()

void InterpolateFaceUniform | ( | int | level,
|  | T const & | src,
|  | U & | dst
| ) |  | const

inline

Refine uniform (per-face) primvar data between levels.

Data is simply copied from a parent face to its child faces and does not involve any weighting. Setting the source primvar data for the base level to be the index of each face allows the propagation of the base face to primvar data for child faces in all levels.

The destination buffer must allocate an array of data for all the refined faces, i.e. at least refiner.GetLevel(level).GetNumFaces()

Parameters

  level | The refinement level
  src | Source primvar buffer
  dst | Destination primvar buffer

Definition at line 394 of file primvarRefiner.h.

## InterpolateFaceVarying()

void InterpolateFaceVarying | ( | int | level,
|  | T const & | src,
|  | U & | dst,
|  | int | channel = `0`
| ) |  | const

inline

Apply face-varying interpolation weights to a primvar buffer associated with a particular face-varying channel.

Unlike vertex and varying primvar buffers, there is not a 1-to-1 correspondence between vertices and face-varying values – typically there are more face-varying values than vertices. Each face-varying channel is also independent in how its values relate to the vertices.

The destination buffer must allocate an array of data for all the refined values, i.e. at least refiner.GetLevel(level).GetNumFVarValues(channel).

Definition at line 293 of file primvarRefiner.h.

## InterpolateVarying()

void InterpolateVarying | ( | int | level,
|  | T const & | src,
|  | U & | dst
| ) |  | const

inline

Apply only varying interpolation weights to a primvar buffer for a single level of refinement.

This method can useful if the varying primvar data does not need to be re-computed over time.

The destination buffer must allocate an array of data for all the refined vertices, i.e. at least refiner.GetLevel(level).GetNumVertices()

Parameters

  level | The refinement level
  src | Source primvar buffer (templating control vertex data)
  dst | Destination primvar buffer (templating refined vertex data)

Definition at line 412 of file primvarRefiner.h.

## Limit() [1/2]

void Limit | ( | T const & | src,
|  | U & | dstPos
| ) |  | const

inline

Apply limit weights to a primvar buffer.

The source buffer must refer to an array of previously interpolated vertex data for the last refinement level. The destination buffer must allocate an array for all vertices at the last refinement level, i.e. at least refiner.GetLevel(refiner.GetMaxLevel()).GetNumVertices()

Parameters

  src | Source primvar buffer (refined data) for last level
  dstPos | Destination primvar buffer (data at the limit)

Definition at line 319 of file primvarRefiner.h.

## Limit() [2/2]

void Limit | ( | T const & | src,
|  | U & | dstPos,
|  | U1 & | dstTan1,
|  | U2 & | dstTan2
| ) |  | const

inline

Definition at line 344 of file primvarRefiner.h.

## LimitFaceVarying()

void LimitFaceVarying | ( | T const & | src,
|  | U & | dst,
|  | int | channel = `0`
| ) |  | const

inline

Definition at line 369 of file primvarRefiner.h.

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

- opensubdiv/far/primvarRefiner.h