SbSphereProjector(3IV)

NAME
     SbSphereProjector (SbSphProj) - sphere projector

INHERITS FROM
     SbProjector > SbSphereProjector

SYNOPSIS
     #include <Inventor_c/projectors/SbSphereProjector.h>

     typedef SbSphereProjector  SbSphProj

          Functions from class SbSphereProjector:

     SbVec3f             SbSphProjProjectGetRot(SbSphProj *this, const SbVec2f
                              *point, SbRotation *rot)
     SbRotation          SbSphProjGetRot(SbSphProj *this, const SbVec3f
                              *point1, const SbVec3f *point2)
     void                SbSphProjSetSph(SbSphProj *this, const SbSphere *sph)
     const SbSphere *    SbSphProjGetSph(const SbSphProj *this)
     void                SbSphProjSetOrientToEye(SbSphProj *this, SbBool
                              orientToEye)
     SbBool              SbSphProjIsOrientToEye(const SbSphProj *this)
     void                SbSphProjSetFront(SbSphProj *this, SbBool isFront)
     SbBool              SbSphProjIsFront(const SbSphProj *this)
     SbBool              SbSphProjIsPointInFront(const SbSphProj *this, const
                              SbVec3f *point)

          Functions from class SbProjector:

     SbVec3f               SbSphProjProject(SbSphProj *this, const SbVec2f
                                *point)
     void                  SbSphProjSetViewVol(SbSphProj *this, const
                                SbViewVolume *vol)
     const SbViewVolume *  SbSphProjGetViewVol(const SbSphProj *this)
     void                  SbSphProjSetWorkSpace(SbSphProj *this, const
                                SbMatrix *space)
     const SbMatrix *      SbSphProjGetWorkSpace(const SbSphProj *this)
     SbProjector *         SbSphProjCopy(const SbSphProj *this)


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.

FUNCTIONS
     SbVec3f             SbSphProjProjectGetRot(SbSphProj *this, 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.

     SbRotation          SbSphProjGetRot(SbSphProj *this, 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                SbSphProjSetSph(SbSphProj *this, const SbSphere *sph)
     const SbSphere *    SbSphProjGetSph(const SbSphProj *this)
          Set and get the sphere on which to project points. The default
          sphere has radius 1.0.

     void                SbSphProjSetOrientToEye(SbSphProj *this, SbBool
                              orientToEye)
     SbBool              SbSphProjIsOrientToEye(const SbSphProj *this)
          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                SbSphProjSetFront(SbSphProj *this, SbBool isFront)
     SbBool              SbSphProjIsFront(const SbSphProj *this)
     SbBool              SbSphProjIsPointInFront(const SbSphProj *this, const
                              SbVec3f *point)
          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.


FILE FORMAT/DEFAULTS
     SphereProjector {
     }

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