topologyDescriptor.h
Go to the documentation of this file.
1 //
2 // Copyright 2014 DreamWorks Animation LLC.
3 //
4 // Licensed under the Apache License, Version 2.0 (the "Apache License")
5 // with the following modification; you may not use this file except in
6 // compliance with the Apache License and the following modification to it:
7 // Section 6. Trademarks. is deleted and replaced with:
8 //
9 // 6. Trademarks. This License does not grant permission to use the trade
10 // names, trademarks, service marks, or product names of the Licensor
11 // and its affiliates, except as required to comply with Section 4(c) of
12 // the License and to reproduce the content of the NOTICE file.
13 //
14 // You may obtain a copy of the Apache License at
15 //
16 // http://www.apache.org/licenses/LICENSE-2.0
17 //
18 // Unless required by applicable law or agreed to in writing, software
19 // distributed under the Apache License with the above modification is
20 // distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
21 // KIND, either express or implied. See the Apache License for the specific
22 // language governing permissions and limitations under the Apache License.
23 //
24 #ifndef OPENSUBDIV3_FAR_TOPOLOGY_DESCRIPTOR_H
25 #define OPENSUBDIV3_FAR_TOPOLOGY_DESCRIPTOR_H
26 
27 #include "../version.h"
28 
29 #include "../far/topologyRefiner.h"
30 #include "../far/topologyRefinerFactory.h"
31 #include "../far/error.h"
32 
33 #include <cassert>
34 
35 namespace OpenSubdiv {
36 namespace OPENSUBDIV_VERSION {
37 
38 namespace Far {
39 
47 
49  numFaces;
50 
51  int const * numVertsPerFace;
53 
56  float const * creaseWeights;
57 
60  float const * cornerWeights;
61 
62  int numHoles;
63  Index const * holeIndices;
64 
66 
67  // Face-varying data channel -- value indices correspond to vertex indices,
68  // i.e. one for every vertex of every face:
69  //
70  struct FVarChannel {
71 
72  int numValues;
74 
75  FVarChannel() : numValues(0), valueIndices(0) { }
76  };
77 
80 
82 };
83 
84 
85 //
86 // Forward declarations of required TopologyRefinerFactory<TopologyDescriptor>
87 // specializations (defined internally):
88 //
89 // @cond EXCLUDE_DOXYGEN
90 
91 template <>
92 bool
94  TopologyRefiner & refiner, TopologyDescriptor const & desc);
95 
96 template <>
97 bool
99  TopologyRefiner & refiner, TopologyDescriptor const & desc);
100 
101 template <>
102 bool
104  TopologyRefiner & refiner, TopologyDescriptor const & desc);
105 
106 template <>
107 bool
109  TopologyRefiner & refiner, TopologyDescriptor const & desc);
110 
111 template <>
112 void
114  TopologyError errCode, char const * msg, TopologyDescriptor const & desc);
115 
116 // @endcond
117 
118 } // end namespace Far
119 
120 } // end namespace OPENSUBDIV_VERSION
121 using namespace OPENSUBDIV_VERSION;
122 } // end namespace OpenSubdiv
123 
124 #endif /* OPENSUBDIV3_FAR_TOPOLOGY_DESCRIPTOR_H */
static void reportInvalidTopology(TopologyError errCode, char const *msg, MESH const &mesh)
(Optional) Control run-time topology validation and error reporting
static bool assignComponentTopology(TopologyRefiner &newRefiner, MESH const &mesh)
Specify the relationships between vertices, faces, etc. ie the face-vertices, vertex-faces, edge-vertices, etc.
Descriptor for raw topology data, provided as a convenience with a corresponding Factory. It should be functionally complete and simple to use, but for more demanding situations, writing a custom Factory is likely warranted.
static bool assignComponentTags(TopologyRefiner &newRefiner, MESH const &mesh)
(Optional) Specify edge or vertex sharpness or face holes
static bool resizeComponentTopology(TopologyRefiner &newRefiner, MESH const &mesh)
Specify the number of vertices, faces, face-vertices, etc.
Stores topology data for a specified set of refinement options.
static bool assignFaceVaryingTopology(TopologyRefiner &newRefiner, MESH const &mesh)
(Optional) Specify face-varying data per face