From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/elisp/sound-output.html | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 devdocs/elisp/sound-output.html (limited to 'devdocs/elisp/sound-output.html') diff --git a/devdocs/elisp/sound-output.html b/devdocs/elisp/sound-output.html new file mode 100644 index 00000000..df5ab403 --- /dev/null +++ b/devdocs/elisp/sound-output.html @@ -0,0 +1,17 @@ +

Sound Output

To play sound using Emacs, use the function play-sound. Only certain systems are supported; if you call play-sound on a system which cannot really do the job, it gives an error.

The sound must be stored as a file in RIFF-WAVE format (‘.wav’) or Sun Audio format (‘.au’).

Function: play-sound sound +
+

This function plays a specified sound. The argument, sound, has the form (sound properties...), where the properties consist of alternating keywords (particular symbols recognized specially) and values corresponding to them.

Here is a table of the keywords that are currently meaningful in sound, and their meanings:

:file file
+

This specifies the file containing the sound to play. If the file name is not absolute, it is expanded against the directory data-directory.

:data data
+

This specifies the sound to play without need to refer to a file. The value, data, should be a string containing the same bytes as a sound file. We recommend using a unibyte string.

:volume volume
+

This specifies how loud to play the sound. It should be a number in the range of 0 to 1. The default is to use whatever volume has been specified before.

:device device

This specifies the system device on which to play the sound, as a string. The default device is system-dependent.

Before actually playing the sound, play-sound calls the functions in the list play-sound-functions. Each function is called with one argument, sound.

+
+
Command: play-sound-file file &optional volume device +

This function is an alternative interface to playing a sound file specifying an optional volume and device.

+
Variable: play-sound-functions +

A list of functions to be called before playing a sound. Each function is called with one argument, a property list that describes the sound.

+
+

+ Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc.
Licensed under the GNU GPL license.
+ https://www.gnu.org/software/emacs/manual/html_node/elisp/Sound-Output.html +

+
-- cgit v1.2.3