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)()