Open Inventor Reference
SoNormalGenerator.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright (C) 2000 Silicon Graphics, Inc. All Rights Reserved.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Lesser General Public License for more details.
14  *
15  * Further, this software is distributed without any warranty that it is
16  * free of the rightful claim of any third person regarding infringement
17  * or the like. Any license provided herein, whether implied or
18  * otherwise, applies only to this software file. Patent licenses, if
19  * any, provided herein do not apply to combinations of this program with
20  * other software, or any other product whatsoever.
21  *
22  * You should have received a copy of the GNU Lesser General Public
23  * License along with this library; if not, write to the Free Software
24  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25  *
26  * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
27  * Mountain View, CA 94043, or:
28  *
29  * http://www.sgi.com
30  *
31  * For further information regarding this notice, see:
32  *
33  * http://oss.sgi.com/projects/GenInfo/NoticeExplan/
34  *
35  */
36 
37 
38 /*
39  * Copyright (C) 1990,91 Silicon Graphics, Inc.
40  *
41  _______________________________________________________________________
42  ______________ S I L I C O N G R A P H I C S I N C . ____________
43  |
44  | $Revision: 1.1.1.1 $
45  |
46  | Description:
47  | This file contains the definition of the SoNormalGenerator class.
48  |
49  | Author(s) : Thad Beier, Paul S. Strauss
50  |
51  ______________ S I L I C O N G R A P H I C S I N C . ____________
52  _______________________________________________________________________
53  */
54 
55 
56 #ifndef _SO_NORMAL_GENERATOR_
57 #define _SO_NORMAL_GENERATOR_
58 
59 #include <Inventor/SbLinear.h>
60 
97 
99 
100  public:
102  SoNormalGenerator(bool isCCW);
103  SoNormalGenerator(bool isCCW, int approxNumVertices);
105 
108  void beginPolygon();
109  void polygonVertex(const SbVec3f &point);
110  void endPolygon();
111 
113  void triangle(const SbVec3f &p1,
114  const SbVec3f &p2,
115  const SbVec3f &p3);
116 
118  void generate(float creaseAngle);
119 
124 
127  int getNumNormals() const { return numVertNormals; }
128 
130  void setNumNormals(int newNum);
131 
133  const SbVec3f * getNormals() const { return vertNormals; }
134 
136  const SbVec3f & getNormal(int32_t i) const { return vertNormals[i]; }
137 
142  void setNormal(int32_t index, const SbVec3f &newNormal);
143 
144  private:
150  SbVec3f *points, *faceNormals, *vertNormals;
151  int32_t numPoints, numVertNormals;
152  int32_t maxPoints, maxVertNormals;
153 
155  bool isCCW;
156 
158  int32_t beginPolygonIndex;
159 
161  static bool equal(const SbVec3f &a, const SbVec3f &b, float tol);
162 };
163 
164 #endif /* _SO_NORMAL_GENERATOR_ */
#define SoEXTENDER
Provide inline template functions for abs, swap, min, max, and clamp.
Definition: SbBasic.h:154
#define INVENTOR_API
Disable some annoying warnings on MSVC 6.
Definition: SbSystem.h:81
signed int int32_t
Definition: SbTypeDefs.h:43
3D vector class.
Definition: SbLinear.h:120
This class can be used by polyhedral shape classes to generate surface normals when they do not have ...
void generate(float creaseAngle)
Calculate the normals once all vertices have been sent.
void beginPolygon()
Send a polygon's worth of vertices.
SoNormalGenerator(bool isCCW, int approxNumVertices)
const SbVec3f & getNormal(int32_t i) const
Returns the i'th normal in the array.
SoNormalGenerator(bool isCCW)
Constructors and destructor.
int getNumNormals() const
The rest of the methods may be called only AFTER generate() has been called:
void polygonVertex(const SbVec3f &point)
void setNormal(int32_t index, const SbVec3f &newNormal)
Some shapes may need to adjust or reorder normals after generation.
void triangle(const SbVec3f &p1, const SbVec3f &p2, const SbVec3f &p3)
Send a triangle.
void setNumNormals(int newNum)
Truncate the array so there are only the given number of normals.
const SbVec3f * getNormals() const
Returns a pointer to the array of normals.