The idea of tslib is to have a core library that provides standardised services, and a set of plugins to manage the conversion and filtering as needed.
The plugins for a particular touchscreen are loaded automatically by the library under the control of a static configuration file, /etc/ts.conf. /etc/ts.conf gives the library basic configuration information. Each line specifies one module, and the parameters for that module. The modules are loaded in order, with the first one processing the touchscreen data first. For example:
module_raw input module variance delta=30 module dejitter delta=100 module linear
variance
This is a 'greedy' filter, e.g. it gives less samples on output than receives on input.
Set the squared distance in touchscreen units between previous and current pen position (e.g. (X2-X1)^2 + (Y2-Y1)^2). This defines the criteria for determining whenever two samples are 'near' or 'far' to each other.
If the distance between previous and current sample is 'far', the sample is marked as 'potential noise'. This doesn't mean yet that it will be discarded; if the next reading will be close to it, this will be considered just a regular 'quick motion' event, and it will sneak to the next layer. Also, if the sample after the 'potential noise' is 'far' from both previously discussed samples, this is also considered a 'quick motion' event and the sample sneaks into the output stream.
dejitter
Squared distance between two samples ((X2-X1)^2 + (Y2-Y1)^2) that defines the 'quick motion' threshold. If the pen moves quick, it is not feasible to smooth pen motion, besides quick motion is not precise anyway; so if quick motion is detected the module just discards the backlog and simply copies input to output.
linear
Interchange the X and Y co-ordinates -- no longer used or needed if the new linear calibration utility ts_calibrate is used.
Latest versions of the Xorg tslib input driver use hal to configure the touchscreen within Xorg. Environment variables are only needed for the tslib commands.
TSLIB_TSDEVICE
Default: /dev/input/event0
TSLIB_CONSOLEDEVICE
Default: /dev/tty
TSLIB_CALIBFILE
Default: /etc/pointercal
TSLIB_CONFFILE
Default; /etc/ts.conf.
TSLIB_FBDEVICE
Default: /dev/fb0.
TSLIB_PLUGINDIR
Default: /usr/lib/ts/.
This manual page was written by Neil Williams <codehelp@debian.org> for the Debian(TM) distribution because the original program does not have a manual page, but may be used by others. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
Russell King