NAME

xlibinput_calibrator(8) - calibrate a X11 touch screen device

SYNOPSIS

xlibinput_calibrator [--output-file-x11-config=<filename>] [--dont-save]


                     [--output-file-xinput-cmd=<filename>] [--verbose]


                     [--output-file-udev-libinput-cmd=<filename>]


                     [--threshold-misclick=<nn>] [--start-matrix=_x1,x2..x9_]


                     [--threshold-doubleclick=<nn>] [--show-matrix]


                     [--device-name=<devname>|-device-id=<device-id>]


                     [--show-x11-config] [--show-xinput-cmd]


                     [--show-udev-libinput-cmd] [--monitor-number=<nr>]


                     [--matrix-name=<matrix name>] [--display=<display>]
xlibinput_calibrator --list-devices

DESCRIPTION

xlibinout_calibrator(8) calibrates a touch screen setting the so called libinput _matrix calibration_ using the _xinput_ interfaces.

The possible outcomes of this command are:

DEFAULT TOUCH

xlibinout_calibrator(8) tries to find a suitable device to calibrate on the basis of the following logic:

• if exists ONLY ONE touch, calibrate it
• else if exists MORE THAN ONE touch, raise an error
• else if exists ONLY ONE device with a "libinput Calibration Matrix" property calibrate it
• else raise an error

If you have more than one device that may be elegible as calibration, use the option --device-name=<devname>|--device-id=<device-id>.

OPTIONS

--device-name=<devname>|--device-id=<device-id>

      xlibinout_calibrator(8) selects automatically the device to


      operate. If for some reason this is not possible (eg. avaliability


      of multiple devices), it is possible to select explicitly the


      device with --device-id=... or --device-name=... options (the


      former takes precedence).

--display=<display>

Set the X11 display.

--dont-save

Don't save the setting in X11 when the program ends.

--list-devices

Shows all the avilables devices with their ID. Show also the candidates devices to the calibration.

--matrix-name=<matrix-name>

Set the name of the matrix used for the calibration.

--start-matrix=<x1,x2..x9>

Sets the intial matrix before doing the calibration. By default xlibinput_calibrator(8) sets the calibration matrix to the identity (i.e. all 1 in the diagonal). With this option it is possible to set another matrix. Note that if something goes wrong or the calibration fails, the original matrix is set in X11.

--monitor-number=<nr>

Set the monitor to display the window. If <nr> is equal to 'all', the window will span all the monitors area. Use ’xrandr --listmonitors' to get the <nr> associated to the monitor.

--output-file-udev-libinput-cmd=<filename>

Set the filename where the udev script will be saved. Implies --show-udev-libinput-cmd.

--output-file-x11-config=<filename>

Set the filename where the X11 configuration will be saved. Implies --show-x11-config.

--output-file-xinput-cmd=<filename>

Set the filename where the xinput command will be saved. Implies --show-xinput-cmd.

--show-matrix

Show the final matrix when the program ends.

--show-udev-libinput-cmd

Show the the udev script for libinput to set the matrix_calibration.

--show-x11-config

Show the the `X11` file configuration with the new matrix_calibration.

--show-xinput-cmd

Show the the xinput(1) command to set the matrix_calibration.

--threshold-doubleclick=<nn>

Set the threshold for accept or reject a click. It sets the minimum distance between clicks to accept them. If the value is 0, the check is not performed. Default value 1.

--threshold-misclick=<nn>

Set the threshold for accept or reject a click. The four clicks have to be the in the corners of a rectagle. The value passed are the maximum allowable distance between the click and the ideal point. If the value is 0 (default), the check is not performed.

--verbose

Be verbose.

AUTHOR

Goffredo Baroncelli <kreijack@inwind.it>