qcontrol(3G)qcontrol(3G)NAMEqcontrol - 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
Page 1
qcontrol(3G)qcontrol(3G)
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>.
Page 2