XSetPointerMapping(3X11)					     MIT X11R4						  XSetPointerMapping(3X11)

Name
       XSetPointerMapping, XGetPointerMapping - manipulate pointer settings

Syntax
       int XSetPointerMapping(display, map, nmap)
	  Display *display;
	  unsigned char map[];
	  int nmap;

       int XGetPointerMapping(display, map_return, nmap)
	  Display *display;
	  unsigned char map_return[];
	  int nmap;

Arguments
       display	 Specifies the connection to the X server.

       map	 Specifies the mapping list.

       map_return
		 Returns the mapping list.

       nmap	 Specifies the number of items in the mapping list.

Description
       The function sets the mapping of the pointer.  If it succeeds, the X server generates a event, and returns Element map[i] defines the logi-
       cal button number for the physical button i+1.  The length of the list must be the same as would return, or a error results.  A zero ele-
       ment disables a button, and elements are not restricted in value by the number of physical buttons.  However, no two elements can have the
       same nonzero value, or a error results.	If any of the buttons to be altered are logically in the down state, returns and the mapping is
       not changed.

       can generate a error.

       The function returns the current mapping of the pointer.  Pointer buttons are numbered starting from one.  returns the number of physical
       buttons actually on the pointer.  The nominal mapping for a pointer is map[i]=i+1.  The nmap argument specifies the length of the array
       where the pointer mapping is returned, and only the first nmap elements are returned in map_return.

Diagnostics
       Some numeric value falls outside the range of values accepted by the request.
		 Unless a specific range is specified 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.

See Also
       XChangeKeyboardControl(3X11), XChangeKeyboardMapping(3X11)
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

															  XSetPointerMapping(3X11)