table of contents
xinput_calibrator(1) | xinput_calibrator(1) |
NAME¶
xinput_calibrator - A generic touchscreen calibration program for X.OrgSYNOPSIS¶
xinput_calibrator [OPTIONS]DESCRIPTION¶
xinput_calibrator is a program for calibrating your touchscreen, when using the X Window System. It currently features:OPTIONS¶
- -h, --help
- Print a help message listing the version and available options.
- -v, --verbose
- Print debug messages during the process.
- --list
- List the calibratable input devices.
- --device device_name_or_id
- Select a specific device to calibrate; use --list to list the calibratable input devices.
- --precalib min_x max_x min_y max_y
- Manually provide the current calibration setting.
- --misclick nr_of_pixels
- set the misclick threshold (0=off, default: 15 pixels)
- --no-timeout
- turns off the timeout
- --output-type auto|xorg.conf.d|hal|xinput
- type of config to output (auto=automatically detect, default: auto)
- --fake
- Emulate a fake driver (for testing purposes)
- --geometry widthxheight
- Manually provide the geometry (width and height) for the calibration window.
USAGE¶
Run xinput_calibrator in a terminal, as it prints out the calibration values and instructions on standard output. After clicking the 4 calibration points, xinput_calibrator will calculate the new calibration values. Depending on the Xorg touchscreen driver you use, the new values can be made permanent in different ways:- Evdev:
- Automatically recalibrates the driver for this session,
- Usbtouchscreen:
- Automatically recalibrates the *kernel module*, saved in
/etc/modprobe.conf.local
- Other Xorg touchscreen drivers:
- No automatic calibration possible,
EXAMPLES¶
To run the calibrator, type in your terminal:xinput_calibrator If something goes wrong, or not as expected, turn on verbose messages:
xinput_calibrator -v If you have to manually provide the current calibration values (when using EVDEV, you can use this to reset the calibration first):
xinput_calibrator --precalib 0 1000 0 1000
TROUBLESHOOTING¶
In general, run the calibrator with the -v option, it will tell you what happens and what goes wrong. Mis-click detection, the calibrator can automatically detect clicks with unreasonable values. This prevents you from ending up with a bogus calibration. If you keep getting the message 'Mis-click detected, restarting...', one of the following is happening:1. you are bad at clicking on crosses, use a stylus or increase the --misclick threshold
2. your device is not properly supported by the kernel, it interprets the clicks wrong
3. your screen has a non-linear deformation, 4-point calibration can not help you
SEE ALSO¶
xinput(1)AUTHORS¶
Tias Guns <tias@ulyssis.org>
Tias Guns |