Open Inventor Reference
SoNormalBundle.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 defines the SoNormalBundle class.
48  |
49  | Author(s) : 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 #ifndef _SO_NORMAL_BUNDLE
56 #define _SO_NORMAL_BUNDLE
57 
61 
76 
78 
79  public:
84  SoNormalBundle(SoAction *action, bool forRendering);
85 
88 
90  bool shouldGenerate(int numNeeded);
91 
94  void initGenerator(int initialNum = 100);
95 
102 
106  { generator->beginPolygon(); }
107  void polygonVertex(const SbVec3f &point)
108  { generator->polygonVertex(point); }
109  void endPolygon()
110  { generator->endPolygon(); }
111 
113  void triangle(const SbVec3f &p1,
114  const SbVec3f &p2,
115  const SbVec3f &p3)
116  { generator->triangle(p1, p2, p3); }
117 
133  void generate(int startIndex = 0,
134  bool addToState=TRUE);
135 
137  const SbVec3f * getGeneratedNormals() const
138  { return generator->getNormals(); }
140  { return generator->getNumNormals(); }
141 
142 
149  void set(int32_t numNormals, const SbVec3f *normals);
150 
153  const SbVec3f & get(int index) const { return normElt->get(index); }
154 
156  void send(int index) const { GLNormElt->send(index); }
157 
158  SoINTERNAL public:
160 
161  private:
163  const SoNormalElement *normElt;
164  const SoGLNormalElement *GLNormElt;
165 
166  bool isRendering;
167  bool pushedState;
168  SoNode *currentNode;
169 };
170 
171 #endif /* _SO_NORMAL_BUNDLE */
172 
#define SoEXTENDER
Provide inline template functions for abs, swap, min, max, and clamp.
Definition: SbBasic.h:154
#define TRUE
Definition: SbBasic.h:76
#define SoINTERNAL
Definition: SbBasic.h:155
#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
Abstract base class for all actions.
Definition: SoAction.h:179
This is the abstract base class for bundles.
Definition: SoBundle.h:71
Element that stores the current surface normals.
Abstract base class for all database nodes.
Definition: SoNode.h:103
Bundle that allows shapes to deal with normals and normal bindings more easily.
const SbVec3f * getGeneratedNormals() const
Returns the generated normals.
void initGenerator(int initialNum=100)
Initializes generation in the case where shouldGenerate() is not called.
bool shouldGenerate(int numNeeded)
Returns TRUE if normals need to be generated.
~SoNormalBundle()
Destructor.
SoNormalBundle(SoAction *action, bool forRendering)
Constructor - takes the action the bundle is used for and a flag to indicate whether the bundle is be...
void send(int index) const
Sends indexed normal to the GL, for use only during GL rendering.
void triangle(const SbVec3f &p1, const SbVec3f &p2, const SbVec3f &p3)
Send a triangle.
void polygonVertex(const SbVec3f &point)
const SbVec3f & get(int index) const
Returns indexed normal.
SoNormalGenerator * generator
Normal generator.
void beginPolygon()
If shouldGenerate() returns TRUE, these methods can be used by shapes to specify the geometry to gene...
void set(int32_t numNormals, const SbVec3f *normals)
This allows shapes that generate their own normals (for efficiency) to store the resulting normals in...
int getNumGeneratedNormals() const
void generate(int startIndex=0, bool addToState=TRUE)
Calculates the normals once all vertices have been sent.
Element that stores the current surface normals.
This class can be used by polyhedral shape classes to generate surface normals when they do not have ...