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.
friend class SoState
Definition SoElement.h:223
SoElement()
Constructor; use typeId.createInstance to create elements.
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.
friend class SoLocalBBoxMatrixElement
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