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
109 void polygonVertex(const SbVec3f &point);
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:77
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.
const SbVec3f * getNormals() const
Returns a pointer to the array of normals.
SoNormalGenerator(bool isCCW, int approxNumVertices)
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.
const SbVec3f & getNormal(int32_t i) const
Returns the i'th normal in the array.
void setNumNormals(int newNum)
Truncate the array so there are only the given number of normals.