aboutsummaryrefslogtreecommitdiffstats
path: root/man3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2023-04-10 14:31:49 +0200
committerMattias Andrée <maandree@kth.se>2023-04-10 14:32:35 +0200
commitf679f5b7a264150399cef925fb2d5d0e5f6384c0 (patch)
tree8a901fe4b0961e5d55c451829fd5a2a53e2b1aca /man3
parentAdd man page: LIBAXL_REQUEST_SET_ACCESS_CONTROL.3 (diff)
downloadlibaxl-f679f5b7a264150399cef925fb2d5d0e5f6384c0.tar.gz
libaxl-f679f5b7a264150399cef925fb2d5d0e5f6384c0.tar.bz2
libaxl-f679f5b7a264150399cef925fb2d5d0e5f6384c0.tar.xz
Add man page: LIBAXL_REQUEST_BELL.3
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to '')
-rw-r--r--man3/LIBAXL_REQUEST_BELL.353
1 files changed, 53 insertions, 0 deletions
diff --git a/man3/LIBAXL_REQUEST_BELL.3 b/man3/LIBAXL_REQUEST_BELL.3
new file mode 100644
index 0000000..f3c974c
--- /dev/null
+++ b/man3/LIBAXL_REQUEST_BELL.3
@@ -0,0 +1,53 @@
+.TH LIBAXL_REQUEST_BELL 3 libaxl
+.SH NAME
+LIBAXL_REQUEST_BELL - Ring the keyboard bell
+.SH SYNOPSIS
+.nf
+#include <libaxl.h>
+
+#define LIBAXL_REQUEST_BELL 49
+struct libaxl_request_bell {
+ uint8_t \fIopcode\fP;
+ uint8_t \fIpercent\fP;
+ uint16_t \fI_request_length\fP;
+};
+.fi
+.SH DESCRIPTION
+The display server shall ring the bell
+on the keyboard, at a volume relative to
+the base volume for the keyboard, if possible.
+.PP
+The value of the
+.I percent
+field shall be set to a value within [-100, 100],
+where -100 maps to a volume of 0, 0 maps to the
+base volume, and 100 maps to 100%. Other values
+are interpreted via piece-wise linear interpolation.
+.PP
+Other fields are filled in automatically by the
+.BR libaxl_send_request (3)
+function.
+.SH EXTENDED DESCRIPTION
+The volume at which the bell is rung is
+.I (base - (base * percent) / 100 + percent)
+when
+.I percent
+is nonnegative and
+.I (base + (base * percent) / 100)
+when
+.I percent
+is negative;
+where
+.I base
+is the base volume for the keyboard.
+.SH ERRORS
+.TP
+.B LIBAXL_ERROR_VALUE (3)
+.I percent
+is less than -100 or greater than 100.
+.SH REPLIES
+None.
+.SH SEE ALSO
+.BR libaxl_send_request (3),
+.BR LIBAXL_REQUEST_CHANGE_KEYBOARD_CONTROL (3),
+.BR LIBAXL_REQUEST_GET_KEYBOARD_CONTROL (3)