File: SbCylinderProjector.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 (144 lines) | stat: -rw-r--r-- 5,206 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
/*
 *
 *  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 SbCylinderProjector
 |	class. This is an abstract base class for projectors
 |	that somehow use a cylinder in their projection.
 |
 |	The getRotation methods for an SbCylinder will always
 |	return a rotation that is about the axis of the cylinder.
 |	  
 |   Author(s)		: Howard Look
 |
 ______________  S I L I C O N   G R A P H I C S   I N C .  ____________
 _______________________________________________________________________
 */

#ifndef _SB_CYLINDER_PROJECTOR_
#define _SB_CYLINDER_PROJECTOR_

#include <Inventor/projectors/SbProjector.h>

// C-api: abstract
// C-api: prefix=SbCylProj
class SbCylinderProjector : public SbProjector
{
  public:
    // Destructor
    ~SbCylinderProjector(){};

    // 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.
    // C-api: expose
    virtual SbVec3f	project(const SbVec2f &point) = 0;

    // Same as above, but also get a rotation from the last
    // projected point to this one.
    // C-api: name=projectGetRot
    SbVec3f		projectAndGetRotation(const SbVec2f &point,
					      SbRotation &rot);

    // Get a rotation given two points on this cylinder projector.
    // C-api: expose
    // C-api: name=getRot
    virtual SbRotation	getRotation(const SbVec3f &point1,
				    const SbVec3f &point2) = 0;

    // Set/get the cylinder to use.
    // Default cylinder is centered about Y axis and has radius 1.0.
    // C-api: name=setCyl
    void		setCylinder(const SbCylinder &cyl);

    // C-api: name=getCyl
    const SbCylinder &	getCylinder() const		{ return cylinder; }

    // Set/get whether the projector should always be oriented towards the eye.
    // Set to FALSE if the tolerance should be evaluated in working space.
    void		setOrientToEye(SbBool orientToEye);
    SbBool		isOrientToEye() const		{ return orientToEye; }


    // Set/get whether the projector should intersect the half of the
    // cylinder that faces the eye.
    // Set to FALSE if the projector should intersect with the rear half.
    void                setFront(SbBool isFront);
    SbBool              isFront()       const   { return intersectFront; }
    SbBool              isPointInFront( const SbVec3f &point ) const;


    // Set the transform space to work in.
    virtual void	setWorkingSpace(const SbMatrix &space);
    
  protected:
    // Constructors
    // The default cylinder to is centered about the Y axis and
    // has a radius of 1.0.
    SbCylinderProjector(SbBool orientToEye);
    SbCylinderProjector(const  SbCylinder &cyl,
			SbBool orientToEye);

    // Are intersections done on the front half ( if not, they're done on th e
    // back half) of the cylinder?
    SbBool      intersectFront;

    // Just like cylinder::intersect, except always returns
    // the intersection that is in "front".
    SbBool	intersectCylinderFront(const SbLine &line, SbVec3f &result);

    SbCylinder	cylinder;		// Cylinder for this projector.
    SbBool	orientToEye;		// TRUE if always oriented to eye.
    SbBool	needSetup;		// Set TRUE whenever cylinder,
					// work space or orientation changes.

    // Cached last point on this projector. Subclasses must set
    // this in their project and getRotation methods.
    SbVec3f	lastPoint;
};


#endif /* _SB_CYLINDER_PROJECTOR_ */