mirror of
https://github.com/PixarAnimationStudios/OpenSubdiv
synced 2024-11-25 13:00:07 +00:00
7fd99b421f
Also reformatting a chunk of FAR's comments to work w/ doxygen. Closes #75
249 lines
11 KiB
C++
249 lines
11 KiB
C++
//
|
|
// Copyright (C) Pixar. All rights reserved.
|
|
//
|
|
// This license governs use of the accompanying software. If you
|
|
// use the software, you accept this license. If you do not accept
|
|
// the license, do not use the software.
|
|
//
|
|
// 1. Definitions
|
|
// The terms "reproduce," "reproduction," "derivative works," and
|
|
// "distribution" have the same meaning here as under U.S.
|
|
// copyright law. A "contribution" is the original software, or
|
|
// any additions or changes to the software.
|
|
// A "contributor" is any person or entity that distributes its
|
|
// contribution under this license.
|
|
// "Licensed patents" are a contributor's patent claims that read
|
|
// directly on its contribution.
|
|
//
|
|
// 2. Grant of Rights
|
|
// (A) Copyright Grant- Subject to the terms of this license,
|
|
// including the license conditions and limitations in section 3,
|
|
// each contributor grants you a non-exclusive, worldwide,
|
|
// royalty-free copyright license to reproduce its contribution,
|
|
// prepare derivative works of its contribution, and distribute
|
|
// its contribution or any derivative works that you create.
|
|
// (B) Patent Grant- Subject to the terms of this license,
|
|
// including the license conditions and limitations in section 3,
|
|
// each contributor grants you a non-exclusive, worldwide,
|
|
// royalty-free license under its licensed patents to make, have
|
|
// made, use, sell, offer for sale, import, and/or otherwise
|
|
// dispose of its contribution in the software or derivative works
|
|
// of the contribution in the software.
|
|
//
|
|
// 3. Conditions and Limitations
|
|
// (A) No Trademark License- This license does not grant you
|
|
// rights to use any contributor's name, logo, or trademarks.
|
|
// (B) If you bring a patent claim against any contributor over
|
|
// patents that you claim are infringed by the software, your
|
|
// patent license from such contributor to the software ends
|
|
// automatically.
|
|
// (C) If you distribute any portion of the software, you must
|
|
// retain all copyright, patent, trademark, and attribution
|
|
// notices that are present in the software.
|
|
// (D) If you distribute any portion of the software in source
|
|
// code form, you may do so only under this license by including a
|
|
// complete copy of this license with your distribution. If you
|
|
// distribute any portion of the software in compiled or object
|
|
// code form, you may only do so under a license that complies
|
|
// with this license.
|
|
// (E) The software is licensed "as-is." You bear the risk of
|
|
// using it. The contributors give no express warranties,
|
|
// guarantees or conditions. You may have additional consumer
|
|
// rights under your local laws which this license cannot change.
|
|
// To the extent permitted under your local laws, the contributors
|
|
// exclude the implied warranties of merchantability, fitness for
|
|
// a particular purpose and non-infringement.
|
|
//
|
|
#ifndef FAR_DISPATCHER_H
|
|
#define FAR_DISPATCHER_H
|
|
|
|
#include "../version.h"
|
|
|
|
#include "../far/mesh.h"
|
|
#include "../far/bilinearSubdivisionTables.h"
|
|
#include "../far/catmarkSubdivisionTables.h"
|
|
#include "../far/loopSubdivisionTables.h"
|
|
#include "../far/vertexEditTables.h"
|
|
|
|
namespace OpenSubdiv {
|
|
namespace OPENSUBDIV_VERSION {
|
|
|
|
/// \brief Subdivision process encapsulation layer.
|
|
///
|
|
/// The Compute dispatcher allows client code to customize parts or the entire
|
|
/// computation process. This pattern aims at hiding the logic specific to
|
|
/// the subdivision algorithms and expose a simplified access to minimalistic
|
|
/// compute kernels. By default, meshes revert to a default dispatcher that
|
|
/// implements single-threaded CPU kernels.
|
|
///
|
|
/// - derive a dispatcher class from this one
|
|
/// - override the virtual functions
|
|
/// - pass the derived dispatcher to the factory (one instance can be shared by many meshes)
|
|
/// - call the FarMesh::Subdivide() to trigger computations
|
|
///
|
|
/// Note : the caller is responsible for deleting a custom dispatcher
|
|
///
|
|
template <class U> class FarDispatcher {
|
|
|
|
protected:
|
|
template <class X, class Y> friend class FarMeshFactory;
|
|
friend class FarBilinearSubdivisionTables<U>;
|
|
friend class FarCatmarkSubdivisionTables<U>;
|
|
friend class FarLoopSubdivisionTables<U>;
|
|
friend class FarVertexEditTables<U>;
|
|
friend class FarMesh<U>;
|
|
|
|
virtual void Refine(FarMesh<U> * mesh, int maxlevel, void * clientdata=0) const;
|
|
|
|
|
|
virtual void ApplyBilinearFaceVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
virtual void ApplyBilinearEdgeVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
virtual void ApplyBilinearVertexVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
|
|
virtual void ApplyCatmarkFaceVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
virtual void ApplyCatmarkEdgeVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
virtual void ApplyCatmarkVertexVerticesKernelB(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
virtual void ApplyCatmarkVertexVerticesKernelA(FarMesh<U> * mesh, int offset, bool pass, int level, int start, int end, void * clientdata) const;
|
|
|
|
|
|
virtual void ApplyLoopEdgeVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
virtual void ApplyLoopVertexVerticesKernelB(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const;
|
|
|
|
virtual void ApplyLoopVertexVerticesKernelA(FarMesh<U> * mesh, int offset, bool pass, int level, int start, int end, void * clientdata) const;
|
|
|
|
|
|
virtual void ApplyVertexEdits(FarMesh<U> *mesh, int offset, int level, void * clientdata) const;
|
|
|
|
private:
|
|
static FarDispatcher _DefaultDispatcher;
|
|
};
|
|
|
|
|
|
template<class U> FarDispatcher<U> FarDispatcher<U>::_DefaultDispatcher;
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::Refine( FarMesh<U> * mesh, int maxlevel, void * data) const {
|
|
|
|
assert(mesh);
|
|
|
|
FarSubdivisionTables<U> const * tables = mesh->GetSubdivision();
|
|
|
|
FarVertexEditTables<U> const * edits = mesh->GetVertexEdit();
|
|
|
|
if ( (maxlevel < 0) )
|
|
maxlevel=tables->GetMaxLevel();
|
|
else
|
|
maxlevel = std::min(maxlevel, tables->GetMaxLevel());
|
|
|
|
for (int i=1; i<maxlevel; ++i) {
|
|
|
|
// compute vertex & varying interpolation on all vertices
|
|
tables->Apply(i, data);
|
|
|
|
// apply hierarchical edits
|
|
if (edits)
|
|
edits->Apply(i, data);
|
|
}
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyBilinearFaceVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarBilinearSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarBilinearSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeFacePoints(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyBilinearEdgeVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarBilinearSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarBilinearSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeEdgePoints(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyBilinearVertexVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarBilinearSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarBilinearSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeVertexPoints(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyCatmarkFaceVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeFacePoints(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyCatmarkEdgeVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeEdgePoints(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyCatmarkVertexVerticesKernelB(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeVertexPointsB(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyCatmarkVertexVerticesKernelA(FarMesh<U> * mesh, int offset, bool pass, int level, int start, int end, void * clientdata) const {
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeVertexPointsA(offset, pass, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyLoopEdgeVerticesKernel(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarLoopSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarLoopSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeEdgePoints(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyLoopVertexVerticesKernelB(FarMesh<U> * mesh, int offset, int level, int start, int end, void * clientdata) const {
|
|
FarLoopSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarLoopSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeVertexPointsB(offset, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyLoopVertexVerticesKernelA(FarMesh<U> * mesh, int offset, bool pass, int level, int start, int end, void * clientdata) const {
|
|
FarLoopSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarLoopSubdivisionTables<U> const *>(mesh->GetSubdivision());
|
|
assert(subdivision);
|
|
subdivision->computeVertexPointsA(offset, pass, level, start, end, clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarDispatcher<U>::ApplyVertexEdits(FarMesh<U> * mesh, int offset, int level, void * clientdata) const {
|
|
FarVertexEditTables<U> const * vertEdit = mesh->GetVertexEdit();
|
|
if (vertEdit)
|
|
vertEdit->computeVertexEdits(level, clientdata);
|
|
}
|
|
|
|
} // end namespace OPENSUBDIV_VERSION
|
|
using namespace OPENSUBDIV_VERSION;
|
|
|
|
} // end namespace OpenSubdiv
|
|
|
|
#endif /* FAR_DISPATCHER_H */
|