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
147
148
149
150
151
152
153
154
155
156
157
|
/*
*
* 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,92 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 contains the definition of the SbSphereSectionProjector
| class. This projector projects the mouse position onto the
| section of a sphere that has been sliced by a plane.
|
| The tolerance slice can be specified as a fraction of the radius
| of the sphere. The projection point will not extend beyond
| the sliced portion of the sphere.
|
| This projector is good for trackballs that only do
| pure roll when the mouse is off the sliced portion of
| the sphere.
|
| Author(s) : Howard Look, Paul Isaacs
|
______________ S I L I C O N G R A P H I C S I N C . ____________
_______________________________________________________________________
*/
#ifndef _SB_SPHERE_SECTION_PROJECTOR_
#define _SB_SPHERE_SECTION_PROJECTOR_
#include <Inventor/projectors/SbSphereProjector.h>
// C-api: prefix=SbSphSectProj
class SbSphereSectionProjector : public SbSphereProjector
{
public:
// Default constructor.
// The default view volume is undefined.
// The default working space is identity (world space).
// The default sphere to use has a radius of 1.0 and is centered at (0,0,0).
// The default edge tolerance is .9.
// The default eye orientation is TRUE.
SbSphereSectionProjector(float edgeTol = .9,
SbBool orientToEye = TRUE);
// Constructor taking the sphere.
// C-api: name=createSph
SbSphereSectionProjector(const SbSphere &sph,
float edgeTol = .9,
SbBool orientToEye = TRUE);
// Destructor
~SbSphereSectionProjector() {}
// Returns an instance that is a copy of this instance. The caller
// is responsible for deleting the copy when done.
virtual SbProjector * copy() const;
// Apply the projector using the given point, returning the
// point in three dimensions that it projects to.
// The point should be normalized from 0-1, with (0,0) at the lower-left.
virtual SbVec3f project(const SbVec2f &point);
// Computes a rotation based on two points on this projector.
virtual SbRotation getRotation(const SbVec3f &point1,
const SbVec3f &point2);
// Set/get the edge tolerance as a fraction of the
// radius of the sphere. If this is 1.0, the projector is a
// hemisphere. If this is .1, the projector is a slice of
// the sphere with radius .1*radius. Default is .9.
// C-api: name=setTol
void setTolerance(float edgeTol);
// C-api: name=getTol
float getTolerance() const { return tolerance; }
// Set/get the radial rotation factor.
// When the mouse is dragged off of the edge of the sphere, the mouse
// motion can be classified as either tangential (moving in a circle
// around the sphere) or radial (moving toward or away from the center).
// The tangential motion will always map to a rotation around the center,
// (like the hands of a clock).
// The radial motion, by default, has no effect. But if you set the
// radialFactor to be > 0.0, this motion will make the sphere rotate
// as if the mouse is pulling the top of the sphere out toward the
// mouse.
// If radialFactor = 1.0, then pulling has a 'normal' feel. (that is, the
// mouse motion causes the same amount of rotation as if you had rotated
// by hitting the actual surface of the sphere, instead of moving off the
// Default is 0.0
void setRadialFactor(float rad = 0.0) { radialFactor = rad;}
float getRadialFactor() const { return radialFactor; }
// Find whether this point on the sphere or tolerance
// plane is within tolerance.
// C-api: name=isWithinTol
SbBool isWithinTolerance(const SbVec3f &point);
protected:
// Sets up the tolerance slice.
virtual void setupTolerance();
// Information about the slice tolerance.
float tolerance; // the edge tolerance
float tolDist; // dist from planePoint to tolerance slice
float radialFactor;
// Information about the plane used for intersection testing.
SbVec3f planePoint; // point on plane
SbVec3f planeDir; // normal direction
float planeDist; // distance from sphere center
SbPlane tolPlane; // the plane itself
};
#endif /* _SB_SPHERE_SECTION_PROJECTOR_ */
|
