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); }
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
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:77
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.
const SbVec3f & get(int index) const
Returns indexed normal.
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)
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 ...