Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xchangepointercontrol(3) [hpux man page]

XChangePointerControl() 												   XChangePointerControl()

Name
  XChangePointerControl - change the pointer preferences.

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;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  do_accel  Specifies  a  boolean  value that controls whether the values for the accel_numerator or accel_denominator are set.  You can pass
	    one of these constants:  True or False.

  do_threshold
	    Specifies a boolean value that controls whether the value for the threshold is set.  You can pass one of these  constants:	 True
	    or False.

  accel_numerator
	    Specifies the numerator for the acceleration multiplier.

  accel_denominator
	    Specifies the denominator for the acceleration multiplier.

  threshold Specifies the acceleration threshold.  True or False.

Description
  XChangePointerControl()  defines  how  the  pointing	device functions.  The acceleration is a fraction (accel_numerator/accel_denominator)
  which specifies how many times faster than normal the sprite on the screen moves for a given pointer movement.  Acceleration	takes  effect
  only	when  a  particular  pointer motion is greater than threshold pixels at once, and only applies to the motion beyond threshold pixels.
  The values for do_accel and do_threshold must be True for the pointer values to be set; otherwise, the parameters will be unchanged.	 Set-
  ting any of the last three arguments to -1 restores the default for that argument.

  The fraction may be rounded arbitrarily by the server.

Errors
  BadValue  accel_denominator is 0.
	    Negative value for do_accel or do_threshold.

See Also
  XChangeActivePointerGrab(),  XGetPointerControl(),  XGetPointerMapping(),  XGrabPointer(),  XQueryPointer(), XSetPointerMapping(), XUngrab-
  Pointer(), XWarpPointer().

Xlib - Pointers 													   XChangePointerControl()

Check Out this Related Man Page

XChangePointerControl(3)					  XLIB FUNCTIONS					  XChangePointerControl(3)

NAME
XChangePointerControl, XGetPointerControl - control pointer SYNTAX
int XChangePointerControl(Display *display, Bool do_accel, Bool do_threshold, int accel_numerator, int accel_denominator, int threshold); int XGetPointerControl(Display *display, int *accel_numerator_return, int *accel_denominator_return, int *threshold_return); ARGUMENTS
accel_denominator Specifies the denominator for the acceleration multiplier. accel_denominator_return Returns the denominator for the acceleration multiplier. accel_numerator Specifies the numerator for the acceleration multiplier. accel_numerator_return Returns the numerator for the acceleration multiplier. 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 used. do_threshold Specifies a Boolean value that controls whether the value for the threshold is used. threshold Specifies the acceleration threshold. threshold_return Returns the acceleration threshold. DESCRIPTION
The XChangePointerControl function defines how the pointing device moves. 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 default. The values of the do_accel and do_threshold arguments must be True for the pointer values to be set, or the parameters are unchanged. Negative values (other than -1) generate a BadValue error, as does a zero value for the accel_denominator argument. XChangePointerControl can generate a BadValue error. The XGetPointerControl function returns the pointer's current acceleration multiplier and acceleration threshold. DIAGNOSTICS
BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argu- ment, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error. SEE ALSO
Xlib - C Language X Interface X Version 11 libX11 1.5.0 XChangePointerControl(3)
Man Page