xinput_calibrator(1)

1xinput_calibrator(1)                                      xinput_calibrator(1)
2
3
4

NAME

6       xinput_calibrator - A generic touchscreen calibration program for X.Org
7
8

SYNOPSIS

10       xinput_calibrator [OPTIONS]
11

DESCRIPTION

13       xinput_calibrator  is  a program for calibrating your touchscreen, when
14       using the X Window System.
15
16       It currently features:
17       - works for any standard Xorg touchscreen driver (uses XInput protocol)
18       - mis-click detection (prevents bogus calibration)
19       - dynamically recalibrates the evdev driver
20       - outputs the calibration as xorg.conf.d snippet or HAL policy file
21       - and more
22
23       see http://www.freedesktop.org/wiki/Software/xinput_calibrator
24
25

OPTIONS

27       -h, --help
28               Print a help message listing the version and available options.
29
30       -v, --verbose
31               Print debug messages during the process.
32
33       --list  List the calibratable input devices.
34
35       --device device_name_or_id
36               Select a specific device to calibrate; use --list to  list  the
37               calibratable input devices.
38
39       --precalib min_x max_x min_y max_y
40               Manually provide the current calibration setting.
41               This  is  useful  if  the calibration values are stored in your
42               xorg.conf, but the driver does not export them  through  XInput
43               (eg. the calibrator can not know these values)
44
45       --misclick nr_of_pixels
46               set the misclick threshold (0=off, default: 15 pixels)
47
48       --output-type auto|xorg.conf.d|hal|xinput
49               type  of  config  to ouput (auto=automatically detect, default:
50               auto)
51
52       --fake  Emulate a fake driver (for testing purposes)
53               Useful to test the calibrator without applying the values,  and
54               possibly even without having a touchscreen.
55

USAGE

57       Run  xinput_calibrator  in a terminal, as it prints out the calibration
58       values and instructions on standard output.
59
60       After clicking the 4 calibration points, xinput_calibrator will  calcu‐
61       late  the  new  calibration  values.  Depending on the Xorg touchscreen
62       driver you use, the new values can be made permanent in different ways:
63
64       Evdev:
65           Automatically recalibrates the driver for this session,
66           Supports following --output-types: auto, xorg.conf.d, hal, xinput
67
68
69       Usbtouchscreen:
70           Automatically recalibrates the *kernel module*, saved in  /etc/mod‐
71           probe.conf.local
72           Supports following --output-types: auto
73
74
75       Other Xorg touchscreen drivers:
76           No automatic calibration possible,
77           Supports following --output-types: auto, xorg.conf.d, hal
78

EXAMPLES

80       To run the calibrator, type in your terminal:
81
82           xinput_calibrator
83
84       If something goes wrong, or not as expected, turn on verbose messages:
85
86           xinput_calibrator -v
87
88       If  you  have  to manually provide the current calibration values (when
89       using EVDEV, you can use this to reset the calibration first):
90
91           xinput_calibrator --precalib 0 1000 0 1000
92

TROUBLESHOOTING

94       In general, run the calibrator with the -v option,  it  will  tell  you
95       what happens and what goes wrong.
96
97       Mis-click  detection,  the  calibrator  can automatically detect clicks
98       with unreasonable values. This prevents you from ending up with a bogus
99       calibration.
100
101       If  you  keep  getting the message 'Mis-click detected, restarting...',
102       one of the following is happening:
103         1. you are bad at clicking on crosses, use a stylus or  increase  the
104       --misclick threshold
105         2. your device is not properly supported by the kernel, it interprets
106       the clicks wrong
107         3. your screen has a non-linear deformation, 4-point calibration  can
108       not help you
109

AUTHORS

114       Tias Guns <tias@ulyssis.org>
115
116
117
118Tias Guns                                                 xinput_calibrator(1)