gf-calib

Advanced Graphics utility for calibrating a touchscreen

Syntax:

gf-calib [options]

Runs on:

Neutrino

Options:

-3
Use the 3-point calibration method. This is the default method.
-4
Use the 4-point calibration method.
-c
Overwrite the calibration configuration file if it exists. The default location is /etc/system/config/calib.$(hostname).
-d device
Use the specified GF device.
-D
Don't display the pointer cursor when running. Use this option if your graphics driver doesn't support pointer cursors, or if you get errors from gf_cursor_set().
-f file
The name and location of a configuration file to create instead of the default at /etc/system/config/calib.$(hostname).
-g input_group
Specify the GFI input group to attach to. The input group is created and enumerated by a devi-* driver configured to export input groups. The default input group is 1.
-i idx
The display index. The default is 0.
-l idx
(“el”) The layer index. The default is the main layer.
-m x y
Set the touch screen matrix size. This is currently unused.
-o n
Target offset in pixels. Used by the 4-point method only.
-O
Set the touch matrix's origin to the lower right corner. Used by the 3-point method only.
-s n
The number of repeat samples before accepting a touch input. The default is 10.
-t n
Set the new bullseye target size, in pixels. The default is 47; suggested values are between 30 and 100.
-v
Be verbose.

Description:

The gf-calib utility is used to calibrate a touchscreen on a GF-embedded device. Once the touchscreen is successfully configured it must be calibrated. The calib utility saves a configuration file at /etc/system/config/calib.$(hostname). You can use the -f option to specify a different configuration file. For information about this file format, see the “Calibration file format” section of the “Writing an Input Device Driver” chapter of the Input DDK documentation.

To invoke the calibration screen:

  1. Start io-display with the appropriate graphics driver.
  2. Start devi-* with the appropriate command-line options for the touchscreen device.
  3. Run gf-calib.
  4. Follow the on-screen instructions to complete the calibration.

See also:

calib