mirror of
https://github.com/PixarAnimationStudios/OpenSubdiv
synced 2024-11-09 22:00:06 +00:00
ca6f0feecf
This is not legal according to the C++ standard, and causes build errors when using --std=c++20
910 lines
32 KiB
C++
910 lines
32 KiB
C++
//
|
|
// Copyright 2013 Pixar
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "Apache License")
|
|
// with the following modification; you may not use this file except in
|
|
// compliance with the Apache License and the following modification to it:
|
|
// Section 6. Trademarks. is deleted and replaced with:
|
|
//
|
|
// 6. Trademarks. This License does not grant permission to use the trade
|
|
// names, trademarks, service marks, or product names of the Licensor
|
|
// and its affiliates, except as required to comply with Section 4(c) of
|
|
// the License and to reproduce the content of the NOTICE file.
|
|
//
|
|
// You may obtain a copy of the Apache License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the Apache License with the above modification is
|
|
// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
// KIND, either express or implied. See the Apache License for the specific
|
|
// language governing permissions and limitations under the Apache License.
|
|
//
|
|
|
|
#ifndef OPENSUBDIV3_FAR_PATCH_TABLE_H
|
|
#define OPENSUBDIV3_FAR_PATCH_TABLE_H
|
|
|
|
#include "../version.h"
|
|
|
|
#include "../far/patchDescriptor.h"
|
|
#include "../far/patchParam.h"
|
|
#include "../far/stencilTable.h"
|
|
|
|
#include "../sdc/options.h"
|
|
|
|
#include <vector>
|
|
|
|
namespace OpenSubdiv {
|
|
namespace OPENSUBDIV_VERSION {
|
|
|
|
namespace Far {
|
|
|
|
/// \brief Container for arrays of parametric patches
|
|
///
|
|
/// PatchTable contains topology and parametric information about the patches
|
|
/// generated by the Refinement process. Patches in the table are sorted into
|
|
/// arrays based on their PatchDescriptor Type.
|
|
///
|
|
/// Note : PatchTable can be accessed either using a PatchHandle or a
|
|
/// combination of array and patch indices.
|
|
///
|
|
/// XXXX manuelk we should add a PatchIterator that can dereference into
|
|
/// a PatchHandle for fast linear traversal of the table
|
|
///
|
|
class PatchTable {
|
|
|
|
public:
|
|
|
|
/// \brief Handle that can be used as unique patch identifier within PatchTable
|
|
class PatchHandle {
|
|
// XXXX manuelk members will eventually be made private
|
|
public:
|
|
|
|
friend class PatchTable;
|
|
friend class PatchMap;
|
|
|
|
Index arrayIndex, // Array index of the patch
|
|
patchIndex, // Absolute Index of the patch
|
|
vertIndex; // Relative offset to the first CV of the patch in array
|
|
};
|
|
|
|
public:
|
|
|
|
/// \brief Copy constructor
|
|
PatchTable(PatchTable const & src);
|
|
|
|
/// \brief Destructor
|
|
~PatchTable();
|
|
|
|
/// \brief True if the patches are of feature adaptive types
|
|
bool IsFeatureAdaptive() const;
|
|
|
|
/// \brief Returns the total number of control vertex indices in the table
|
|
int GetNumControlVerticesTotal() const {
|
|
return (int)_patchVerts.size();
|
|
}
|
|
|
|
/// \brief Returns the total number of patches stored in the table
|
|
int GetNumPatchesTotal() const;
|
|
|
|
/// \brief Returns max vertex valence
|
|
int GetMaxValence() const { return _maxValence; }
|
|
|
|
/// \brief Returns the total number of ptex faces in the mesh
|
|
int GetNumPtexFaces() const { return _numPtexFaces; }
|
|
|
|
|
|
//@{
|
|
/// @name Individual patches
|
|
///
|
|
/// \anchor individual_patches
|
|
///
|
|
/// \brief Accessors for individual patches
|
|
///
|
|
|
|
/// \brief Returns the PatchDescriptor for the patch identified by \p handle
|
|
PatchDescriptor GetPatchDescriptor(PatchHandle const & handle) const;
|
|
|
|
/// \brief Returns the control vertex indices for the patch identified by \p handle
|
|
ConstIndexArray GetPatchVertices(PatchHandle const & handle) const;
|
|
|
|
/// \brief Returns a PatchParam for the patch identified by \p handle
|
|
PatchParam GetPatchParam(PatchHandle const & handle) const;
|
|
|
|
/// \brief Returns the control vertex indices for \p patch in \p array
|
|
ConstIndexArray GetPatchVertices(int array, int patch) const;
|
|
|
|
/// \brief Returns the PatchParam for \p patch in \p array
|
|
PatchParam GetPatchParam(int array, int patch) const;
|
|
//@}
|
|
|
|
|
|
//@{
|
|
/// @name Arrays of patches
|
|
///
|
|
/// \anchor arrays_of_patches
|
|
///
|
|
/// \brief Accessors for arrays of patches of the same type
|
|
///
|
|
|
|
/// \brief Returns the number of patch arrays in the table
|
|
int GetNumPatchArrays() const;
|
|
|
|
/// \brief Returns the number of patches in \p array
|
|
int GetNumPatches(int array) const;
|
|
|
|
/// \brief Returns the number of control vertices in \p array
|
|
int GetNumControlVertices(int array) const;
|
|
|
|
/// \brief Returns the PatchDescriptor for the patches in \p array
|
|
PatchDescriptor GetPatchArrayDescriptor(int array) const;
|
|
|
|
/// \brief Returns the control vertex indices for the patches in \p array
|
|
ConstIndexArray GetPatchArrayVertices(int array) const;
|
|
|
|
/// \brief Returns the PatchParams for the patches in \p array
|
|
ConstPatchParamArray const GetPatchParams(int array) const;
|
|
//@}
|
|
|
|
|
|
//@{
|
|
/// @name Change of basis patches
|
|
///
|
|
/// \anchor change_of_basis_patches
|
|
///
|
|
/// \brief Accessors for change of basis patches
|
|
///
|
|
///
|
|
|
|
/// \brief Returns the number of local vertex points.
|
|
int GetNumLocalPoints() const;
|
|
|
|
/// \brief Returns the stencil table to compute local point vertex values
|
|
StencilTable const *GetLocalPointStencilTable() const;
|
|
|
|
/// \brief Returns the stencil table to compute local point vertex values
|
|
template <typename REAL>
|
|
StencilTableReal<REAL> const *GetLocalPointStencilTable() const;
|
|
|
|
/// \brief Tests if the precision of the stencil table to compute local point
|
|
/// vertex values matches the given floating point type \<REAL\>.
|
|
template <typename REAL> bool LocalPointStencilPrecisionMatchesType() const;
|
|
|
|
/// \brief Updates local point vertex values.
|
|
///
|
|
/// @param src Buffer with primvar data for the base and refined
|
|
/// vertex values
|
|
///
|
|
/// @param dst Destination buffer for the computed local point
|
|
/// vertex values
|
|
///
|
|
/// For more flexibility computing local vertex points, retrieval of
|
|
/// the local point stencil table and use of its public methods is
|
|
/// recommended or often required.
|
|
///
|
|
template <class T> void
|
|
ComputeLocalPointValues(T const *src, T *dst) const;
|
|
|
|
|
|
/// \brief Returns the number of local varying points.
|
|
int GetNumLocalPointsVarying() const;
|
|
|
|
/// \brief Returns the stencil table to compute local point varying values
|
|
StencilTable const *GetLocalPointVaryingStencilTable() const;
|
|
|
|
/// \brief Returns the stencil table to compute local point varying values
|
|
template <typename REAL>
|
|
StencilTableReal<REAL> const *GetLocalPointVaryingStencilTable() const;
|
|
|
|
/// \brief Tests if the precision of the stencil table to compute local point
|
|
/// varying values matches the given floating point type \<REAL\>.
|
|
template <typename REAL> bool LocalPointVaryingStencilPrecisionMatchesType() const;
|
|
|
|
/// \brief Updates local point varying values.
|
|
///
|
|
/// @param src Buffer with primvar data for the base and refined
|
|
/// varying values
|
|
///
|
|
/// @param dst Destination buffer for the computed local point
|
|
/// varying values
|
|
///
|
|
/// For more flexibility computing local varying points, retrieval of
|
|
/// the local point varying stencil table and use of its public methods
|
|
/// is recommended or often required.
|
|
///
|
|
template <class T> void
|
|
ComputeLocalPointValuesVarying(T const *src, T *dst) const;
|
|
|
|
|
|
/// \brief Returns the number of local face-varying points for \p channel
|
|
int GetNumLocalPointsFaceVarying(int channel = 0) const;
|
|
|
|
/// \brief Returns the stencil table to compute local point face-varying values
|
|
StencilTable const *GetLocalPointFaceVaryingStencilTable(int channel = 0) const;
|
|
|
|
/// \brief Returns the stencil table to compute local point face-varying values
|
|
template <typename REAL>
|
|
StencilTableReal<REAL> const * GetLocalPointFaceVaryingStencilTable(int channel = 0) const;
|
|
|
|
/// \brief Tests if the precision of the stencil table to compute local point
|
|
/// face-varying values matches the given floating point type \<REAL\>.
|
|
template <typename REAL> bool LocalPointFaceVaryingStencilPrecisionMatchesType() const;
|
|
|
|
/// \brief Updates local point face-varying values.
|
|
///
|
|
/// @param src Buffer with primvar data for the base and refined
|
|
/// face-varying values
|
|
///
|
|
/// @param dst Destination buffer for the computed local point
|
|
/// face-varying values
|
|
///
|
|
/// @param channel face-varying channel
|
|
///
|
|
/// For more flexibility computing local face-varying points, retrieval
|
|
/// of the local point face-varying stencil table and use of its public
|
|
/// methods is recommended or often required.
|
|
///
|
|
template <class T> void
|
|
ComputeLocalPointValuesFaceVarying(T const *src, T *dst, int channel = 0) const;
|
|
//@}
|
|
|
|
|
|
//@{
|
|
/// @name Legacy gregory patch evaluation buffers
|
|
|
|
/// \brief Accessors for the gregory patch evaluation buffers.
|
|
/// These methods will be deprecated.
|
|
///
|
|
typedef Vtr::ConstArray<unsigned int> ConstQuadOffsetsArray;
|
|
|
|
/// \brief Returns the 'QuadOffsets' for the Gregory patch identified by \p handle
|
|
ConstQuadOffsetsArray GetPatchQuadOffsets(PatchHandle const & handle) const;
|
|
|
|
typedef std::vector<Index> VertexValenceTable;
|
|
|
|
/// \brief Returns the 'VertexValences' table (vertex neighborhoods table)
|
|
VertexValenceTable const & GetVertexValenceTable() const {
|
|
return _vertexValenceTable;
|
|
}
|
|
//@}
|
|
|
|
|
|
//@{
|
|
/// @name Single-crease patches
|
|
///
|
|
/// \anchor single_crease_patches
|
|
///
|
|
/// \brief Accessors for single-crease patch edge sharpness
|
|
///
|
|
|
|
/// \brief Returns the crease sharpness for the patch identified by \p handle
|
|
/// if it is a single-crease patch, or 0.0f
|
|
float GetSingleCreasePatchSharpnessValue(PatchHandle const & handle) const;
|
|
|
|
/// \brief Returns the crease sharpness for the \p patch in \p array
|
|
/// if it is a single-crease patch, or 0.0f
|
|
float GetSingleCreasePatchSharpnessValue(int array, int patch) const;
|
|
//@}
|
|
|
|
|
|
//@{
|
|
/// @name Varying data
|
|
///
|
|
/// \anchor varying_data
|
|
///
|
|
/// \brief Accessors for varying data
|
|
///
|
|
|
|
/// \brief Returns the varying patch descriptor
|
|
PatchDescriptor GetVaryingPatchDescriptor() const;
|
|
|
|
/// \brief Returns the varying vertex indices for a given patch
|
|
ConstIndexArray GetPatchVaryingVertices(PatchHandle const & handle) const;
|
|
|
|
/// \brief Returns the varying vertex indices for a given patch
|
|
ConstIndexArray GetPatchVaryingVertices(int array, int patch) const;
|
|
|
|
/// \brief Returns the varying vertex indices for the patches in \p array
|
|
ConstIndexArray GetPatchArrayVaryingVertices(int array) const;
|
|
|
|
/// \brief Returns an array of varying vertex indices for the patches.
|
|
ConstIndexArray GetVaryingVertices() const;
|
|
//@}
|
|
|
|
|
|
//@{
|
|
/// @name Face-varying channels
|
|
///
|
|
/// \anchor face_varying_channels
|
|
///
|
|
/// \brief Accessors for face-varying channels
|
|
///
|
|
|
|
/// \brief Returns the number of face-varying channels
|
|
int GetNumFVarChannels() const;
|
|
|
|
/// \brief Returns the regular patch descriptor for \p channel
|
|
PatchDescriptor GetFVarPatchDescriptorRegular(int channel = 0) const;
|
|
|
|
/// \brief Returns the irregular patch descriptor for \p channel
|
|
PatchDescriptor GetFVarPatchDescriptorIrregular(int channel = 0) const;
|
|
|
|
/// \brief Returns the default/irregular patch descriptor for \p channel
|
|
PatchDescriptor GetFVarPatchDescriptor(int channel = 0) const;
|
|
|
|
/// \brief Returns the value indices for a given patch in \p channel
|
|
ConstIndexArray GetPatchFVarValues(PatchHandle const & handle, int channel = 0) const;
|
|
|
|
/// \brief Returns the value indices for a given patch in \p channel
|
|
ConstIndexArray GetPatchFVarValues(int array, int patch, int channel = 0) const;
|
|
|
|
/// \brief Returns the value indices for the patches in \p array in \p channel
|
|
ConstIndexArray GetPatchArrayFVarValues(int array, int channel = 0) const;
|
|
|
|
/// \brief Returns an array of value indices for the patches in \p channel
|
|
ConstIndexArray GetFVarValues(int channel = 0) const;
|
|
|
|
/// \brief Returns the stride between patches in the value index array of \p channel
|
|
int GetFVarValueStride(int channel = 0) const;
|
|
|
|
/// \brief Returns the value indices for a given patch in \p channel
|
|
PatchParam GetPatchFVarPatchParam(PatchHandle const & handle, int channel = 0) const;
|
|
|
|
/// \brief Returns the face-varying params for a given patch \p channel
|
|
PatchParam GetPatchFVarPatchParam(int array, int patch, int channel = 0) const;
|
|
|
|
/// \brief Returns the face-varying for a given patch in \p array in \p channel
|
|
ConstPatchParamArray GetPatchArrayFVarPatchParams(int array, int channel = 0) const;
|
|
|
|
/// \brief Returns an array of face-varying patch param for \p channel
|
|
ConstPatchParamArray GetFVarPatchParams(int channel = 0) const;
|
|
|
|
/// \brief Deprecated @see PatchTable#GetFVarPatchDescriptor
|
|
Sdc::Options::FVarLinearInterpolation GetFVarChannelLinearInterpolation(int channel = 0) const;
|
|
//@}
|
|
|
|
|
|
//@{
|
|
/// @name Direct accessors
|
|
///
|
|
/// \warning These direct accessors are left for convenience, but they are
|
|
/// likely going to be deprecated in future releases
|
|
///
|
|
|
|
typedef std::vector<Index> PatchVertsTable;
|
|
|
|
/// \brief Get the table of patch control vertices
|
|
PatchVertsTable const & GetPatchControlVerticesTable() const { return _patchVerts; }
|
|
|
|
/// \brief Returns the PatchParamTable (PatchParams order matches patch array sorting)
|
|
PatchParamTable const & GetPatchParamTable() const { return _paramTable; }
|
|
|
|
/// \brief Returns a sharpness index table for each patch (if exists)
|
|
std::vector<Index> const &GetSharpnessIndexTable() const { return _sharpnessIndices; }
|
|
|
|
/// \brief Returns sharpness values table
|
|
std::vector<float> const &GetSharpnessValues() const { return _sharpnessValues; }
|
|
|
|
typedef std::vector<unsigned int> QuadOffsetsTable;
|
|
|
|
/// \brief Returns the quad-offsets table
|
|
QuadOffsetsTable const & GetQuadOffsetsTable() const {
|
|
return _quadOffsetsTable;
|
|
}
|
|
//@}
|
|
|
|
/// debug helper
|
|
void print() const;
|
|
|
|
public:
|
|
|
|
//@{
|
|
/// @name Evaluation methods
|
|
///
|
|
|
|
/// \brief Evaluate basis functions for position and derivatives at a
|
|
/// given (u,v) parametric location of a patch.
|
|
///
|
|
/// @param handle A patch handle identifying the sub-patch containing the
|
|
/// (u,v) location
|
|
///
|
|
/// @param u Patch coordinate (in base face normalized space)
|
|
///
|
|
/// @param v Patch coordinate (in base face normalized space)
|
|
///
|
|
/// @param wP Weights (evaluated basis functions) for the position
|
|
///
|
|
/// @param wDu Weights (evaluated basis functions) for derivative wrt u
|
|
///
|
|
/// @param wDv Weights (evaluated basis functions) for derivative wrt v
|
|
///
|
|
/// @param wDuu Weights (evaluated basis functions) for 2nd derivative wrt u
|
|
///
|
|
/// @param wDuv Weights (evaluated basis functions) for 2nd derivative wrt u and v
|
|
///
|
|
/// @param wDvv Weights (evaluated basis functions) for 2nd derivative wrt v
|
|
///
|
|
template <typename REAL>
|
|
void EvaluateBasis(PatchHandle const & handle, REAL u, REAL v,
|
|
REAL wP[], REAL wDu[] = 0, REAL wDv[] = 0,
|
|
REAL wDuu[] = 0, REAL wDuv[] = 0, REAL wDvv[] = 0) const;
|
|
|
|
/// \brief An overloaded version to assist template parameter resolution
|
|
/// when explicitly declaring unused array arguments as 0.
|
|
void EvaluateBasis(PatchHandle const & handle, float u, float v,
|
|
float wP[], float wDu[] = 0, float wDv[] = 0,
|
|
float wDuu[] = 0, float wDuv[] = 0, float wDvv[] = 0) const;
|
|
|
|
/// \brief An overloaded version to assist template parameter resolution
|
|
/// when explicitly declaring unused array arguments as 0.
|
|
void EvaluateBasis(PatchHandle const & handle, double u, double v,
|
|
double wP[], double wDu[] = 0, double wDv[] = 0,
|
|
double wDuu[] = 0, double wDuv[] = 0, double wDvv[] = 0) const;
|
|
|
|
/// \brief Evaluate basis functions for a varying value and
|
|
/// derivatives at a given (u,v) parametric location of a patch.
|
|
///
|
|
/// @param handle A patch handle identifying the sub-patch containing the
|
|
/// (u,v) location
|
|
///
|
|
/// @param u Patch coordinate (in base face normalized space)
|
|
///
|
|
/// @param v Patch coordinate (in base face normalized space)
|
|
///
|
|
/// @param wP Weights (evaluated basis functions) for the position
|
|
///
|
|
/// @param wDu Weights (evaluated basis functions) for derivative wrt u
|
|
///
|
|
/// @param wDv Weights (evaluated basis functions) for derivative wrt v
|
|
///
|
|
/// @param wDuu Weights (evaluated basis functions) for 2nd derivative wrt u
|
|
///
|
|
/// @param wDuv Weights (evaluated basis functions) for 2nd derivative wrt u and v
|
|
///
|
|
/// @param wDvv Weights (evaluated basis functions) for 2nd derivative wrt v
|
|
///
|
|
template <typename REAL>
|
|
void EvaluateBasisVarying(PatchHandle const & handle, REAL u, REAL v,
|
|
REAL wP[], REAL wDu[] = 0, REAL wDv[] = 0,
|
|
REAL wDuu[] = 0, REAL wDuv[] = 0, REAL wDvv[] = 0) const;
|
|
|
|
/// \brief An overloaded version to assist template parameter resolution
|
|
/// when explicitly declaring unused array arguments as 0.
|
|
void EvaluateBasisVarying(PatchHandle const & handle, float u, float v,
|
|
float wP[], float wDu[] = 0, float wDv[] = 0,
|
|
float wDuu[] = 0, float wDuv[] = 0, float wDvv[] = 0) const;
|
|
|
|
/// \brief An overloaded version to assist template parameter resolution
|
|
/// when explicitly declaring unused array arguments as 0.
|
|
void EvaluateBasisVarying(PatchHandle const & handle, double u, double v,
|
|
double wP[], double wDu[] = 0, double wDv[] = 0,
|
|
double wDuu[] = 0, double wDuv[] = 0, double wDvv[] = 0) const;
|
|
|
|
/// \brief Evaluate basis functions for a face-varying value and
|
|
/// derivatives at a given (u,v) parametric location of a patch.
|
|
///
|
|
/// @param handle A patch handle identifying the sub-patch containing the
|
|
/// (u,v) location
|
|
///
|
|
/// @param u Patch coordinate (in base face normalized space)
|
|
///
|
|
/// @param v Patch coordinate (in base face normalized space)
|
|
///
|
|
/// @param wP Weights (evaluated basis functions) for the position
|
|
///
|
|
/// @param wDu Weights (evaluated basis functions) for derivative wrt u
|
|
///
|
|
/// @param wDv Weights (evaluated basis functions) for derivative wrt v
|
|
///
|
|
/// @param wDuu Weights (evaluated basis functions) for 2nd derivative wrt u
|
|
///
|
|
/// @param wDuv Weights (evaluated basis functions) for 2nd derivative wrt u and v
|
|
///
|
|
/// @param wDvv Weights (evaluated basis functions) for 2nd derivative wrt v
|
|
///
|
|
/// @param channel face-varying channel
|
|
///
|
|
template <typename REAL>
|
|
void EvaluateBasisFaceVarying(PatchHandle const & handle, REAL u, REAL v,
|
|
REAL wP[], REAL wDu[] = 0, REAL wDv[] = 0,
|
|
REAL wDuu[] = 0, REAL wDuv[] = 0, REAL wDvv[] = 0,
|
|
int channel = 0) const;
|
|
|
|
/// \brief An overloaded version to assist template parameter resolution
|
|
/// when explicitly declaring unused array arguments as 0.
|
|
void EvaluateBasisFaceVarying(PatchHandle const & handle, float u, float v,
|
|
float wP[], float wDu[] = 0, float wDv[] = 0,
|
|
float wDuu[] = 0, float wDuv[] = 0, float wDvv[] = 0,
|
|
int channel = 0) const;
|
|
|
|
/// \brief An overloaded version to assist template parameter resolution
|
|
/// when explicitly declaring unused array arguments as 0.
|
|
void EvaluateBasisFaceVarying(PatchHandle const & handle, double u, double v,
|
|
double wP[], double wDu[] = 0, double wDv[] = 0,
|
|
double wDuu[] = 0, double wDuv[] = 0, double wDvv[] = 0,
|
|
int channel = 0) const;
|
|
//@}
|
|
|
|
protected:
|
|
|
|
friend class PatchTableBuilder;
|
|
|
|
// Factory constructor
|
|
PatchTable(int maxvalence);
|
|
|
|
Index getPatchIndex(int array, int patch) const;
|
|
|
|
PatchParamArray getPatchParams(int arrayIndex);
|
|
|
|
Index * getSharpnessIndices(Index arrayIndex);
|
|
float * getSharpnessValues(Index arrayIndex);
|
|
|
|
private:
|
|
|
|
//
|
|
// Patch arrays
|
|
//
|
|
struct PatchArray {
|
|
PatchArray(PatchDescriptor d, int np, Index v, Index p, Index qo) :
|
|
desc(d), numPatches(np), vertIndex(v),
|
|
patchIndex(p), quadOffsetIndex (qo) { }
|
|
|
|
void print() const;
|
|
|
|
PatchDescriptor desc; // type of patches in the array
|
|
|
|
int numPatches; // number of patches in the array
|
|
|
|
Index vertIndex, // index to the first control vertex
|
|
patchIndex, // absolute index of the first patch in the array
|
|
quadOffsetIndex; // index of the first quad offset entry
|
|
};
|
|
|
|
typedef std::vector<PatchArray> PatchArrayVector;
|
|
|
|
PatchArray & getPatchArray(Index arrayIndex);
|
|
PatchArray const & getPatchArray(Index arrayIndex) const;
|
|
|
|
void reservePatchArrays(int numPatchArrays);
|
|
void pushPatchArray(PatchDescriptor desc, int npatches,
|
|
Index * vidx, Index * pidx, Index * qoidx=0);
|
|
|
|
IndexArray getPatchArrayVertices(int arrayIndex);
|
|
|
|
Index findPatchArray(PatchDescriptor desc);
|
|
|
|
|
|
//
|
|
// Varying patch arrays
|
|
//
|
|
IndexArray getPatchArrayVaryingVertices(int arrayIndex);
|
|
|
|
void allocateVaryingVertices(
|
|
PatchDescriptor desc, int numPatches);
|
|
void populateVaryingVertices();
|
|
|
|
//
|
|
// Face-varying patch channels
|
|
//
|
|
|
|
//
|
|
// FVarPatchChannel
|
|
//
|
|
// Stores a record for each patch in the primitive :
|
|
//
|
|
// - Each patch in the PatchTable has a corresponding patch in each
|
|
// face-varying patch channel. Patch vertex indices are sorted in the same
|
|
// patch-type order as PatchTable::PTables. Face-varying data for a patch
|
|
// can therefore be quickly accessed by using the patch primitive ID as
|
|
// index into patchValueOffsets to locate the face-varying control vertex
|
|
// indices.
|
|
//
|
|
// - Face-varying channels can have a different interpolation modes
|
|
//
|
|
// - Unlike "vertex" patches, there are no transition masks required
|
|
// for face-varying patches.
|
|
//
|
|
// - Face-varying patches still require boundary edge masks.
|
|
//
|
|
// - currently most patches with sharp boundaries but smooth interiors have
|
|
// to be isolated to level 10 : we need a special type of bicubic patch
|
|
// similar to single-crease to resolve this condition without requiring
|
|
// isolation if possible
|
|
//
|
|
struct FVarPatchChannel {
|
|
Sdc::Options::FVarLinearInterpolation interpolation;
|
|
|
|
PatchDescriptor regDesc;
|
|
PatchDescriptor irregDesc;
|
|
|
|
int stride;
|
|
|
|
std::vector<Index> patchValues;
|
|
std::vector<PatchParam> patchParam;
|
|
};
|
|
typedef std::vector<FVarPatchChannel> FVarPatchChannelVector;
|
|
|
|
FVarPatchChannel & getFVarPatchChannel(int channel);
|
|
FVarPatchChannel const & getFVarPatchChannel(int channel) const;
|
|
|
|
void allocateFVarPatchChannels(int numChannels);
|
|
void allocateFVarPatchChannelValues(
|
|
PatchDescriptor regDesc, PatchDescriptor irregDesc,
|
|
int numPatches, int channel);
|
|
|
|
// deprecated
|
|
void setFVarPatchChannelLinearInterpolation(
|
|
Sdc::Options::FVarLinearInterpolation interpolation, int channel);
|
|
|
|
IndexArray getFVarValues(int channel);
|
|
ConstIndexArray getPatchFVarValues(int patch, int channel) const;
|
|
|
|
PatchParamArray getFVarPatchParams(int channel);
|
|
PatchParam getPatchFVarPatchParam(int patch, int channel) const;
|
|
|
|
private:
|
|
//
|
|
// Simple private class to hold stencil table pointers of varying precision,
|
|
// where the discriminant of the precision is external.
|
|
//
|
|
// NOTE that this is a simple pointer container and NOT a smart pointer that
|
|
// manages the ownership of the object referred to by it.
|
|
//
|
|
class StencilTablePtr {
|
|
private:
|
|
typedef StencilTableReal<float> float_type;
|
|
typedef StencilTableReal<double> double_type;
|
|
|
|
union {
|
|
float_type * _fPtr;
|
|
double_type * _dPtr;
|
|
};
|
|
|
|
public:
|
|
StencilTablePtr() { _fPtr = 0; }
|
|
StencilTablePtr(float_type * ptr) { _fPtr = ptr; }
|
|
StencilTablePtr(double_type * ptr) { _dPtr = ptr; }
|
|
|
|
operator bool() const { return _fPtr != 0; }
|
|
|
|
void Set() { _fPtr = 0; }
|
|
void Set(float_type * ptr) { _fPtr = ptr; }
|
|
void Set(double_type * ptr) { _dPtr = ptr; }
|
|
|
|
template <typename REAL> StencilTableReal<REAL> * Get() const;
|
|
};
|
|
|
|
private:
|
|
|
|
//
|
|
// Topology
|
|
//
|
|
|
|
int _maxValence, // highest vertex valence found in the mesh
|
|
_numPtexFaces; // total number of ptex faces
|
|
|
|
PatchArrayVector _patchArrays; // Vector of descriptors for arrays of patches
|
|
|
|
std::vector<Index> _patchVerts; // Indices of the control vertices of the patches
|
|
|
|
PatchParamTable _paramTable; // PatchParam bitfields (one per patch)
|
|
|
|
//
|
|
// Extraordinary vertex closed-form evaluation / endcap basis conversion
|
|
//
|
|
// XXXtakahito: these data will probably be replaced with mask coefficient or something
|
|
// SchemeWorker populates.
|
|
//
|
|
QuadOffsetsTable _quadOffsetsTable; // Quad offsets (for Gregory patches)
|
|
VertexValenceTable _vertexValenceTable; // Vertex valence table (for Gregory patches)
|
|
|
|
StencilTablePtr _localPointStencils; // local point conversion stencils
|
|
StencilTablePtr _localPointVaryingStencils; // local point varying stencils
|
|
|
|
//
|
|
// Varying data
|
|
//
|
|
PatchDescriptor _varyingDesc;
|
|
|
|
std::vector<Index> _varyingVerts;
|
|
|
|
//
|
|
// Face-varying data
|
|
//
|
|
FVarPatchChannelVector _fvarChannels;
|
|
|
|
std::vector<StencilTablePtr> _localPointFaceVaryingStencils;
|
|
|
|
//
|
|
// 'single-crease' patch sharpness tables
|
|
//
|
|
std::vector<Index> _sharpnessIndices; // Indices of single-crease sharpness (one per patch)
|
|
std::vector<float> _sharpnessValues; // Sharpness values.
|
|
|
|
//
|
|
// Construction history -- relevant to at least one public query:
|
|
//
|
|
unsigned int _isUniformLinear : 1;
|
|
|
|
//
|
|
// Precision -- only applies to local-point stencil tables
|
|
//
|
|
unsigned int _vertexPrecisionIsDouble : 1;
|
|
unsigned int _varyingPrecisionIsDouble : 1;
|
|
unsigned int _faceVaryingPrecisionIsDouble : 1;
|
|
};
|
|
|
|
|
|
//
|
|
// Template specializations for float/double -- to be defined before used:
|
|
//
|
|
template <> inline StencilTableReal<float> *
|
|
PatchTable::StencilTablePtr::Get<float>() const { return _fPtr; }
|
|
|
|
template <> inline StencilTableReal<double> *
|
|
PatchTable::StencilTablePtr::Get<double>() const { return _dPtr; }
|
|
|
|
template <> inline bool
|
|
PatchTable::LocalPointStencilPrecisionMatchesType<float>() const {
|
|
return !_vertexPrecisionIsDouble;
|
|
}
|
|
template <> inline bool
|
|
PatchTable::LocalPointVaryingStencilPrecisionMatchesType<float>() const {
|
|
return !_varyingPrecisionIsDouble;
|
|
}
|
|
template <> inline bool
|
|
PatchTable::LocalPointFaceVaryingStencilPrecisionMatchesType<float>() const {
|
|
return !_faceVaryingPrecisionIsDouble;
|
|
}
|
|
|
|
template <> inline bool
|
|
PatchTable::LocalPointStencilPrecisionMatchesType<double>() const {
|
|
return _vertexPrecisionIsDouble;
|
|
}
|
|
template <> inline bool
|
|
PatchTable::LocalPointVaryingStencilPrecisionMatchesType<double>() const {
|
|
return _varyingPrecisionIsDouble;
|
|
}
|
|
template <> inline bool
|
|
PatchTable::LocalPointFaceVaryingStencilPrecisionMatchesType<double>() const {
|
|
return _faceVaryingPrecisionIsDouble;
|
|
}
|
|
|
|
//
|
|
// StencilTable access -- backward compatible and generic:
|
|
//
|
|
inline StencilTable const *
|
|
PatchTable::GetLocalPointStencilTable() const {
|
|
assert(LocalPointStencilPrecisionMatchesType<float>());
|
|
return static_cast<StencilTable const *>(_localPointStencils.Get<float>());
|
|
}
|
|
inline StencilTable const *
|
|
PatchTable::GetLocalPointVaryingStencilTable() const {
|
|
assert(LocalPointVaryingStencilPrecisionMatchesType<float>());
|
|
return static_cast<StencilTable const *>(
|
|
_localPointVaryingStencils.Get<float>());
|
|
}
|
|
inline StencilTable const *
|
|
PatchTable::GetLocalPointFaceVaryingStencilTable(int channel) const {
|
|
assert(LocalPointFaceVaryingStencilPrecisionMatchesType<float>());
|
|
if (channel >= 0 && channel < (int)_localPointFaceVaryingStencils.size()) {
|
|
return static_cast<StencilTable const *>(
|
|
_localPointFaceVaryingStencils[channel].Get<float>());
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
template <typename REAL>
|
|
inline StencilTableReal<REAL> const *
|
|
PatchTable::GetLocalPointStencilTable() const {
|
|
assert(LocalPointStencilPrecisionMatchesType<REAL>());
|
|
return _localPointStencils.Get<REAL>();
|
|
}
|
|
template <typename REAL>
|
|
inline StencilTableReal<REAL> const *
|
|
PatchTable::GetLocalPointVaryingStencilTable() const {
|
|
assert(LocalPointVaryingStencilPrecisionMatchesType<REAL>());
|
|
return _localPointVaryingStencils.Get<REAL>();
|
|
}
|
|
template <typename REAL>
|
|
inline StencilTableReal<REAL> const *
|
|
PatchTable::GetLocalPointFaceVaryingStencilTable(int channel) const {
|
|
assert(LocalPointFaceVaryingStencilPrecisionMatchesType<REAL>());
|
|
if (channel >= 0 && channel < (int)_localPointFaceVaryingStencils.size()) {
|
|
return _localPointFaceVaryingStencils[channel].Get<REAL>();
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
|
|
//
|
|
// Computation of local point values:
|
|
//
|
|
template <class T>
|
|
inline void
|
|
PatchTable::ComputeLocalPointValues(T const *src, T *dst) const {
|
|
assert(LocalPointStencilPrecisionMatchesType<float>());
|
|
if (_localPointStencils) {
|
|
_localPointStencils.Get<float>()->UpdateValues(src, dst);
|
|
}
|
|
}
|
|
|
|
template <class T>
|
|
inline void
|
|
PatchTable::ComputeLocalPointValuesVarying(T const *src, T *dst) const {
|
|
assert(LocalPointVaryingStencilPrecisionMatchesType<float>());
|
|
if (_localPointVaryingStencils) {
|
|
_localPointVaryingStencils.Get<float>()->UpdateValues(src, dst);
|
|
}
|
|
}
|
|
|
|
template <class T>
|
|
inline void
|
|
PatchTable::ComputeLocalPointValuesFaceVarying(T const *src, T *dst, int channel) const {
|
|
assert(LocalPointFaceVaryingStencilPrecisionMatchesType<float>());
|
|
if (channel >= 0 && channel < (int)_localPointFaceVaryingStencils.size()) {
|
|
if (_localPointFaceVaryingStencils[channel]) {
|
|
_localPointFaceVaryingStencils[channel].Get<float>()->UpdateValues(src, dst);
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
//
|
|
// Basis evaluation overloads
|
|
//
|
|
inline void
|
|
PatchTable::EvaluateBasis(PatchHandle const & handle, float u, float v,
|
|
float wP[], float wDu[], float wDv[],
|
|
float wDuu[], float wDuv[], float wDvv[]) const {
|
|
|
|
EvaluateBasis<float>(handle, u, v, wP, wDu, wDv, wDuu, wDuv, wDvv);
|
|
}
|
|
inline void
|
|
PatchTable::EvaluateBasis(PatchHandle const & handle, double u, double v,
|
|
double wP[], double wDu[], double wDv[],
|
|
double wDuu[], double wDuv[], double wDvv[]) const {
|
|
|
|
EvaluateBasis<double>(handle, u, v, wP, wDu, wDv, wDuu, wDuv, wDvv);
|
|
}
|
|
|
|
inline void
|
|
PatchTable::EvaluateBasisVarying(PatchHandle const & handle, float u, float v,
|
|
float wP[], float wDu[], float wDv[],
|
|
float wDuu[], float wDuv[], float wDvv[]) const {
|
|
|
|
EvaluateBasisVarying<float>(handle, u, v, wP, wDu, wDv, wDuu, wDuv, wDvv);
|
|
}
|
|
inline void
|
|
PatchTable::EvaluateBasisVarying(PatchHandle const & handle, double u, double v,
|
|
double wP[], double wDu[], double wDv[],
|
|
double wDuu[], double wDuv[], double wDvv[]) const {
|
|
|
|
EvaluateBasisVarying<double>(handle, u, v, wP, wDu, wDv, wDuu, wDuv, wDvv);
|
|
}
|
|
|
|
inline void
|
|
PatchTable::EvaluateBasisFaceVarying(PatchHandle const & handle, float u, float v,
|
|
float wP[], float wDu[], float wDv[],
|
|
float wDuu[], float wDuv[], float wDvv[], int channel) const {
|
|
|
|
EvaluateBasisFaceVarying<float>(handle, u, v, wP, wDu, wDv, wDuu, wDuv, wDvv, channel);
|
|
}
|
|
inline void
|
|
PatchTable::EvaluateBasisFaceVarying(PatchHandle const & handle, double u, double v,
|
|
double wP[], double wDu[], double wDv[],
|
|
double wDuu[], double wDuv[], double wDvv[], int channel) const {
|
|
|
|
EvaluateBasisFaceVarying<double>(handle, u, v, wP, wDu, wDv, wDuu, wDuv, wDvv, channel);
|
|
}
|
|
|
|
} // end namespace Far
|
|
|
|
} // end namespace OPENSUBDIV_VERSION
|
|
using namespace OPENSUBDIV_VERSION;
|
|
|
|
} // end namespace OpenSubdiv
|
|
|
|
#endif /* OPENSUBDIV3_FAR_PATCH_TABLE */
|