Manual Page Result
0
Command: xtsscale | Section: 1 | Source: OpenBSD | File: xtsscale.1
XTSSCALE(1) FreeBSD General Commands Manual XTSSCALE(1)
NAME
xtsscale - X touch screen calibration tool
SYNOPSIS
xtsscale [-c] [-D display] [-d device] [-o output] [-v]
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:
mouse.scale=200,3400,312,3672,0,1024,768
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.
FreeBSD 14.1-RELEASE-p8 April 24, 2023 FreeBSD 14.1-RELEASE-p8