SbCylinderSheetProjector(3IV)

NAME
     SbCylinderSheetProjector (SbCylSheetProj) - cylinder-sheet projector

INHERITS FROM
     SbProjector > SbCylinderProjector > SbCylinderSheetProjector

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

     typedef SbCylinderSheetProjector
                         SbCylSheetProj

          Functions from class SbCylinderSheetProjector:

     SbCylinderSheetProjector *  SbCylSheetProjCreate(SbBool orientToEye =
                                      TRUE)
     SbCylinderSheetProjector *  SbCylSheetProjCreateCyl(const SbCylinder
                                      *cyl, SbBool orientToEye = TRUE)
     void                        SbCylSheetProjDelete(SbCylSheetProj *this)

          Functions from class SbCylinderProjector:

     SbVec3f             SbCylSheetProjProjectGetRot(SbCylSheetProj *this,
                              const SbVec2f *point, SbRotation *rot)
     SbRotation          SbCylSheetProjGetRot(SbCylSheetProj *this, const
                              SbVec3f *point1, const SbVec3f *point2)
     void                SbCylSheetProjSetCyl(SbCylSheetProj *this, const
                              SbCylinder *cyl)
     const SbCylinder *  SbCylSheetProjGetCyl(const SbCylSheetProj *this)
     void                SbCylSheetProjSetOrientToEye(SbCylSheetProj *this,
                              SbBool orientToEye)
     SbBool              SbCylSheetProjIsOrientToEye(const SbCylSheetProj
                              *this)
     void                SbCylSheetProjSetFront(SbCylSheetProj *this, SbBool
                              isFront)
     SbBool              SbCylSheetProjIsFront(const SbCylSheetProj *this)
     SbBool              SbCylSheetProjIsPointInFront(const SbCylSheetProj
                              *this, const SbVec3f *point)

          Functions from class SbProjector:

     SbVec3f               SbCylSheetProjProject(SbCylSheetProj *this, const
                                SbVec2f *point)
     void                  SbCylSheetProjSetViewVol(SbCylSheetProj *this,
                                const SbViewVolume *vol)
     const SbViewVolume *  SbCylSheetProjGetViewVol(const SbCylSheetProj
                                *this)
     void                  SbCylSheetProjSetWorkSpace(SbCylSheetProj *this,
                                const SbMatrix *space)
     const SbMatrix *      SbCylSheetProjGetWorkSpace(const SbCylSheetProj
                                *this)
     SbProjector *         SbCylSheetProjCopy(const SbCylSheetProj *this)


DESCRIPTION
     SbCylinderSheetProjector projects a window space point (usually based on
     the mouse location) onto the surface of a cylinder with a hyperbolic
     sheet draped over it. This allows smooth transitions onto and off of the
     cylinder.  Two projected points can produce a rotation along the
     cylinder's axis. When the mouse position projects on to the sheet, the
     rotations will be as if the sheet is being dragged, causing the cylinder
     to roll beneath it.

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

FUNCTIONS
     SbCylinderSheetProjector *  SbCylSheetProjCreate(SbBool orientToEye =
                                      TRUE)
     SbCylinderSheetProjector *  SbCylSheetProjCreateCyl(const SbCylinder
                                      *cyl, SbBool orientToEye = TRUE)
          Constructors. The first uses a default cylinder aligned with the Y
          axis with radius 1.0; the cylinder is supplied in the second. The
          orientToEye parameter determines whether the sheet is perpendicular
          to the eye, or perpendicular to the cylinder's Z axis. Setting that
          parameter to TRUE (the default) specifies that the plane 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                        SbCylSheetProjDelete(SbCylSheetProj *this)
          Destructor.


FILE FORMAT/DEFAULTS
     CylinderSheetProjector {
     }

SEE ALSO
     SbCylinderSectionProjector, SbCylinderPlaneProjector, SbLineProjector,
     SbPlaneProjector, SbSpherePlaneProjector, SbSphereProjector,
     SbSphereSectionProjector, SbSphereSheetProjector