dwww Home | Manual pages | Find package

TS_CALIBRATE(1)                      tslib                     TS_CALIBRATE(1)

NAME
       ts_calibrate  -  A  test  program  to  calibrate a touch screen used by
       tslib.

SYNOPSIS
       ts_calibrate

DESCRIPTION
       ts_calibrate is  used  to  manually  configure  tslib's  linear  filter
       plugin.  It  draws  crosshairs  to the framebuffer to be touched by the
       user and records expected vs. actual touch contact positions needed  to
       apply  the  filter and provide a desired touch user experience. It uses
       the TSLIB_CALIBFILE environment variable to store it's values.

       -r, --rotate [value]

           Rotate the screen. value is 0 for 0 degree, 1 for 90 degrees  (CW),
           2  for  180 degrees (upside down) and 3 for 270 degrees (CCW). This
           value will be added to the calibration config file  TSLIB_CALIBFILE
           and  picked  up from the linear filter module from there. It can be
           changed by a linear module parameter.

       -t, --min_interval

           The time in milliseconds that has to pass  before  a  crosshair  is
           pressed  by  the user. This may be useful to avoid insanely fast or
           accidentally wrong taps and thus inaccurate  calibration.  Default:
           0.

       -c, --validate

           Validate the calibration. Make sure the linear module is configured
           in ts.conf so that the current  calibration  is  applied.  In  this
           mode,  crosses  are  displayed  at  random  locations on screen and
           touches are evaluated against their positions.  In  this  mode  the
           --loops and --boundary options are available.

       -b, --boundary

           Validation  boundary  in  pixels. Available only when --validate is
           used. This defines how strict the validation should  be.  It's  the
           the  distance  that an evaluated touch input is allowed to be apart
           from a cross to still pass the  validation.  If  this  boundary  is
           crossed, validation fails. Default: 10.

       -l, --loops

           Number  of loops in validation mode. Available only when --validate
           is used. This defines how many crosses should be touched and evalu-
           ated. Default: 3.

ENVIRONMENT VARIABLES
       see ts.conf (5)

SEE ALSO
       ts.conf (5), ts_test (1), ts_uinput (1)

                                                               TS_CALIBRATE(1)

Generated by dwww version 1.15 on Sat Jun 29 02:28:34 CEST 2024.