Open Inventor Reference
SoModelMatrixElement.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 SoModelMatrixElement class.
48 |
49 | Author(s) : Paul S. Strauss, Gavin Bell
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_MODEL_MATRIX_ELEMENT
56#define _SO_MODEL_MATRIX_ELEMENT
57
58#include <Inventor/SbLinear.h>
60
79
81
83
84 public:
86 virtual void init(SoState *state);
87
89 virtual bool matches(const SoElement *elt) const;
90
91
93 virtual void push(SoState *state);
94
96 static void makeIdentity(SoState *state, SoNode *node);
97
99 static void set(SoState *state, SoNode *node,
100 const SbMatrix &matrix);
101
103 static void mult(SoState *state, SoNode *node,
104 const SbMatrix &matrix);
105
108 static void translateBy(SoState *state, SoNode *node,
109 const SbVec3f &translation);
110 static void rotateBy(SoState *state, SoNode *node,
111 const SbRotation &rotation);
112 static void scaleBy(SoState *state, SoNode *node,
113 const SbVec3f &scaleFactor);
114
122 static void popMatrix(SoState *state, const SbMatrix &m);
123
126 static void setCullMatrix(SoState *state, SoNode *node,
127 const SbMatrix &matrix);
128
131 static const SbMatrix & getCombinedCullMatrix(SoState *state);
132
134 static const SbMatrix & get(SoState *state);
135
138 static const SbMatrix & get(SoState *state, bool &isIdent);
139
141 virtual void print(FILE *fp) const;
142
143 SoINTERNAL public:
145 static void initClass();
146
147 protected:
149 virtual void makeEltIdentity();
150
152 virtual void setElt(const SbMatrix &matrix);
153
155 virtual void multElt(const SbMatrix &matrix);
156
159 virtual void translateEltBy(const SbVec3f &translation);
160 virtual void rotateEltBy(const SbRotation &translation);
161 virtual void scaleEltBy(const SbVec3f &scaleFactor);
162
165 virtual void popMatrixElt(const SbMatrix &m);
166
168
169 private:
170 SbMatrix modelMatrix;
171 SbMatrix cullMatrix;
172 SbMatrix modelCullMatrix;
173 struct {
174 unsigned int isModelIdentity : 1;
175 unsigned int haveCullMatrix : 1;
176 unsigned int haveModelCull : 1;
177 } flags;
178
180};
181
182#endif /* _SO_MODEL_MATRIX_ELEMENT */
#define SoEXTENDER
Provide inline template functions for abs, swap, min, max, and clamp.
Definition SbBasic.h:154
#define SoINTERNAL
Definition SbBasic.h:155
#define INVENTOR_API
Disable some annoying warnings on MSVC 6.
Definition SbSystem.h:77
#define SO_ELEMENT_HEADER(className)
This one is for non-abstract element classes.
4x4 matrix class.
Definition SbLinear.h:823
Class for representing a rotation.
Definition SbLinear.h:678
3D vector class.
Definition SbLinear.h:120
This is the abstract base class for each state element whose value may be accumulated when it is set.
This is the abstract base class for all state elements.
Definition SoElement.h:96
Element that stores the transformation matrix from object space to some local coordinate space during...
Element that stores the current model matrix - the cumulative transformation applied to subsequent sh...
virtual void translateEltBy(const SbVec3f &translation)
Each of these performs the appropriate operation on the matrix in an instance.
virtual void multElt(const SbMatrix &matrix)
Multiplies into the matrix in an instance.
virtual ~SoModelMatrixElement()
static void mult(SoState *state, SoNode *node, const SbMatrix &matrix)
Multiplies the given matrix into the model matrix.
static void set(SoState *state, SoNode *node, const SbMatrix &matrix)
Sets the model matrix to the given matrix.
virtual void scaleEltBy(const SbVec3f &scaleFactor)
static void scaleBy(SoState *state, SoNode *node, const SbVec3f &scaleFactor)
static const SbMatrix & get(SoState *state, bool &isIdent)
Returns current model matrix from the state, sets given flag to TRUE if matrix is known to be identit...
virtual void push(SoState *state)
Overrides push() method to copy values from next instance in the stack.
static void popMatrix(SoState *state, const SbMatrix &m)
virtual void init(SoState *state)
Initializes element.
virtual void makeEltIdentity()
Sets the matrix in an instance to identity.
virtual SbMatrix pushMatrixElt()
virtual methods for push/pop so GL element can Do The Right Thing:
virtual bool matches(const SoElement *elt) const
Override standard matches to invalidate on cull-test.
virtual void popMatrixElt(const SbMatrix &m)
virtual void print(FILE *fp) const
Prints element (for debugging)
static void rotateBy(SoState *state, SoNode *node, const SbRotation &rotation)
static void makeIdentity(SoState *state, SoNode *node)
Sets the model matrix to the identity matrix.
virtual void rotateEltBy(const SbRotation &translation)
unsigned int haveCullMatrix
TRUE if cullMatrix set.
static void initClass()
Initializes the SoModelMatrixElement class.
static const SbMatrix & get(SoState *state)
Returns current model matrix from the state.
virtual void setElt(const SbMatrix &matrix)
Sets the matrix in an instance to given matrix.
static void translateBy(SoState *state, SoNode *node, const SbVec3f &translation)
Each of these multiplies a matrix that performs the specified transformation into the model matrix.
static void setCullMatrix(SoState *state, SoNode *node, const SbMatrix &matrix)
Sets the transformation that defines the volume that view-volume culling should be tested against.
unsigned int haveModelCull
TRUE if model*cull computed.
static const SbMatrix & getCombinedCullMatrix(SoState *state)
This method gets the model*cullMatrix combined matrix (which is cached by this element).
static SbMatrix pushMatrix(SoState *state)
These methods are used by the TransformSeparator node.
Abstract base class for all database nodes.
Definition SoNode.h:103
An SoState collects and holds state while traversing a scene graph.
Definition SoState.h:82