SoXtSpaceball(3IV)

NAME
     SoXtSpaceball (SoXtSpball) - translates and reports events for the
     spaceball

INHERITS FROM
     SoXtDevice > SoXtSpaceball

SYNOPSIS
     #include <Inventor_c/Xt/devices/SoXtSpaceball.h>

     typedef SoXtSpaceball  SoXtSpball

     enum SoXtSpaceballMask {
          SO_XT_SPBALL_MOTION   Spaceball translation and rotation events
          SO_XT_SPBALL_PRESS    Spaceball button press events
          SO_XT_SPBALL_RELEASE  Spaceball button release events
          SO_XT_SPBALL_ALL      All spaceball events
     }

          Functions from class SoXtSpaceball:

     SoXtSpaceball *     SoXtSpballCreate(SoXtSpaceball::Mask mask =
                              SoXtSpaceball::ALL)
     SoXtSpaceball *     SoXtSpballCreateD(Display *d, SoXtSpaceball::Mask
                              mask = SoXtSpaceball::ALL)
     void                SoXtSpballDelete(SoXtSpball *this)
     void                SoXtSpballSetRotScaleFactor(SoXtSpball *this, float
                              f)
     float               SoXtSpballGetRotScaleFactor(const SoXtSpball *this)
     void                SoXtSpballSetXlateScaleFactor(SoXtSpball *this, float
                              f)
     float               SoXtSpballGetXlateScaleFactor(const SoXtSpball *this)
     SbBool              SoXtSpballExists()
     SbBool              SoXtSpballExistsD(Display *d)

          Functions from class SoXtDevice:

     void                SoXtSpballEnable(SoXtSpball *this, Widget w,
                              XtEventHandler f, XtPointer data, Window win =
                              NULL)
     void                SoXtSpballDisable(SoXtSpball *this, Widget w,
                              XtEventHandler f, XtPointer data)
     const SoEvent *     SoXtSpballXlateEv(SoXtSpball *this, XAnyEvent
                              *xevent)
     void                SoXtSpballSetWinSize(SoXtSpball *this, const SbVec2s
                              *size)
     const SbVec2s *     SoXtSpballGetWinSize(const SoXtSpball *this)


DESCRIPTION
     This class manages events generated by the spaceball, including spaceball
     motion (SoMotion3Event), and spaceball button press and release events
     (SoSpaceballButtonEvent).

FUNCTIONS
     SoXtSpaceball *     SoXtSpballCreate(SoXtSpaceball::Mask mask =
                              SoXtSpaceball::ALL)
     SoXtSpaceball *     SoXtSpballCreateD(Display *d, SoXtSpaceball::Mask
                              mask = SoXtSpaceball::ALL)
     void                SoXtSpballDelete(SoXtSpball *this)
          Constructor and destructor. Pass to the constructor an enumerated
          value specifying which spaceball events are of interest. Only those
          events will be reported to the callback routine registered on each
          widget.  The first constructor uses the X display which was set in
          SoXtInit().

     void                SoXtSpballSetRotScaleFactor(SoXtSpball *this, float
                              f)
     float               SoXtSpballGetRotScaleFactor(const SoXtSpball *this)
          Set and get the rotation scale factor. The scale factor is applied
          to the rotation value generated by the spaceball device. The default
          rotation scale factor is .006.

     void                SoXtSpballSetXlateScaleFactor(SoXtSpball *this, float
                              f)
     float               SoXtSpballGetXlateScaleFactor(const SoXtSpball *this)
          Set and get the translation scale factor. The scale factor is
          applied to the translation value generated by the spaceball device.
          The default translation scale factor is .006.

     SbBool              SoXtSpballExists()
     SbBool              SoXtSpballExistsD(Display *d)
          This returns TRUE if the spaceball exists, either on the X display
          which was set in  SoXtInit(), or on the passed display.


SEE ALSO
     SoXt, SoXtDevice, SoMotion3Event, SoSpaceballButtonEvent