Unix/Linux Go Back    


CentOS 7.0 - man page for xsetwacom (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


xsetwacom(1)									     xsetwacom(1)

NAME
       xsetwacom - commandline utility to query and modify wacom driver settings.

SYNOPSIS
       xsetwacom [options] [command [arguments]]

DESCRIPTION
       This  program queries or changes properties on the devices loaded by the wacom driver. The
       modification of properties happens at runtime and  is  not  persistent  through	X  server
       restarts.

GENERAL OPTIONS
       -d, --display display_name
	      Connect to the X server specified in display_name; see X(7).

       -h, --help
	      Prints a short help.

       -v, --verbose
	      Enable verbose output, useful for debugging.

       -V, --version
	      Display version number and exit.

COMMANDS
       Allowed commands are list, get, and set.  The command may be specified with or without one
       or two preceding dashes, i.e.  --list is equivalent to -list and list.

   LIST COMMANDS
       list devices
	      List known devices. Only input devices managed by the wacom driver are listed.

       list parameters
	      List known parameters. List all parameters suitable for the get or the set command.
	      Note that not all parameters are available on all device types.

       list modifiers
	      List the available list of modifiers to be used when setting key or button actions.

   GET COMMANDS
       get device_name parameter
	      Get  the	current settings for the parameter on the given device. Note that not all
	      parameters are available on all device types. The special parameter name "all"  may
	      be provided to display all current settings on the device.

       By default, options are printed on the commandline in the respective format.
	      The output format may be altered with one of the following options:

       -s, --shell
	      Display  the  output in shell format, i.e. as shell commands to xsetwacom to repro-
	      duce the same parameter.

       -x, --xconf
	      Display the output in xorg.conf format, i.e. as option lines that may be	added  to
	      the InputDevice section in the xorg.conf.

   SET COMMANDS
       set device_name parameter [value]
	      Set  the	parameter  value on the given device to the value provided. Note that not
	      all parameters are writable, some are read-only and result in an error when  trying
	      to be modified.

PARAMETERS
       Not  all parameters are available on all tools.	Use the get command with the parameter or
       "all" parameter for specific input tool applicable parameters and current settings.

       Area x1 y1 x2 y2
	      Set the tablet input area in device coordinates in the form top left x/y and bottom
	      right  x/y.  Top	left and bottom right are defined in the device's native orienta-
	      tion, regardless of the actual rotation currently applied. Input outside	of  these
	      coordinates will be clipped to the edges of the area defined.  Default:  0 0 x2 y2;
	      with x2 and y2 tablet specific.

       Button button-number [mapping]
	      Set a mapping for the specified button-number. Mappings take the form of	either	a
	      single  numeric  button  or an 'action' to be performed. If no mapping is provided,
	      the default mapping is restored.

	      Numeric button mappings indicate what X11 button	number	the  given  button-number
	      should correspond to. For example, a mapping of "3" means a press of the given but-
	      ton-number will produce as a press of X11 button 3 (i.e. right click).

	      Action mappings allow button presses to perform many events. They take the form  of
	      a  string  of keywords and arguments. For example, "key +a +shift b -shift -a" con-
	      verts the button into a series of keystrokes,  in  this  example	"press	a,  press
	      shift,  press  and  release  b, release shift, release a". In addition to the "key"
	      keyword, "button" and "modetoggle" are also recognized. Multiple	keywords  may  be
	      present in one action if desired: for example "key +ctrl button 5 key -ctrl".

	      The  driver  can	only  simulate	physical  key events but not keysyms and xetwacom
	      translates the mapping sequence into such events. Thus, symbols on the same  physi-
	      cal  key will generate the same event. For example, '1' and '!' are on the same key
	      on a US keyboard and thus have the same keycode).  For access to keys on	a  higher
	      shift level, the sequence should be entered as it would be typed on a physical key-
	      board. For example, a exclamation mark is entered by the sequence of "key +shift	1
	      -shift".

       BindToSerial [serial|0]
	      Bind  the  device  to  the  tool	with the specified serial number. Once bound, the
	      device will ignore events from other tools. A serial  of	0  means  the  device  is
	      unbound and will react to any tool of the matching type.	Default: 0

       MapToOutput [output]
	      Map  the	tablet's  input  area  to  a given output (e.g. "VGA1"). Output names may
	      either be the name of a head available through the  XRandR  extension,  or  an  X11
	      geometry	string of the form WIDTHxHEIGHT+X+Y. To switch to the next available out-
	      put, the "next" keyword is also supported. This will cycle between  the  individual
	      monitors	connected  to the system, and then the entire desktop. The mapping may be
	      reset to the entire desktop at any time with the output name  "desktop".	Users  of
	      the  NVIDIA  binary  driver should use the output names "HEAD-0" and "HEAD-1" until
	      the driver supports XRandR 1.2 or later.

	      The output mapping configuration is a onetime setting and  does  not  track  output
	      reconfigurations;  the command needs to be re-run whenever the output configuration
	      changes. When used with tablet rotation, the tablet must be rotated  before  it  is
	      mapped to the new screen. This parameter is write-only and cannot be queried.

       Mode Absolute|Relative
	      Set the device mode as either Relative or Absolute. Relative means pointer tracking
	      for the device will function like a mouse, whereas Absolute means the pointer  cor-
	      responds	to  the  device's  actual  position  on  the  tablet or tablet PC screen.
	      Default:	Absolute for stylus, eraser and tablet PC touch; Relative for cursor  and
	      tablet touch.

       PressureCurve x1 y1 x2 y2
	      A  Bezier curve of third order, composed of two anchor points (0,0 and 100,100) and
	      two user modifiable control points that define the curve's shape.  Raise the  curve
	      (x1<y1 x2<y2) to "soften" the feel and lower the curve (x1>y1 x2>y2) for a "firmer"
	      feel.  Sigmoid shaped curves are permitted (x1>y1 x2<y2 or x1<y1 x2>y2).	 Default:
	      0 0 100 100, a linear curve; range of 0 to 100 for all four values.

       RawSample level
	      Set  the	sample window size (a sliding average sampling window) for incoming input
	      tool raw data points.  Default:  4, range of 1 to 20.

       Rotate none|half|cw|ccw
	      Set the tablet to the given rotation:
		none: the tablet is not rotated and uses its natural rotation
		half: the tablet is rotated by 180 degrees (upside-down)
		cw: the tablet is rotated 90 degrees clockwise
		ccw: the tablet is rotated 90 degrees counter-clockwise

	      Rotation is a tablet-wide option: rotation of one  tool  affects	all  other  tools
	      associated  with the same tablet. When the tablet is physically rotated, rotate any
	      tool to the corresponding orientation.  Default:	none

       Suppress level
	      Set the delta (difference) cutoff level for further processing  of  incoming  input
	      tool coordinate values.  For example a X or Y coordinate event will be sent only if
	      the change between the current X or Y coordinate and the previous  one  is  greater
	      than  the  Suppress  value.   The same applies to pressure level (Z coordinate) and
	      Tilt rotation values.  With a current absolute wheel (AbsWheel) or Tilt  value  the
	      delta  between  it and the previous value must be equal to or greater than the Sup-
	      press value in order to be sent on.  Suppress is a tablet wide parameter.  A speci-
	      fied  delta  level for one input tool is applied to all input tool coordinates.  To
	      disable suppression use a level of 0.  Default:  2, range of 0 to 100.

       TabletDebugLevel level
	      Set the debug level for this tablet to the given	level.	This  only  affects  code
	      paths  that  are shared between several tools on the same physical tablet. A higher
	      level means more fine-grained debug messages, a level of 0 turns debugging off  for
	      this tool. Requires the driver to be built with debugging enabled. See also ToolDe-
	      bugLevel.  Default:  0, range of 0 to 12.

       TabletPCButton on|off
	      If on, the stylus must be in contact with the screen for a stylus  side  button  to
	      work.   If  off,	stylus	buttons  will work once the stylus is in proximity of the
	      tablet (regardless of whether it is touching the screen).  Default:  on for  Tablet
	      PCs; off for all other models.

       ToolSerialPrevious
	      Get the serial number of the tool that was last in proximity last. This serial num-
	      ber is updated whenever the tool goes out of proximity. If the  current  tool  went
	      out of proximity once, this serial number is the one of the current tool. This is a
	      read-only parameter.

       Touch on|off
	      If on, touch events are reported to userland, i.e., system cursor moves  when  user
	      touches  the tablet. If off, touch events are ignored. Default: on for devices that
	      support touch; off for all other models.

       CursorProximity distance
	      sets the max distance from tablet to stop reporting movement for cursor in relative
	      mode.  Default  for Intuos series is 10, for Graphire series (including Volitos) is
	      42. Only available for the cursor/puck device.

       Threshold level
	      Set the minimum pressure necessary to generate a Button event for the  stylus  tip,
	      eraser, or touch.  The pressure levels of all tablets are normalized to 2048 levels
	      irregardless of the actual hardware supported levels.  This parameter  is  indepen-
	      dent of the PressureCurve parameter.  Default:  27, range of 0 to 2047.

       ToolDebugLevel level
	      Set  the debug level for this tool to the given level. This only affects code paths
	      that are specific to a given tool. A higher level  means	more  fine-grained  debug
	      messages, a level of 0 turns debugging off for this tool. Requires the driver to be
	      built with debugging enabled. See also TabletDebugLevel.	Default:  0, range  of	0
	      to 12.

AUTHORS
       Peter Hutterer <peter.hutterer@redhat.com>

SEE ALSO
       Xorg(1), wacom(4), xorg.conf(5), X(7)

       More information is available at http://linuxwacom.sourceforge.net

X Version 11			     xf86-input-wacom 0.23.0			     xsetwacom(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 07:00 PM.