XChangePointerControl(3X) XChangePointerControl(3X)NAME XChangePointerControl, XGetPointerControl - control the pointer SYNOPSIS XChangePointerControl(display, do-accel, do-threshold, accel-numerator, accel-denominator, threshold) Display *display; Bool do-accel, do-threshold; int accel-numerator, accel-denominator; int threshold; XGetPointerControl(display, accel-numerator-return, accel-denominator-return, threshold-return) Display *display; int *accel-numerator-return, *accel-denominator-return; int *threshold-return; DESCRIPTION The XChangePointerControl function defines pointer movement. The acceleration, expressed as a fraction, is a multiplier for movement. For example, specifying 3/1 means the pointer moves three times as fast as normal. The fraction may be rounded arbitrarily by the X server. Acceleration only takes effect if the pointer moves more than threshold pixels at once and only applies to the amount beyond the value in the threshold argument. Setting a value to -1 restores the de- fault. The values of do-accel and do-threshold must be TRUE for the pointer values to be set, or the parameters are un- changed. Negative values (other than -1) generate a Bad- Value error, as does a 0 value for the accel-denominator ar- gument. The XGetPointerControl function returns the mouse's current acceleration multiplier and acceleration threshold. Arguments These functions accept the following arguments: accel-denominator Specifies the denominator for the acceleration mul- tiplier. accel-denominator-return Returns the denominator for the acceleration multi- plier. accel-numerator Specifies the numerator for the acceleration multi- plier. November, 1990 1
XChangePointerControl(3X) XChangePointerControl(3X)accel-numerator-return Returns the numerator for the acceleration multi- plier. display Specifies the connection to the X server. do-accel Specifies a Boolean value that controls whether the values for the accel-numerator or accel-denominator are set. One of the following constants can be passed: TRUE or FALSE. do-threshold Specifies a Boolean value that controls whether the value for the accel-numerator or accel-denominator is set. One of the following constants can be passed: TRUE or FALSE. threshold Specifies the acceleration threshold. threshold-return Returns the acceleration threshold. ERRORS BadValue A numeric value falls outside the range of values accepted by the request. Unless a range is speci- fied for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error. The XChangePointerControl function can generate a BadValue error. SEE ALSO Xlib - C Language Interface 2 November, 1990