Provided by: xserver-xorg-input-wacom_1.2.0-1ubuntu2_amd64 bug

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 aliases for modifiers and other keys that can be used when setting button
              action mappings.

   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
              reproduce 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
              orientation,  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. If button-number is mapped to 0, the Button event
              is ignored.

              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
              button-number will produce 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.

              The  "key"  keyword  is  followed  by  a list of key names. These can optionally be
              preceded by "+" for press and "-" for release. If  +/-  is  not  given,  press-and-
              release is assumed, except for modifier keys which are left pressed.  Key names can
              be X11 KeySyms or some aliases such as 'shift' or 'f1' (the full list can  be  seen
              with the list modifiers command).

              To   assign  a  key  that  is  not  in  the  modifiers  list,  use  the  KeySym  in
              /usr/include/X11/keysymdef.h with the XK_ prefix removed or its actual value as is.
              For  example, XK_BackSpace should be specified as "BackSpace". "0xff80" can also be
              used to replace "BackSpace" since it's the unique KeySym value of Backspace key.

              Here is a combined example: "key +a shift b shift -a 0xff0d"  converts  the  button
              into  a  series  of  keystrokes.  In this example, "press a, press shift, press and
              release b, release shift, release a, then press and release enter".  "key +a +shift
              b -shift -a 0xff0d" does the same thing.

              The "button" keyword is similar except that its arguments are X11 button numbers.

              The "modetoggle" keyword is also recognized; it takes no arguments, and toggles the
              device mode between relative and absolute pointer tracking.

              The "pan" keyword causes the driver to send scroll events while the pen is dragged.
              This  makes  it easy to scroll through lists and documents, pan around 2D canvases,
              and zoom in/out of 3D scenes (exact behavior depends on application  interpretation
              of  scrollwheel  events).  Dragging  the  pen up/down will send scrollwheel down/up
              events; dragging it left/right will send scrollwheel right/left events.

              The events in the action mapping are sent when the physical button is pressed.   If
              the  action  mapping  leaves  any buttons or keys pressed (such as a modifier key),
              they will be released when the physical button is released.

              Multiple keywords may be present in one action if desired: for example  "key  +ctrl
              button 5 key -ctrl". Each keyword takes all arguments until the next keyword.

              A maximum of 256 presses and/or releases can be specified in an action mapping.

              The  driver  can  only  simulate  physical key events but not keysyms and xsetwacom
              translates the mapping sequence  into  such  events.  Thus,  symbols  on  the  same
              physical 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 keyboard. 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
              output, 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
              corresponds  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
              Suppress value in order to be sent on.  Suppress is a  tablet  wide  parameter.   A
              specified  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
              ToolDebugLevel.  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
              number 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.

       HWTouchSwitchState on|off
              If on, it means touch switch is turned off. That is, touch events are  reported  to
              userland.  If off, touch switch is turned on, i.e., touch events are ignored.  This
              is a read-only parameter. Initial touch switch state is retrieved from  the  kernel
              when X driver starts.

       CursorProximity distance
              Set  the  distance  at  which a relative tool is treated as being out of proximity.
              Beyond this distance the cursor will stop responding to tool  motion.  The  default
              value  for  pucks  is  10 (Intuos Pro) or 42 (Intuos/Bamboo). The default value for
              pens is 30.

       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
              independent 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.

       PressureRecalibration on|off
              If  the  initial  pressure of a device is != 0 the driver recalibrates the pressure
              range. This is to account for worn out devices.  The downside is that when the user
              hits  the tablet very hard the initial pressure reading may be unequal to zero even
              for a perfectly good pen. If the consecutive pressure readings are not higher  than
              the initial pressure by a threshold no button event will be generated.  This option
              allows to disable the recalibration.  Default:  on

       PanScrollThreshold distance
              This specifies the distance the pen must move (in tablet  units)  before  a  scroll
              event  is  generated  when using the "pan" action. Smaller values will require less
              distance and be more sensitive. Larger values will require  more  distance  and  be
              less  sensitive.  Default: 1300 or 2600 depending on tablet resolution (corresponds
              to 13 mm of distance).

WAYLAND SUPPORT

       This tool provides access to the device properties implemented in the  xf86-input-wacom  X
       server  input  module.  It does not work under a Wayland compositor as the input module is
       not active.

       See https://github.com/linuxwacom/xf86-input-wacom/wiki/Wayland for details.

AUTHORS

       Peter Hutterer <peter.hutterer@redhat.com>

SEE ALSO

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

       More information is available at https://github.com/linuxwacom/xf86-input-wacom

                                      xf86-input-wacom 1.2.0                         xsetwacom(1)