Commit: 2d732a7e50e9356653fb92650e1ccebc135e1202 - xinput_calibrator (git)

A generic touchscreen calibration program for X.Org

Commit MetaInfo

• Revision: 2d732a7e50e9356653fb92650e1ccebc135e1202 (tree)
• Time: 2009-12-02 07:44:51
• Author: Tias <tias@kata...>
• Commiter: Tias

Log Message

Add README and Changelog
remove reference to evtouch in precalib script

Change Summary

• add: Changelog
• add: README
• modified: get_precalib.sh

Incremental Difference

--- /dev/null
+++ b/Changelog
@@ -0,0 +1,17 @@
+xinput_calibrator 0.4.1 [2009-12-1]
+Other:
+* Add README and Changelog file
+
+xinput_calibrator 0.4.0 [2009-12-1]
+New features/improvements:
+* Add example FDI policy file for generic touchscreen, next to example xorg.conf values
+* Add support for providing the current calibration on the command line (with --precalib), add help information (-h or --help). Included a script that reads the current calibration data from lshal, and runs the calibration program with the right --precalib data
+* Add support for dynamic evdev re-calibration
+
+
+xinput_calibrator 0.2.0 [2009-09-10]
+New features/improvements:
+* Add generic xinput methods for reading the current data and writing example xorg.conf files.
+* put usbtouchscreen specific stuff in a new subclass
+* Initial code from
+http://lists.x.org/archives/xorg/2008-September/039064.html

--- /dev/null
+++ b/README
@@ -0,0 +1,35 @@
+This is xinput_calibrator v0.4.1
+
+xinput_calibrator: A generic touchscreen calibration program, for all Xorg touchscreen drivers.
+
+Website: http://www.freedesktop.org/wiki/Software/xinput_calibrator
+
+
+Build instructions:
+-------------------
+    g++ -Wall xinput_calibrator.cc `pkg-config --cflags --libs gtkmm-2.4` -o xinput_calibrator
+
+Installation instructions:
+--------------------------
+You need to have the package 'gtkmm-2.4' installed ! (this dependency will be removed in the next version)
+
+Usage:
+------
+Simply run:
+    ./xinput_calibrator
+If the program uses the wrong running calibration values (because you already altered the xorg.conf or FDI policy file), run the wrapper:
+    ./get_precalib.sh
+
+
+More information:
+-----------------
+Because all existing calibrators were driver dependent and hard to use, xinput_calibrator was created. The goal of xinput_calibrator is to: 
+* work for any Xorg driver (use Xinput to get axis valuators), 
+* output the calibration as Xorg.conf and FDI policy file values, 
+* support advanced driver options, such as Evdev's dynamic calibration, 
+* have a very intuitive GUI (normal X client). 
+
+Xinput_calibrator is based on a simple calibrator that was proposed on the Xorg mailinglist. The first release(v0.2.0) improved upon it by reading axis valuators from Xinput, hence making it generic for all touchscreen drivers. The announcement was done on the Xorg mailinglist, and the code is on Tias' webpage. 
+
+The new version (v0.4.0) writes Xorg.conf and (HAL) FDI policy file values, and contains a wrapper script to get axis valuator information for the evtouch driver (evtouch does not export the current calibration through its axis valuators). It is also the first program to support dynamic evdev calibration, by using its advanced Xinput functionality.
+

--- a/get_precalib.sh
+++ b/get_precalib.sh
@@ -1,5 +1,5 @@
 #!/bin/sh
-# Get running EVTOUCH calibration data from lshal
+# Get running calibration data from lshal
 # (needed to recalibrate it, most easily fetchable from lshal)
 
 export PATH=".:$PATH"