File: SoLocalBBoxMatrixElement.h

package info (click to toggle)
inventor 2.1.5-10%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 35,712 kB
  • sloc: ansic: 33,864; lisp: 7,361; cpp: 3,874; yacc: 369; sh: 360; perl: 234; awk: 141; makefile: 80; csh: 35; sed: 11
file content (146 lines) | stat: -rw-r--r-- 5,501 bytes parent folder | download | duplicates (12)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
/*
 *
 *  Copyright (C) 2000 Silicon Graphics, Inc.  All Rights Reserved. 
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; either
 *  version 2.1 of the License, or (at your option) any later version.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  Further, this software is distributed without any warranty that it is
 *  free of the rightful claim of any third person regarding infringement
 *  or the like.  Any license provided herein, whether implied or
 *  otherwise, applies only to this software file.  Patent licenses, if
 *  any, provided herein do not apply to combinations of this program with
 *  other software, or any other product whatsoever.
 * 
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 *  Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
 *  Mountain View, CA  94043, or:
 * 
 *  http://www.sgi.com 
 * 
 *  For further information regarding this notice, see: 
 * 
 *  http://oss.sgi.com/projects/GenInfo/NoticeExplan/
 *
 */

//  -*- C++ -*-

/*
 * Copyright (C) 1990,91   Silicon Graphics, Inc.
 *
 _______________________________________________________________________
 ______________  S I L I C O N   G R A P H I C S   I N C .  ____________
 |
 |   $Revision: 1.1.1.1 $
 |
 |   Description:
 |	This file defines the SoLocalBBoxMatrixElement class.
 |
 |   Author(s)		: Paul S. Strauss
 |
 ______________  S I L I C O N   G R A P H I C S   I N C .  ____________
 _______________________________________________________________________
 */

#ifndef  _SO_LOCAL_BBOX_MATRIX_ELEMENT
#define  _SO_LOCAL_BBOX_MATRIX_ELEMENT

#include <Inventor/elements/SoModelMatrixElement.h>

//////////////////////////////////////////////////////////////////////////////
//
//  Class: SoLocalBBoxMatrixElement
//
//  Element that stores the transformation matrix from object space to
//  some local coordinate space during application of an
//  SoGetBoundingBoxAction. This element is needed to allow separators
//  (and other caching nodes) to store cached bounding boxes in their
//  own local space. Shapes that extend the current bounding box
//  computed by the action use this matrix to transform the bounding
//  box into local space. Separators cache this box, then transform it
//  into the next local space up the hierarchy.
//
//  Because this element is set to identity by separators before
//  traversing their children, it can never have an affect on any
//  caching separator that it is not under. Therefore, it should
//  never be tested for cache invalidation, so its matches() method
//  prints an error message and returns FALSE. It also means that it
//  does not have to save node id's so there are no nodes passed in to
//  any of the methods.
//
//////////////////////////////////////////////////////////////////////////////

SoEXTENDER class SoLocalBBoxMatrixElement : public SoElement {

    SO_ELEMENT_HEADER(SoLocalBBoxMatrixElement);

  public:
    // Initializes element
    virtual void	init(SoState *state);

    // Overrides push() method to copy values from next instance in the stack
    virtual void	push(SoState *state);

    // Sets the local matrix to the identity matrix
    static void		makeIdentity(SoState *state);

    // Sets the local matrix to the given matrix
    static void		set(SoState *state, const SbMatrix &matrix);

    // Multiplies the given matrix into the local matrix
    static void		mult(SoState *state, const SbMatrix &matrix);

    // Each of these multiplies a matrix that performs the specified
    // transformation into the local matrix
    static void		translateBy(SoState *state,const SbVec3f &translation);
    static void		rotateBy(SoState *state, const SbRotation &rotation);
    static void		scaleBy(SoState *state, const SbVec3f &scaleFactor);

    // These methods are used by the TransformSeparator node.
    static SbMatrix	pushMatrix(SoState *state);
    static void		popMatrix(SoState *state, const SbMatrix &m);

    // Resets all current instances in the state to identity
    static void		resetAll(SoState *state);

    // Returns current matrix from the state
    static const SbMatrix &	get(SoState *state);

    // Prints error message and returns FALSE (see class header comment)
    virtual SbBool	matches(const SoElement *elt) const;

    // Create and return a copy of this element
    virtual SoElement	*copyMatchInfo() const;

    // Prints element (for debugging)
    virtual void	print(FILE *fp) const;

  SoINTERNAL public:
    // Initializes the SoLocalBBoxMatrixElement class
    static void		initClass();

  protected:
    SbMatrix		localMatrix;

    virtual ~SoLocalBBoxMatrixElement();

  private:
    // This stores the inverse of the current model matrix at the time
    // the element is created. It is needed in case the element is set
    // to contain a new matrix, since we want to factor out the
    // effects of the non-local part of the matrix.
    SbMatrix		modelInverseMatrix;
};

#endif /* _SO_LOCAL_BBOX_MATRIX_ELEMENT */