5
.\" Copyright ([\d,\s]*) by Hewlett-Packard Company, Ardent Computer,
7
.\" Permission to use, copy, modify, distribute, and sell this documentation
8
.\" for any purpose and without fee is hereby granted, provided that the above
9
.\" copyright notice and this permission notice appear in all copies.
10
.\" Ardent, and Hewlett-Packard make no representations about the
11
.\" suitability for any purpose of the information in this document. It is
12
.\" provided \`\`as is'' without express or implied warranty.
14
.\" $Xorg: XSetDVal.man,v 1.3 2000/08/17 19:41:57 cpqbld Exp $
15
.ds xL Programming with Xlib
16
.TH XSetDeviceValuators __LIB_MAN_SUFFIX__ __xorgversion__ "X FUNCTIONS"
2
.\" Title: xsetdevicevaluators
3
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
6
.\" Manual: [FIXME: manual]
7
.\" Source: [FIXME: source]
10
.TH "XSETDEVICEVALUATORS" "libmansuffix" "10/02/2009" "[FIXME: source]" "[FIXME: manual]"
11
.\" -----------------------------------------------------------------
12
.\" * set default formatting
13
.\" -----------------------------------------------------------------
14
.\" disable hyphenation
16
.\" disable justification (adjust text to left margin only)
18
.\" -----------------------------------------------------------------
19
.\" * MAIN CONTENT STARTS HERE *
20
.\" -----------------------------------------------------------------
18
22
XSetDeviceValuators \- initialize the valuators on an extension input device
20
XSetDeviceValuators\^(\^\fIdisplay\fP, \fIdevice\fP\^, \fIvaluators\fP\^, \fIfirst_valuator\fP\^, \fInum_valuators\fP\^)
22
Display *\fIdisplay\fP\^;
24
XDevice *\fIdevice\fP\^;
26
int *\fIvaluators\fP\^;
28
int \fIfirst_valuator\fP\^;
30
int \fInum_valuators\fP\^;
34
Specifies the connection to the X server.
37
Specifies the device whose valuators are to be initialized.
40
Specifies a pointer to an array of integer values to be used to initialize the
44
Specifies the first valuator to be set. Valuators are numbered beginning with
48
Specifies the number of valuators to be set.
51
\fIXSetDeviceValuators\fP
52
request sets the current values of the valuators of an input device.
53
The valuators in the range
54
first_valuator to (first_valuator + num_valuators)
55
are set to the specified values. Valuators are numbered beginning with 0.
56
Not all input devices support initialization of valuator values. If this
57
request is made to a device that does not support valuators initialization,
58
a \fIBadMatch\fP error will occur.
60
If the request succeeds, a status of Success is returned. If another
61
client has the device grabbed, a status of AlreadyGrabbed is returned.
63
\fIXSetDeviceValuators\fP
64
can generate a \fIBadLength\fP, \fIBadDevice\fP , \fIBadMatch\fP, or
69
An invalid device was specified. The specified device does not exist or has
70
not been opened by this client via \fIXOpenInputDevice\fP.
73
This error may occur if an \fIXSetDeviceValuators\fP request is made
74
specifying a device that has no valuators and reports no axes of motion,
75
or if such a request is made specifying a device that does not support
76
valuator initialization.
79
An invalid first_valuator or num_valuators values was specified.
26
#include <X11/extensions/XInput\&.h>
30
XSetDeviceValuators( Display *display,
39
Specifies the connection to the X server\&.
44
Specifies the device whose valuators are to be
50
Specifies a pointer to an array of integer values to be
51
used to initialize thedevice valuators\&.
56
Specifies the first valuator to be set\&. Valuators are
57
numbered beginning withzero\&.
62
Specifies the number of valuators to be set\&.
70
The XSetDeviceValuators request sets the current values of the
71
valuators of an input device\&. The valuators in the range
72
first_valuator to (first_valuator + num_valuators) are set to
73
the specified values\&. Valuators are numbered beginning with 0\&.
74
Not all input devices support initialization of valuator
75
values\&. If this request is made to a device that does not
76
support valuators initialization, a BadMatch error will occur\&.
86
If the request succeeds, a status of Success is returned\&. If
87
another client has the device grabbed, a status of
88
AlreadyGrabbed is returned\&.
98
XSetDeviceValuators can generate a BadLength, BadDevice,
99
BadMatch, or BadValue error\&.
111
An invalid device was specified\&. The specified device
112
does not exist or has not been opened by this client via
124
This error may occur if an XSetDeviceValuators request
125
is made specifying a device that has no valuators and
126
reports no axes of motion, or if such a request is made
127
specifying a device that does not support valuator
139
An invalid first_valuator or num_valuators values was