diff options
author | David Thompson <dthompson2@worcester.edu> | 2021-04-13 11:30:50 -0400 |
---|---|---|
committer | David Thompson <dthompson2@worcester.edu> | 2021-04-13 11:30:50 -0400 |
commit | ce9d6e8ad28b2d84d1a292a871c23b66a4654b54 (patch) | |
tree | ade44e7bb7b891c9ae0ceba18633ef4b2a911a7c /manuals/guile-sdl2/Sound.html | |
parent | 2a30eb2a2d5472be3df1254d5d4d04310314e628 (diff) |
Add new guile-sdl2 and chickadee releases.
Diffstat (limited to 'manuals/guile-sdl2/Sound.html')
-rw-r--r-- | manuals/guile-sdl2/Sound.html | 99 |
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> [<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> [<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> [<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> [<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> |