1XDEVICEBELL(3)                                                  XDEVICEBELL(3)
2
3
4

NAME

6       XDeviceBell - ring a bell on a device supported through the input
7       extension
8

SYNOPSIS

10       #include <X11/extensions/XInput.h>
11
12       Status XDeviceBell( Display *display,
13                           XDevice *device,
14                           XID feedbackclass,
15                           XID feedbackid,
16                           int percent);
17       display
18              Specifies the connection to the X server.
19
20       device
21              Specifies the device with which the bell is associated.
22
23       feedbackclass
24              Specifies the class of the feedback with which the bell
25              is associated.
26
27       feedbackid
28              Specifies the id of the feedback with which the bell is
29              associated.
30
31       percent
32              Specifies the volume in the range -100 to 100 at which
33              the bell should be rung.
34

DESCRIPTION

36           The XDeviceBell request causes the server to ring a bell on the
37           specified feedback of the specified device, if possible. The
38           specified volume is relative to the base volume for the bell.
39           If an invalid device is specified, a BadDevice error will be
40           returned. The feedbackclass and feedbackid parameters contain
41           values returned by an XGetFeedbackControl request and uniquely
42           identify the bell to ring. If a feedbackclass is specified that
43           does not support a bell, or if a nonexistent feedbackid is
44           specified, or a percent value is specified that is not in the
45           range -100 to 100, a BadValue error will be returned.
46
47           The volume at which the bell is rung when the percent argument
48           is nonnegative is: base - [(base * percent) / 100] + percent
49
50           The volume at which the bell rings when the percent argument is
51           negative is: base + [(base * percent) / 100]
52
53           To change the base volume of the bell, use
54           XChangeFeedbackControl.
55
56           XDeviceBell can generate a BadDevice or a BadValue error.
57

DIAGNOSTICS

59           BadDevice
60                  An invalid device was specified. The specified device
61                  does not exist, or has not been opened by this client
62                  via XOpenInputDevice.
63
64           BadValue
65                  An invalid feedbackclass, feedbackid, or percent value
66                  was specified.
67

SEE ALSO

69           XChangeFeedbackControl(3), XBell(3)
70
71
72
73                                  05/04/2023                    XDEVICEBELL(3)
Impressum