OpenBSD manual page server

NAME

xtsscale — X touch screen calibration tool

SYNOPSIS

DESCRIPTION

xtsscale is used interactively to calculate both the scaling and offset values which will make the pointer act at the indicated location on the screen.

The following options can be used:

-c

keep the X cursor visible during calibration. Useful for indirect absolute devices like tablets.

-D display

specify the X11 display to use.

-d device

defines the name or numerical identifier of the X Input extension device to calibrate. Use

$ xinput --list

to figure out the actual name for the X configuration. device can be omitted if there is only one X extension pointer with calibration properties in the system.

-o output

specifies the XRandR output to with the touch screen is connected. If omitted xtsscale will use all heads in multi-head configurations, which is probably not what is expected. Use

$ xrandr

to figure out the names of the outputs.

-v

specifies that xtsscale will be verbose, outputting various information, including the raw coordinate values produced, mostly for debugging purposes.

When good deviations are calculated from the selections made at these points, xtsscale will exit and provide on standard output a result like the following:

This result should be placed into /etc/wsconsctl.conf for further use. The new calibration is automatically used by the X server. The calibration process can be interrupted at any time using the ESC key. In this case the current screen calibration data will not be modified.

NOTES

To use xtsscale the mode of the input device should be set to raw in the /etc/X11/xorg.conf X configuration file. See ws(4) for details.

/etc/wsconsctl.conf cannot currently be used to set the calibration data of a device that is not the first device (/dev/wsmouse0).

SEE ALSO

xinput(1), xrandr(1), ums(4), uts(4), wscons(4), ws(4), wsconsctl(8), X(7)

HISTORY

The xtsscale command appeared in OpenBSD 4.2.