Calibrate a touchscreen
Note:
You must be
root to run this utility.
The calib-touch utility is a window manager.
If you have another window manager started by your startup script, it's best
to run calib-touch before running your other window manager.
Syntax:
calib-touch [options]
Options:
- -config-file=str
- Set an alternative configuration filename (default is
/etc/system/config/calib.<hostname>).
This calibration tool requires access to write a configuration
file. If /etc/system/config is on a
read-only filesystem, then you will need to specify a different
path and filename so that calib-touch has
permissions to write the configuration file.
- -display=str|integer
- Set the display ID or the connection type to the display. If an
integer is provided, Screen will
interpret the integer as the indication of the display identifier.
Otherwise, if a string is provided, Screen
will interpret the string as the display connection type.
The connection type of display port can be one of the following
strings:
- internal
- composite
- svideo
- YPbPr
- rgb
- rgbhv
- dvi
- hdmk
- rgbhv
- -exit-on-timeout
- Exit this application after 5 seconds of
inactivity on each calibration screen, or 30 seconds
of inactivity on the final calibration screen.
Otherwise, this application restarts.
- -format=str
- Set the pixel format of the window (default is the pixel format
assigned by Screen Graphics Subsystem). The pixel format
can be one of the following strings:
- -interval=int
- Set the swap interval (default is 1).
- -pos=x,y
- Set the position of the viewport (default is 0, 0).
- -recalibrate
- Perform a calibration despite the existence of a calibration file.
The existing calibration file will be overwritten. You may need
to recalibrate if you make any changes related to the touch
device (e.g., changing your display or display resolution).
- -sample-limit=int
- Set the number of samples for each target (default is 10).
- -size=widthxheight
- Set the size of the viewport (default is fullscreen).
- -verbose=int
- Set the verbosity level (default is 0).
- -zorder=int
- Set the z-order of the window (default is 0).
Description:
The calib-touch utility is used to calibrate a touchscreen.
Once the touchscreen is successfully configured , the calib-touch
utility saves a configuration file at
/etc/system/config/calib.$hostname.
Prior to starting the touch calibration, ensure that you have an appropriate
begin mtouch section in your graphics.conf
file to define your touch device.
To invoke the calibration tool:
- Ensure that screen is running.
- Run calib-touch from either your startup script
or from a shell.
- Touch the bull's-eye targets on each of the display screens.
- Touch the Accept button to finish calibration.
You can use the Esc key to exit the calibration tool at any time.