File: SoTransform.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,331 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 SoTransform node class.
 |
 |   Author(s)		: Paul S. Strauss, Gavin Bell
 |
 ______________  S I L I C O N   G R A P H I C S   I N C .  ____________
 _______________________________________________________________________
 */

#ifndef  _SO_TRANSFORM_
#define  _SO_TRANSFORM_

#include <Inventor/fields/SoSFRotation.h>
#include <Inventor/fields/SoSFVec3f.h>
#include <Inventor/nodes/SoTransformation.h>

//////////////////////////////////////////////////////////////////////////////
//
//  Class: SoTransform
//
//  Geometric transformation node.
//
//////////////////////////////////////////////////////////////////////////////

// C-api: prefix=SoXf
// C-api: public= translation, rotation, scaleFactor, scaleOrientation, center
class SoTransform : public SoTransformation {

    SO_NODE_HEADER(SoTransform);

  public:
    // Fields
    SoSFVec3f		translation;	 // Translation vector
    SoSFRotation	rotation;	 // Rotation
    SoSFVec3f		scaleFactor;	 // Scale factors
    SoSFRotation	scaleOrientation;// Defines rotational space for scale
    SoSFVec3f		center;	         // Center point for scale and rotate

    // Constructor
    SoTransform();

    // Sets the transform to translate the origin to the fromPoint and
    // rotate the negative z-axis (0,0,-1) to lie on the vector from
    // fromPoint to toPoint. This always tries to keep the "up"
    // direction the positive y-axis, unless that is impossible.
    // All current info in the node is wiped out.
    // C-api: begin
    // C-api: name=ptAt
    void		pointAt(const SbVec3f &fromPoint,
				const SbVec3f &toPoint);

    // returns composite matrices that take you from object space to each
    // of scale/rotation/translation spaces
    // C-api: name=getScaleSpaceMx
    void		getScaleSpaceMatrix(SbMatrix &mat, SbMatrix &inv) const;
    // C-api: name=getRotSpaceMx
    void		getRotationSpaceMatrix(SbMatrix &mat,
                                               SbMatrix &inv) const;
    // C-api: name=getXlateSpaceMx
    void		getTranslationSpaceMatrix(SbMatrix &mat,
                                                  SbMatrix &inv) const;

    // Convenience functions that combine the effects of a matrix
    // transformation into the transformation stored in this node. The
    // first method premultiplies the transformation and the second
    // postmultiplies it.
    void		multLeft(const SbMatrix &mat);
    void		multRight(const SbMatrix &mat);

    // These are the same as multLeft() and multRight(), except that
    // the transformation to multiply into this node comes from
    // another transformation node.
    void		combineLeft(SoTransformation *nodeOnLeft);
    void		combineRight(SoTransformation *nodeOnRight);

    // Sets the fields in the node to implement the transformation
    // represented by the given matrix
    // C-api: name=setMx
    void		setMatrix(const SbMatrix &mat);

    // Changes the center of the transformation to the given point
    // without affecting the overall effect of the transformation
    void		recenter(const SbVec3f &newCenter);

  SoEXTENDER public:
    virtual void	doAction(SoAction *action);
    virtual void	callback(SoCallbackAction *action);
    virtual void	GLRender(SoGLRenderAction *action);
    virtual void	getBoundingBox(SoGetBoundingBoxAction *action);
    virtual void	getMatrix(SoGetMatrixAction *action);
    virtual void	pick(SoPickAction *action);

  SoINTERNAL public:
    static void		initClass();

  protected:
    virtual ~SoTransform();
};

#endif /* _SO_TRANSFORM_ */