SbSphereSheetProjector(3IV)

NAME
     SbSphereSheetProjector (SbSphSheetProj) - sphere-sheet projector

INHERITS FROM
     SbProjector > SbSphereProjector > SbSphereSheetProjector

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

     typedef SbSphereSheetProjector
                         SbSphSheetProj

          Functions from class SbSphereSheetProjector:

     SbSphereSheetProjector *  SbSphSheetProjCreate(SbBool orientToEye = TRUE)
     SbSphereSheetProjector *  SbSphSheetProjCreateSph(const SbSphere *sph,
                                    SbBool orientToEye = TRUE)
     void                      SbSphSheetProjDelete(SbSphSheetProj *this)

          Functions from class SbSphereProjector:

     SbVec3f             SbSphSheetProjProjectGetRot(SbSphSheetProj *this,
                              const SbVec2f *point, SbRotation *rot)
     SbRotation          SbSphSheetProjGetRot(SbSphSheetProj *this, const
                              SbVec3f *point1, const SbVec3f *point2)
     void                SbSphSheetProjSetSph(SbSphSheetProj *this, const
                              SbSphere *sph)
     const SbSphere *    SbSphSheetProjGetSph(const SbSphSheetProj *this)
     void                SbSphSheetProjSetOrientToEye(SbSphSheetProj *this,
                              SbBool orientToEye)
     SbBool              SbSphSheetProjIsOrientToEye(const SbSphSheetProj
                              *this)
     void                SbSphSheetProjSetFront(SbSphSheetProj *this, SbBool
                              isFront)
     SbBool              SbSphSheetProjIsFront(const SbSphSheetProj *this)
     SbBool              SbSphSheetProjIsPointInFront(const SbSphSheetProj
                              *this, const SbVec3f *point)

          Functions from class SbProjector:

     SbVec3f               SbSphSheetProjProject(SbSphSheetProj *this, const
                                SbVec2f *point)
     void                  SbSphSheetProjSetViewVol(SbSphSheetProj *this,
                                const SbViewVolume *vol)
     const SbViewVolume *  SbSphSheetProjGetViewVol(const SbSphSheetProj
                                *this)
     void                  SbSphSheetProjSetWorkSpace(SbSphSheetProj *this,
                                const SbMatrix *space)
     const SbMatrix *      SbSphSheetProjGetWorkSpace(const SbSphSheetProj
                                *this)
     SbProjector *         SbSphSheetProjCopy(const SbSphSheetProj *this)
DESCRIPTION
     SbSphereSheetProjector projects a window space point (usually based on
     the mouse location) onto the surface of a sphere with a hyperbolic sheet
     draped over it. This allows smooth transitions onto and off of the
     sphere. Two projected points can produce a rotation about the sphere's
     center. When the mouse position projects on to the sheet, the rotations
     will be as if the sheet is being dragged, causing the sphere to roll
     beneath it.

     Incremental changes (delta rotation) can be computed during interactive
     sessions. Sphere projectors are typically used to write interactive 3D
     manipulators and viewers.

FUNCTIONS
     SbSphereSheetProjector *  SbSphSheetProjCreate(SbBool orientToEye = TRUE)
     SbSphereSheetProjector *  SbSphSheetProjCreateSph(const SbSphere *sph,
                                    SbBool orientToEye = TRUE)
          Constructors. The first uses a default sphere centered at the origin
          with radius 1.0; the sphere is supplied in the second. The
          orientToEye parameter determines whether the sheet is perpendicular
          to the eye, or perpendicular to the sphere's Z axis. Setting that
          parameter to TRUE (the default) specifies that the sheet be
          perpendicular to the eye, which is most often the desired behavior.

          The default view volume is undefined, and the working space is
          identity.

     void                      SbSphSheetProjDelete(SbSphSheetProj *this)
          Destructor.


FILE FORMAT/DEFAULTS
     SphereSheetProjector {
     }

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