summaryrefslogtreecommitdiff
path: root/manuals/guile-sdl2/Sound.html
diff options
context:
space:
mode:
Diffstat (limited to 'manuals/guile-sdl2/Sound.html')
-rw-r--r--manuals/guile-sdl2/Sound.html99
1 files changed, 45 insertions, 54 deletions
diff --git a/manuals/guile-sdl2/Sound.html b/manuals/guile-sdl2/Sound.html
index f98ceb7..6dab26a 100644
--- a/manuals/guile-sdl2/Sound.html
+++ b/manuals/guile-sdl2/Sound.html
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-<!-- Copyright (C) 2016 David Thompson davet@gnu.org
+<!-- Copyright (C) 2016, 2017, 2018, 2019 David Thompson davet@gnu.org
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
@@ -13,10 +13,12 @@ A copy of the license is also available from the Free Software
Foundation Web site at http://www.gnu.org/licenses/fdl.html.
+* Guile-SDL2: (guile-sdl2). SDL2 bindings for Guile.
+
The document was typeset with
http://www.texinfo.org/ (GNU Texinfo).
-->
-<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Sound (Guile-SDL2)</title>
@@ -26,33 +28,24 @@ http://www.texinfo.org/ (GNU Texinfo).
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
-<link href="index.html#Top" rel="start" title="Top">
-<link href="Index.html#Index" rel="index" title="Index">
+<link href="index.html" rel="start" title="Top">
+<link href="Index.html" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
-<link href="API-Reference.html#API-Reference" rel="up" title="API Reference">
-<link href="Fonts.html#Fonts" rel="next" title="Fonts">
-<link href="Images.html#Images" rel="prev" title="Images">
+<link href="API-Reference.html" rel="up" title="API Reference">
+<link href="Fonts.html" rel="next" title="Fonts">
+<link href="Images.html" rel="prev" title="Images">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
-blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
-blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
-div.smalldisplay {margin-left: 3.2em}
-div.smallexample {margin-left: 3.2em}
-div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
-pre.smalldisplay {font-family: inherit; font-size: smaller}
-pre.smallexample {font-size: smaller}
-pre.smallformat {font-family: inherit; font-size: smaller}
-pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
@@ -87,33 +80,31 @@ ul.no-bullet {list-style: none}
</head>
<body lang="en">
-<a name="Sound"></a>
-<div class="header">
+<span id="Sound"></span><div class="header">
<p>
-Next: <a href="Fonts.html#Fonts" accesskey="n" rel="next">Fonts</a>, Previous: <a href="Images.html#Images" accesskey="p" rel="prev">Images</a>, Up: <a href="API-Reference.html#API-Reference" accesskey="u" rel="up">API Reference</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="Fonts.html" accesskey="n" rel="next">Fonts</a>, Previous: <a href="Images.html" accesskey="p" rel="prev">Images</a>, Up: <a href="API-Reference.html" accesskey="u" rel="up">API Reference</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
-<a name="Sound-1"></a>
-<h3 class="section">3.9 Sound</h3>
+<span id="Sound-1"></span><h3 class="section">3.10 Sound</h3>
<div class="example">
<pre class="example">(use-modules (sdl2 mixer))
</pre></div>
<dl>
-<dt><a name="index-_0025default_002dfrequency"></a>Scheme Variable: <strong>%default-frequency</strong></dt>
+<dt id="index-_0025default_002dfrequency">Scheme Variable: <strong>%default-frequency</strong></dt>
</dl>
<dl>
-<dt><a name="index-_0025default_002dformat"></a>Scheme Variable: <strong>%default-format</strong></dt>
+<dt id="index-_0025default_002dformat">Scheme Variable: <strong>%default-format</strong></dt>
</dl>
<dl>
-<dt><a name="index-_0025default_002dchunk_002dsize"></a>Scheme Variable: <strong>%default-chunk-size</strong></dt>
+<dt id="index-_0025default_002dchunk_002dsize">Scheme Variable: <strong>%default-chunk-size</strong></dt>
</dl>
<dl>
-<dt><a name="index-mixer_002dinit"></a>Procedure: <strong>mixer-init</strong> <em>[#:optional formats='(flac mod modplug mp3 ogg fluidsynth)]</em></dt>
+<dt id="index-mixer_002dinit">Procedure: <strong>mixer-init</strong> <em>[#:optional formats='(flac mod modplug mp3 ogg fluidsynth)]</em></dt>
<dd><p>Initialize mixer library with support for <var>formats</var>, a list of
symbols representing audio file formats. Possible formats are:
</p>
@@ -128,12 +119,12 @@ symbols representing audio file formats. Possible formats are:
</dd></dl>
<dl>
-<dt><a name="index-mixer_002dquit"></a>Procedure: <strong>mixer-quit</strong></dt>
+<dt id="index-mixer_002dquit">Procedure: <strong>mixer-quit</strong></dt>
<dd><p>Shutdown mixer library.
</p></dd></dl>
<dl>
-<dt><a name="index-open_002daudio"></a>Procedure: <strong>open-audio</strong> <em>[#:frequency=%default-frequency] [#:format=%default-format] [#:stereo?=#t] [#:chunk-size=%default-chunk-size]</em></dt>
+<dt id="index-open_002daudio">Procedure: <strong>open-audio</strong> <em>[#:frequency=%default-frequency] [#:format=%default-format] [#:stereo?=#t] [#:chunk-size=%default-chunk-size]</em></dt>
<dd><p>Initialize the mixer API. <var>frequency</var> specificies the sample rate in
hertz. When <var>stereo?</var> is <code>#t</code>, two output channels are used, otherwise
mono output is used instead. <var>chunk-size</var> specifies the number of bytes
@@ -159,40 +150,40 @@ sample format. Possible values are:
</dd></dl>
<dl>
-<dt><a name="index-close_002daudio"></a>Procedure: <strong>close-audio</strong></dt>
+<dt id="index-close_002daudio">Procedure: <strong>close-audio</strong></dt>
<dd><p>Shut down the mixer API.
</p></dd></dl>
<dl>
-<dt><a name="index-chunk_003f"></a>Procedure: <strong>chunk?</strong> <em>c</em></dt>
+<dt id="index-chunk_003f">Procedure: <strong>chunk?</strong> <em>c</em></dt>
<dd><p>Return <code>#t</code> if <var>c</var> is a chunk.
</p></dd></dl>
<dl>
-<dt><a name="index-load_002dchunk"></a>Procedure: <strong>load-chunk</strong> <em>file</em></dt>
+<dt id="index-load_002dchunk">Procedure: <strong>load-chunk</strong> <em>file</em></dt>
<dd><p>Load the audio data in <var>file</var> and return an audio chunk.
</p></dd></dl>
<dl>
-<dt><a name="index-delete_002dchunk_0021"></a>Procedure: <strong>delete-chunk!</strong> <em>chunk</em></dt>
+<dt id="index-delete_002dchunk_0021">Procedure: <strong>delete-chunk!</strong> <em>chunk</em></dt>
<dd><p>Free the memory used for <var>chunk</var>.
</p></dd></dl>
<dl>
-<dt><a name="index-set_002dchunk_002dvolume_0021"></a>Procedure: <strong>set-chunk-volume!</strong> <em>chunk volume</em></dt>
+<dt id="index-set_002dchunk_002dvolume_0021">Procedure: <strong>set-chunk-volume!</strong> <em>chunk volume</em></dt>
<dd><p>Set the loudness of <var>chunk</var> to <var>volume</var>, an integer in the range
[0,128]. Return the previous chunk volume setting.
</p></dd></dl>
<dl>
-<dt><a name="index-play_002dchunk_0021"></a>Procedure: <strong>play-chunk!</strong> <em>chunk [#:loops=0] [#:channel]</em></dt>
+<dt id="index-play_002dchunk_0021">Procedure: <strong>play-chunk!</strong> <em>chunk [#:loops=0] [#:channel]</em></dt>
<dd><p>Play <var>chunk</var> on <var>channel</var>, an integer channel identifier or <code>#f</code>
to use the first unreserved audio channel. <var>chunk</var> will play <var>loops</var> +
1 times. Return the channel identifier that <var>chunk</var> is played on.
</p></dd></dl>
<dl>
-<dt><a name="index-set_002dchannel_002dvolume_0021"></a>Procedure: <strong>set-channel-volume!</strong> <em>channel volume</em></dt>
+<dt id="index-set_002dchannel_002dvolume_0021">Procedure: <strong>set-channel-volume!</strong> <em>channel volume</em></dt>
<dd><p>Set the loudness of <var>channel</var>, an integer channel identifier or <code>#f</code>
for all channels, to <var>volume</var>, an integer in the range [0,128]. Return
the previous volume of <var>channel</var>, or the average of all channels if
@@ -200,110 +191,110 @@ the previous volume of <var>channel</var>, or the average of all channels if
</p></dd></dl>
<dl>
-<dt><a name="index-pause_002dchannel_0021"></a>Procedure: <strong>pause-channel!</strong> <em>channel</em></dt>
+<dt id="index-pause_002dchannel_0021">Procedure: <strong>pause-channel!</strong> <em>channel</em></dt>
<dd><p>Pause playback on <var>channel</var>, an integer channel identifier, or <code>#f</code> to
pause all channels.
</p></dd></dl>
<dl>
-<dt><a name="index-resume_002dchannel_0021"></a>Procedure: <strong>resume-channel!</strong> <em>channel</em></dt>
+<dt id="index-resume_002dchannel_0021">Procedure: <strong>resume-channel!</strong> <em>channel</em></dt>
<dd><p>Resume playback on <var>channel</var>, an integer channel identifier, or <code>#f</code> to
resume all channels.
</p></dd></dl>
<dl>
-<dt><a name="index-stop_002dchannel_0021"></a>Procedure: <strong>stop-channel!</strong> <em>channel</em></dt>
+<dt id="index-stop_002dchannel_0021">Procedure: <strong>stop-channel!</strong> <em>channel</em></dt>
<dd><p>Halt playback on <var>channel</var>, an integer channel identifier, or <code>#f</code> to
halt all channels.
</p></dd></dl>
<dl>
-<dt><a name="index-channel_002dplaying_003f"></a>Procedure: <strong>channel-playing?</strong> <em>channel</em></dt>
+<dt id="index-channel_002dplaying_003f">Procedure: <strong>channel-playing?</strong> <em>channel</em></dt>
<dd><p>Return <code>#t</code> if <var>channel</var> is playing.
</p></dd></dl>
<dl>
-<dt><a name="index-playing_002dchannels_002dcount"></a>Procedure: <strong>playing-channels-count</strong></dt>
+<dt id="index-playing_002dchannels_002dcount">Procedure: <strong>playing-channels-count</strong></dt>
<dd><p>Return the number of channels currently playing.
</p></dd></dl>
<dl>
-<dt><a name="index-channel_002dpaused_003f"></a>Procedure: <strong>channel-paused?</strong> <em>channel</em></dt>
+<dt id="index-channel_002dpaused_003f">Procedure: <strong>channel-paused?</strong> <em>channel</em></dt>
<dd><p>Return <code>#t</code> if <var>channel</var> is paused.
</p></dd></dl>
<dl>
-<dt><a name="index-paused_002dchannels_002dcount"></a>Procedure: <strong>paused-channels-count</strong></dt>
+<dt id="index-paused_002dchannels_002dcount">Procedure: <strong>paused-channels-count</strong></dt>
<dd><p>Return the number of channels that are paused.
</p></dd></dl>
<dl>
-<dt><a name="index-music_003f"></a>Procedure: <strong>music?</strong> <em>m</em></dt>
+<dt id="index-music_003f">Procedure: <strong>music?</strong> <em>m</em></dt>
<dd><p>Return <code>#t</code> if <var>m</var> is music.
</p></dd></dl>
<dl>
-<dt><a name="index-load_002dmusic"></a>Procedure: <strong>load-music</strong> <em>file</em></dt>
+<dt id="index-load_002dmusic">Procedure: <strong>load-music</strong> <em>file</em></dt>
<dd><p>Load music from <var>file</var>.
</p></dd></dl>
<dl>
-<dt><a name="index-delete_002dmusic_0021"></a>Procedure: <strong>delete-music!</strong> <em>music</em></dt>
+<dt id="index-delete_002dmusic_0021">Procedure: <strong>delete-music!</strong> <em>music</em></dt>
<dd><p>Delete the memory used for <var>music</var>.
</p></dd></dl>
<dl>
-<dt><a name="index-play_002dmusic_0021"></a>Procedure: <strong>play-music!</strong> <em>music [#:optional loops=1]</em></dt>
+<dt id="index-play_002dmusic_0021">Procedure: <strong>play-music!</strong> <em>music [#:optional loops=1]</em></dt>
<dd><p>Play <var>music</var>, repeated <var>loops</var> times. <var>loops</var> may be <code>#f</code>, in
which case the music loops indefinitely.
</p></dd></dl>
<dl>
-<dt><a name="index-set_002dmusic_002dvolume_0021"></a>Procedure: <strong>set-music-volume!</strong> <em>volume</em></dt>
+<dt id="index-set_002dmusic_002dvolume_0021">Procedure: <strong>set-music-volume!</strong> <em>volume</em></dt>
<dd><p>Set music loudness to <var>volume</var>, an integer in the range [0,128]. Return the
previous volume.
</p></dd></dl>
<dl>
-<dt><a name="index-music_002dvolume"></a>Procedure: <strong>music-volume</strong></dt>
+<dt id="index-music_002dvolume">Procedure: <strong>music-volume</strong></dt>
<dd><p>Return the music volume.
</p></dd></dl>
<dl>
-<dt><a name="index-pause_002dmusic_0021"></a>Procedure: <strong>pause-music!</strong></dt>
+<dt id="index-pause_002dmusic_0021">Procedure: <strong>pause-music!</strong></dt>
<dd><p>Puase the music.
</p></dd></dl>
<dl>
-<dt><a name="index-resume_002dmusic_0021"></a>Procedure: <strong>resume-music!</strong></dt>
+<dt id="index-resume_002dmusic_0021">Procedure: <strong>resume-music!</strong></dt>
<dd><p>Resume music playback.
</p></dd></dl>
<dl>
-<dt><a name="index-rewind_002dmusic_0021"></a>Procedure: <strong>rewind-music!</strong></dt>
+<dt id="index-rewind_002dmusic_0021">Procedure: <strong>rewind-music!</strong></dt>
<dd><p>Start music playback from the beginning. Rewinding is only supported for MOD,
OGG, MP3, and native MIDI music.
</p></dd></dl>
<dl>
-<dt><a name="index-stop_002dmusic_0021"></a>Procedure: <strong>stop-music!</strong></dt>
+<dt id="index-stop_002dmusic_0021">Procedure: <strong>stop-music!</strong></dt>
<dd><p>Halt music playback.
</p></dd></dl>
<dl>
-<dt><a name="index-music_002dplaying_003f"></a>Procedure: <strong>music-playing?</strong></dt>
+<dt id="index-music_002dplaying_003f">Procedure: <strong>music-playing?</strong></dt>
<dd><p>Return <code>#t</code> if music is currently playing.
</p></dd></dl>
<dl>
-<dt><a name="index-music_002dpaused_003f"></a>Procedure: <strong>music-paused?</strong></dt>
+<dt id="index-music_002dpaused_003f">Procedure: <strong>music-paused?</strong></dt>
<dd><p>Return <code>#t</code> if music is currently paused.
</p></dd></dl>
<hr>
<div class="header">
<p>
-Next: <a href="Fonts.html#Fonts" accesskey="n" rel="next">Fonts</a>, Previous: <a href="Images.html#Images" accesskey="p" rel="prev">Images</a>, Up: <a href="API-Reference.html#API-Reference" accesskey="u" rel="up">API Reference</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="Fonts.html" accesskey="n" rel="next">Fonts</a>, Previous: <a href="Images.html" accesskey="p" rel="prev">Images</a>, Up: <a href="API-Reference.html" accesskey="u" rel="up">API Reference</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p>
</div>
generated by cgit v1.2.3 (git 2.25.4) at 2024-07-03 09:59:50 +0000