ebeam_calibrator(1)

NAME
ebeam_calibrator - ebeam calibration program for X.Org

SYNOPSIS
ebeam_calibrator [OPTIONS]

DESCRIPTION
ebeam_calibrator is a program for calibrating your ebeam device, when using the native ebeam kernel module and X Window System.

It currently features:
- works for any ebeam kernel driver supported devices
- mis-click detection (prevents bogus calibration)
- active zone definition
- dynamically recalibrates the kernel driver and the X evdev driver

see http://ebeam.tuxfamily.org

OPTIONS

-h, --help
    Print a help message listing the version and available options.

-v, --verbose
    Print debug messages during the process.

--list
    List the ebeam input devices.

--device device_name_or_id
    Select a specific ebeam device to calibrate; use --list to list the ebeam input devices.

--zone min_x min_y max_x max_y
    Define the active zone (default: full screen).

--precision nr of digit
    How many digits are kept for screen coordinates computation (default: 12).

--threshold nr
    Set the misclick threshold (0=off, default: 16)

USAGE
Run ebeam_calibrator and click the 4 calibration points.
ebeam_calibrator will tell you if the calibration process went well and after a final click, will update the kernel driver and X evdev driver's calibration data. Your ebeam device is ready to use.

EXAMPLES
To run the calibrator, type in your terminal:

    ebeam_calibrator

To run the calibrator for device 11, only active on the right half of a 1280x1024 screen, type in your terminal:

    ebeam_calibrator --device 11 --zone 640 0 1279 1023
      Reminder : pixel coordinates starts at (0;0) top-left.

If something goes wrong, or not as expected, turn on verbose messages:

    ebeam_calibrator -v

TROUBLESHOOTING
In general, Run the calibrator with the -v option, it will tell you what happens and what goes wrong. Mis-click detection: The calibrator can automatically detect double clicks on the same point. This prevents you from ending up with a bogus calibration.
If one click validate 2 or more points in a row (ie the calibrator miss the double click), try to increase the threshold value. Precision: Screen coordinates computation involve high-precision maths. The number of digits used don't impact computation time. More digits increase accuracy but can lead to overflow.

    - If your screen pointer significantly shift from your ebeam position, especially on the border of the screen, the driver lack accuracy. You have to increase the precision's value.

    - If your screen pointer jump around, the driver certainly overflow. You have to decrease the precision's value.

Don't go below 9 or above 14, unless you want to see a brain-dead pointer.

SEE ALSO
ebeam_state(1)

AUTHORS
Yann Cantin <yann.cantin@laposte.net>