OpenBSD manual page server

Manual Page Search Parameters

XTSSCALE(1) General Commands Manual XTSSCALE(1)

xtsscaleX touch screen calibration tool

xtsscale [-c] [-D display] [-d device] [-o output] [-v]

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:

keep the X cursor visible during calibration. Useful for indirect absolute devices like tablets.
display
specify the X11 display to use.
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.

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.

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.

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).

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

The xtsscale command appeared in OpenBSD 4.2.

April 24, 2023 OpenBSD-current