1TS_CALIBRATE(1)                      tslib                     TS_CALIBRATE(1)
2
3
4

NAME

6       ts_calibrate  -  A  test  program  to  calibrate a touch screen used by
7       tslib.
8
9

SYNOPSIS

11       ts_calibrate
12
13

DESCRIPTION

15       ts_calibrate is used to manually configure tslib's linear filter  plug‐
16       in.  It  draws  crosshairs to the framebuffer to be touched by the user
17       and records expected vs. actual touch contact positions needed to apply
18       the  filter  and  provide  a desired touch user experience. It uses the
19       TSLIB_CALIBFILE environment variable to store it's values.
20
21
22       -r, --rotate [value]
23
24           Rotate the screen. value is 0 for 0 degree, 1 for 90 degrees  (CW),
25           2  for  180 degrees (upside down) and 3 for 270 degrees (CCW). This
26           value will be added to the calibration config file  TSLIB_CALIBFILE
27           and  picked  up from the linear filter module from there. It can be
28           changed by a linear module parameter.
29
30       -t, --min_interval
31
32           The time in milliseconds that has to pass  before  a  crosshair  is
33           pressed  by  the user. This may be useful to avoid insanely fast or
34           accidentally wrong taps and thus inaccurate  calibration.  Default:
35           0.
36
37       -c, --validate
38
39           Validate the calibration. Make sure the linear module is configured
40           in ts.conf so that the current  calibration  is  applied.  In  this
41           mode,  crosses  are  displayed  at  random  locations on screen and
42           touches are evaluated against their positions.  In  this  mode  the
43           --loops and --boundary options are available.
44
45       -b, --boundary
46
47           Validation  boundary  in  pixels. Available only when --validate is
48           used. This defines how strict the validation should  be.  It's  the
49           the  distance  that an evaluated touch input is allowed to be apart
50           from a cross to still pass the  validation.  If  this  boundary  is
51           crossed, validation fails. Default: 10.
52
53       -l, --loops
54
55           Number  of loops in validation mode. Available only when --validate
56           is used. This defines how many crosses should be touched and evalu‐
57           ated. Default: 3.
58

ENVIRONMENT VARIABLES

60       see ts.conf (5)
61

SEE ALSO

63       ts.conf (5), ts_test (1), ts_uinput (1)
64
65
66
67                                                               TS_CALIBRATE(1)
Impressum