Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  plu-
       gin.  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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ts_calibrate&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help