NAME

       SoXtSpaceball — translates and reports events for the spaceball

INHERITS FROM

       SoXtDevice > SoXtSpaceball

SYNOPSIS

       #include <Inventor/Xt/devices/SoXtSpaceball.h>

     enum Mask {
          SoXtSpaceball::MOTION   Spaceball translation and rotation events
          SoXtSpaceball::PRESS    Spaceball button press events
          SoXtSpaceball::RELEASE  Spaceball button release events
          SoXtSpaceball::ALL      All spaceball events
     }

          Methods from class SoXtSpaceball:

                         SoXtSpaceball(SoXtSpaceball::Mask mask = SoXtSpaceball::ALL)
                         SoXtSpaceball(Display *d, SoXtSpaceball::Mask mask = SoXtSpaceball::ALL)
                         ~SoXtSpaceball()
     void                setRotationScaleFactor(float f)
     float               getRotationScaleFactor() const
     void                setTranslationScaleFactor(float f)
     float               getTranslationScaleFactor() const
     static SbBool       exists()
     static SbBool       exists(Display *d)

          Methods from class SoXtDevice:

     virtual void             enable(Widget w, XtEventHandler f, XtPointer data, Window win = NULL)
     virtual void             disable(Widget w, XtEventHandler f, XtPointer data)
     virtual const SoEvent *  translateEvent(XAnyEvent *xevent)
     void                     setWindowSize(const SbVec2s &size)
     const SbVec2s &          getWindowSize() const

DESCRIPTION

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

METHODS

                         SoXtSpaceball(SoXtSpaceball::Mask mask = SoXtSpaceball::ALL)
                         SoXtSpaceball(Display *d, SoXtSpaceball::Mask mask = SoXtSpaceball::ALL)
                         ~SoXtSpaceball()
          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 SoXt::init().

     void                setRotationScaleFactor(float f)
     float               getRotationScaleFactor() const
          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                setTranslationScaleFactor(float f)
     float               getTranslationScaleFactor() const
          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.

     static SbBool       exists()
     static SbBool       exists(Display *d)
          This returns TRUE if the spaceball exists, either on the X display which was set in SoXt::init(),   or
          on the passed display.

SEE ALSO

       SoXt, SoXtDevice, SoMotion3Event, SoSpaceballButtonEvent

                                                                                            SoXtSpaceball(3IV)()