qcontrol(3G)

NAME
     qcontrol - administers event queue

C SPECIFICATION
     long qcontrol(cmd, icnt, idata, ocnt, odata)
     long cmd;
     long icnt;
     short idata[];
     long ocnt;
     short odata[];

PARAMETERS
     cmd     specifies which operation to perform.

     icnt    expects the number of elements in idata.  If the operation only
             returns data, set icnt to zero.

     idata   expects an array containing the data to be used by cmd.  If icnt
             is zero, then idata can be NULL.

     ocnt    expects the number of elements in odata.  If the operation does
             not return data, set ocnt to zero.

     odata   expects the array into which you want the system to write the
             values returned by cmd.  If ocnt is zero, then odata can be NULL.

FUNCTION RETURN VALUE
     Upon successful completion, a value of 0 is returned. Otherwise, the
     returned value is a negative integer whose absolute value is an error
     value defined in <errno.h>.

DESCRIPTION
     The qcontrol routine is used to control various administrative aspects of
     the event queue and is intended for use by window management systems and
     input device daemons.

     The following values for cmd are currently recognized:

     QC_SETKEYWARP
          Sets the graphics console keyboard auto-repeat threshold and rate to
          idata[0] and idata[1] respectively.  The threshold represents the
          time between the initial key press and the beginning of auto-repeat.
          The rate value represents the inter-character repeat interval.

     QC_GETKEYWARP
          Returns in the keyboard repeat threshold in odata[0] and the repeat
          rate in odata[1].

     QC_SETMOUSEWARP
          Sets the mouse acceleration threshold and multiplier to idata[0] and
          (16 * idata[1]) respectively.  Whenever the mouse is moved, a delta
          value from its last known position is computed.  If the delta value
          exceeds the acceleration threshold, then both the x and y components
          of the motion are multiplied by the acceleration multiplier.  If
          idata[0] and idata[1] are both zero, then the acceleration and
          threshold are reset to the defaults.

     QC_GETMOUSEWARP
          Returns in odata[0] and odata[1] the current mouse accelerator
          threshold and multiplier values.

     QC_SETDIALWARP
          Sets the dial acceleration threshold and multiplier to idata[0] and
          (16 * idata[1]) respectively.  Whenever the dial is moved, a delta
          value from its last known position is computed.  If the delta value
          exceeds the acceleration threshold, then both the x and y components
          of the motion are multiplied by the acceleration multiplier.  If
          idata[0] and idata[1] are both zero, then the acceleration and
          threshold are reset to the defaults.

     QC_GETDIALWARP
          Returns in odata[0] and odata[1] the current dial accelerator
          threshold and multiplier values.

SEE ALSO
     qdevice, setvaluator

NOTES
     This routine is available only in immediate mode.

     The symbolic command values mentioned above are defined in
     <gl/qcontrol.h>.