mirror of
https://github.com/PixarAnimationStudios/OpenSubdiv
synced 2024-11-30 23:30:07 +00:00
aed197628c
- FarKernelBatch becomes a class w/ accessors - split the FarKernelBatchFactory to its own header file - add doxy doc - propagate fallout to the rest of the code base
428 lines
17 KiB
C++
428 lines
17 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"
|
|
#include "../far/kernelBatch.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
|
|
///
|
|
|
|
class FarDispatcher {
|
|
public:
|
|
template <class CONTROLLER>
|
|
static void Refine(CONTROLLER const *controller, FarKernelBatchVector const & batches, int maxlevel, void * clientdata=0);
|
|
};
|
|
|
|
template <class CONTROLLER> void
|
|
FarDispatcher::Refine(CONTROLLER const *controller, FarKernelBatchVector const & batches, int maxlevel, void * clientdata) {
|
|
|
|
for (int i = 0; i < (int)batches.size(); ++i) {
|
|
const FarKernelBatch &batch = batches[i];
|
|
|
|
if (maxlevel >= 0 && batch.GetLevel() >= maxlevel) continue;
|
|
|
|
switch(batch.GetKernelType()) {
|
|
case FarKernelBatch::CATMARK_FACE_VERTEX:
|
|
controller->ApplyCatmarkFaceVerticesKernel(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::CATMARK_EDGE_VERTEX:
|
|
controller->ApplyCatmarkEdgeVerticesKernel(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::CATMARK_VERT_VERTEX_B:
|
|
controller->ApplyCatmarkVertexVerticesKernelB(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::CATMARK_VERT_VERTEX_A1:
|
|
controller->ApplyCatmarkVertexVerticesKernelA1(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::CATMARK_VERT_VERTEX_A2:
|
|
controller->ApplyCatmarkVertexVerticesKernelA2(batch, clientdata);
|
|
break;
|
|
|
|
case FarKernelBatch::LOOP_EDGE_VERTEX:
|
|
controller->ApplyLoopEdgeVerticesKernel(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::LOOP_VERT_VERTEX_B:
|
|
controller->ApplyLoopVertexVerticesKernelB(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::LOOP_VERT_VERTEX_A1:
|
|
controller->ApplyLoopVertexVerticesKernelA1(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::LOOP_VERT_VERTEX_A2:
|
|
controller->ApplyLoopVertexVerticesKernelA2(batch, clientdata);
|
|
break;
|
|
|
|
case FarKernelBatch::BILINEAR_FACE_VERTEX:
|
|
controller->ApplyBilinearFaceVerticesKernel(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::BILINEAR_EDGE_VERTEX:
|
|
controller->ApplyBilinearEdgeVerticesKernel(batch, clientdata);
|
|
break;
|
|
case FarKernelBatch::BILINEAR_VERT_VERTEX:
|
|
controller->ApplyBilinearVertexVerticesKernel(batch, clientdata);
|
|
break;
|
|
|
|
case FarKernelBatch::HIERARCHICAL_EDIT:
|
|
controller->ApplyVertexEdits(batch, clientdata);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
// -----------------------------------------------------------------------------
|
|
|
|
|
|
template <class U>
|
|
class FarComputeController
|
|
{
|
|
|
|
public:
|
|
void Refine(FarMesh<U> * mesh, int maxlevel=-1) const;
|
|
|
|
void ApplyBilinearFaceVerticesKernel(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyBilinearEdgeVerticesKernel(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyBilinearVertexVerticesKernel(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
|
|
void ApplyCatmarkFaceVerticesKernel(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyCatmarkEdgeVerticesKernel(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyCatmarkVertexVerticesKernelB(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyCatmarkVertexVerticesKernelA1(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyCatmarkVertexVerticesKernelA2(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyLoopEdgeVerticesKernel(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyLoopVertexVerticesKernelB(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyLoopVertexVerticesKernelA1(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyLoopVertexVerticesKernelA2(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
void ApplyVertexEdits(FarKernelBatch const &batch, void * clientdata) const;
|
|
|
|
static FarComputeController _DefaultController;
|
|
|
|
private:
|
|
|
|
};
|
|
|
|
template<class U> FarComputeController<U> FarComputeController<U>::_DefaultController;
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::Refine(FarMesh<U> *mesh, int maxlevel) const {
|
|
|
|
FarDispatcher::Refine(this, mesh->GetKernelBatches(), maxlevel, mesh);
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyBilinearFaceVerticesKernel(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarBilinearSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarBilinearSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
assert(subdivision);
|
|
|
|
subdivision->computeFacePoints( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyBilinearEdgeVerticesKernel(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarBilinearSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarBilinearSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
assert(subdivision);
|
|
|
|
subdivision->computeEdgePoints( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyBilinearVertexVerticesKernel(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarBilinearSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarBilinearSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeVertexPoints( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyCatmarkFaceVerticesKernel(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeFacePoints( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyCatmarkEdgeVerticesKernel(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeEdgePoints( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyCatmarkVertexVerticesKernelB(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeVertexPointsB( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyCatmarkVertexVerticesKernelA1(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeVertexPointsA( batch.GetVertexOffset(),
|
|
false,
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyCatmarkVertexVerticesKernelA2(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarCatmarkSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarCatmarkSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeVertexPointsA( batch.GetVertexOffset(),
|
|
true,
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyLoopEdgeVerticesKernel(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarLoopSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarLoopSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeEdgePoints( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyLoopVertexVerticesKernelB(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarLoopSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarLoopSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeVertexPointsB( batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyLoopVertexVerticesKernelA1(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarLoopSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarLoopSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeVertexPointsA( batch.GetVertexOffset(),
|
|
false,
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyLoopVertexVerticesKernelA2(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarLoopSubdivisionTables<U> const * subdivision =
|
|
dynamic_cast<FarLoopSubdivisionTables<U> const *>(mesh->GetSubdivisionTables());
|
|
|
|
assert(subdivision);
|
|
|
|
subdivision->computeVertexPointsA( batch.GetVertexOffset(),
|
|
true,
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata);
|
|
}
|
|
|
|
template <class U> void
|
|
FarComputeController<U>::ApplyVertexEdits(FarKernelBatch const &batch, void * clientdata) const {
|
|
|
|
FarMesh<U> * mesh = static_cast<FarMesh<U> *>(clientdata);
|
|
|
|
FarVertexEditTables<U> const * vertEdit = mesh->GetVertexEdit();
|
|
|
|
if (vertEdit)
|
|
vertEdit->computeVertexEdits( batch.GetTableIndex(),
|
|
batch.GetVertexOffset(),
|
|
batch.GetTableOffset(),
|
|
batch.GetStart(),
|
|
batch.GetEnd(),
|
|
clientdata );
|
|
}
|
|
|
|
} // end namespace OPENSUBDIV_VERSION
|
|
using namespace OPENSUBDIV_VERSION;
|
|
|
|
} // end namespace OpenSubdiv
|
|
|
|
#endif /* FAR_DISPATCHER_H */
|