2007-08-31 16:02:51 -06:00
|
|
|
.\" $OpenBSD: xtsscale.1,v 1.4 2007/08/31 22:02:51 matthieu Exp $
|
2007-05-20 08:43:12 -06:00
|
|
|
.\"
|
|
|
|
|
.\" Copyright (c) 2007 Robert Nagy <robert@openbsd.org>
|
|
|
|
|
.\"
|
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
|
.\" are met:
|
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE OPENBSD PROJECT AND CONTRIBUTORS
|
|
|
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
|
.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
|
|
|
.\" A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OPENBSD
|
|
|
|
|
.\" PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
|
.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
|
.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
|
.\" OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
.\"
|
|
|
|
|
.Dd May 17, 2007
|
|
|
|
|
.Dt XTSSCALE 1
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm xtsscale
|
|
|
|
|
.Nd X touch screen calibration tool
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm xtsscale
|
|
|
|
|
.Bk -words
|
|
|
|
|
.Op Ar device
|
|
|
|
|
.Ek
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
|
|
|
|
is used interactively to calculate both the scaling and offset values which
|
|
|
|
|
will make the pointer act at the indicated location on the screen.
|
|
|
|
|
.Pp
|
|
|
|
|
When good deviations are calculated from the selections made at these
|
|
|
|
|
points,
|
|
|
|
|
.Nm
|
|
|
|
|
will exit and provide on standard output a result like the following:
|
|
|
|
|
.Pp
|
2007-08-31 15:14:04 -06:00
|
|
|
.Dl mouse.scale=200,3400,312,3672,0,1024,768
|
2007-05-20 08:43:12 -06:00
|
|
|
.Pp
|
2007-05-22 03:43:22 -06:00
|
|
|
This result should be placed into
|
|
|
|
|
.Pa /etc/wsconsctl.conf
|
|
|
|
|
for further use, or can be immediately applied using:
|
|
|
|
|
.Pp
|
2007-08-31 15:14:04 -06:00
|
|
|
.Dl # wsconsctl mouse.scale=200,3400,312,3672,0,1024,768
|
2007-08-31 16:02:51 -06:00
|
|
|
.Sh NOTES
|
|
|
|
|
To use
|
|
|
|
|
.Nm
|
|
|
|
|
a special
|
|
|
|
|
.Pa /etc/X11/xorg.conf
|
|
|
|
|
X configuration file is needed, in which the input device driver is
|
|
|
|
|
replaced by the
|
|
|
|
|
.Xr void 4
|
|
|
|
|
driver so that the device to calibrate is not opened by X during the
|
|
|
|
|
calibration.
|
|
|
|
|
.Pp
|
|
|
|
|
.Pa /etc/wsconsctl.conf
|
|
|
|
|
cannot currently be used to set the calibration data of a device
|
|
|
|
|
that is not the first device. (
|
|
|
|
|
.Pa /dev/wsmouse0
|
|
|
|
|
)
|
2007-05-20 08:43:12 -06:00
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr ioctl 2 ,
|
|
|
|
|
.Xr uts 4 ,
|
|
|
|
|
.Xr wscons 4 ,
|
|
|
|
|
.Xr wsconsctl 8 ,
|
|
|
|
|
.Xr X 7
|
|
|
|
|
.Sh HISTORY
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
command appeared in
|
|
|
|
|
.Ox 4.2 .
|
