NAME

       SbSphereProjector — sphere projector

INHERITS FROM

       SbProjector > SbSphereProjector

SYNOPSIS

       #include <Inventor/projectors/SbSphereProjector.h>

          Methods from class SbSphereProjector:

     SbVec3f             projectAndGetRotation(const SbVec2f &point, SbRotation &rot)
     virtual SbRotation  getRotation(const SbVec3f &point1, const SbVec3f &point2)
     void                setSphere(const SbSphere &sph)
     const SbSphere &    getSphere() const
     void                setOrientToEye(SbBool orientToEye)
     SbBool              isOrientToEye() const
     void                setFront(SbBool isFront)
     SbBool              isFront() const
     SbBool              isPointInFront(const SbVec3f &point) const

          Methods from class SbProjector:

     virtual SbVec3f        project(const SbVec2f &point)
     virtual void           setViewVolume(const SbViewVolume &vol)
     const SbViewVolume &   getViewVolume() const
     virtual void           setWorkingSpace(const SbMatrix &space)
     const SbMatrix &       getWorkingSpace() const
     virtual SbProjector *  copy() const

DESCRIPTION

       SbSphereProjector  is  an  abstract  base  class for projectors that use a sphere in their
       projection. Sphere projectors are typically used to write interactive 3D manipulators  and
       viewers.

METHODS

     SbVec3f             projectAndGetRotation(const SbVec2f &point, SbRotation &rot)
          Apply the projector using the given point, returning the point in three dimensions that
          it projects to. This also returns in rot a rotation on the surface of the  sphere  from
          the  last  projected point to this one. The passed point should be normalized (i.e. lie
          in the range [0.0,1.0]), with (0,0) at the lower-left.

     virtual SbRotation  getRotation(const SbVec3f &point1, const SbVec3f &point2)
          Get a rotation given two points on this sphere projector. The rotation will be  on  the
          surface of the sphere.

     void                setSphere(const SbSphere &sph)
     const SbSphere &    getSphere() const
          Set and get the sphere on which to project points. The default sphere has radius 1.0.

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

     void                setFront(SbBool isFront)
     SbBool              isFront() const
     SbBool              isPointInFront(const SbVec3f &point) const
          Set and get whether the projector should intersect the half of the  sphere  that  faces
          the eye. Set to FALSE if the projector should intersect with the rear half.

SEE ALSO

       SbCylinderProjector,         SbCylinderPlaneProjector,         SbCylinderSectionProjector,
       SbCylinderSheetProjector,   SbLineProjector,   SbPlaneProjector,   SbSpherePlaneProjector,
       SbSphereSectionProjector, SbSphereSheetProjector

                                                                         SbSphereProjector(3IV)()