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 
121  static SbMatrix pushMatrix(SoState *state);
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:81
#define SO_ELEMENT_HEADER(className)
This one is for non-abstract element classes.
Definition: SoSubElement.h:112
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)
static const SbMatrix & getCombinedCullMatrix(SoState *state)
This method gets the model*cullMatrix combined matrix (which is cached by this element).
unsigned int haveCullMatrix
TRUE if cullMatrix set.
static const SbMatrix & get(SoState *state)
Returns current model matrix from the state.
static void initClass()
Initializes the SoModelMatrixElement class.
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 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