summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2017-01-24 21:26:10 -0500
committerDavid Thompson <dthompson2@worcester.edu>2017-01-24 21:26:10 -0500
commit534677086a1336c727261504ba75a7e169305532 (patch)
treeaf2cc81a6232a4dcbf764ea1ef4ccc61f83a63bb
parente46df21886b186cfcf28008eac4b9cb6577b4689 (diff)
Add audio support.
* chickadee/audio.scm: New file. * Makefile.am (SOURCES): Add it. * chickadee.scm (run-game): Initialize audio. * doc/api.texi ("Audio"): Document it.
-rw-r--r--Makefile.am1
-rw-r--r--chickadee.scm1
-rw-r--r--chickadee/audio.scm144
-rw-r--r--doc/api.texi61
4 files changed, 206 insertions, 1 deletions
diff --git a/Makefile.am b/Makefile.am
index 8e65d44..2e320c5 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -41,6 +41,7 @@ godir=$(libdir)/guile/$(GUILE_EFFECTIVE_VERSION)/ccache
SOURCES = \
chickadee/config.scm \
chickadee/utils.scm \
+ chickadee/audio.scm \
chickadee/input/controller.scm \
chickadee/math.scm \
chickadee/math/vector.scm \
diff --git a/chickadee.scm b/chickadee.scm
index fdf253e..c872f85 100644
--- a/chickadee.scm
+++ b/chickadee.scm
@@ -79,6 +79,7 @@
window-fullscreen?
(update-hz 60))
(sdl-init)
+ ((@@ (chickadee audio) enable-audio))
(start-text-input)
(let ((window (open-window #:title window-title
#:width window-width
diff --git a/chickadee/audio.scm b/chickadee/audio.scm
new file mode 100644
index 0000000..d92ae94
--- /dev/null
+++ b/chickadee/audio.scm
@@ -0,0 +1,144 @@
+;;; Chickadee Game Toolkit
+;;; Copyright © 2017 David Thompson <davet@gnu.org>
+;;;
+;;; Chickadee is free software: you can redistribute it and/or modify
+;;; it under the terms of the GNU General Public License as published
+;;; by the Free Software Foundation, either version 3 of the License,
+;;; or (at your option) any later version.
+;;;
+;;; Chickadee is distributed in the hope that it will be useful, but
+;;; WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+;;; General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU General Public License
+;;; along with this program. If not, see
+;;; <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;
+;; Sound effects and music.
+;;
+;;; Code:
+
+(define-module (chickadee audio)
+ #:use-module (ice-9 format)
+ #:use-module (srfi srfi-9)
+ #:use-module (srfi srfi-9 gnu)
+ #:use-module ((sdl2 mixer) #:prefix sdl2:)
+ #:export (load-sample
+ sample?
+ sample-audio
+ set-sample-volume!
+ play-sample
+ load-music
+ music?
+ music-audio
+ music-volume
+ play-music
+ set-music-volume!
+ pause-music
+ resume-music
+ rewind-music
+ stop-music
+ music-paused?
+ music-playing?))
+
+(define (enable-audio)
+ ;; The SDL mixer will throw an exception if it cannot initialize a
+ ;; particular audio format. We don't want this to be fatal, so we
+ ;; ignore it.
+ (false-if-exception (sdl2:mixer-init))
+ (sdl2:open-audio))
+
+;; Used to wrap SDL audio functions whose return values should be
+;; ignored.
+(define-syntax-rule (ignore-value body ...)
+ (begin
+ body ...
+ *unspecified*))
+
+;; Wrapper over SDL audio objects.
+(define-record-type <sample>
+ (make-sample audio)
+ sample?
+ (audio sample-audio))
+
+(define (display-sample sample port)
+ (format port "#<sample ~x>" (object-address sample)))
+
+(set-record-type-printer! <sample> display-sample)
+
+(define (load-sample file)
+ "Load audio sample from FILE."
+ (let ((audio (sdl2:load-chunk file)))
+ (if audio
+ (make-sample audio)
+ (error "cannot load audio sample:" file))))
+
+(define (set-sample-volume! volume)
+ "Set the volume that all samples are played at to VOLUME, an integer
+value between 0 and 128."
+ (ignore-value (sdl2:set-channel-volume! #f volume)))
+
+(define (play-sample sample)
+ "Play SAMPLE."
+ (ignore-value
+ ;; An exception will be thrown if too many samples are being played
+ ;; at once, but it can be safely ignored.
+ (false-if-exception
+ (sdl2:play-chunk! (sample-audio sample)))))
+
+;; Wrapper over SDL music objects.
+(define-record-type <music>
+ (make-music audio)
+ music?
+ (audio music-audio))
+
+(define (display-music music port)
+ (format port "#<music ~x>" (object-address music)))
+
+(set-record-type-printer! <music> display-music)
+
+(define (load-music file)
+ "Load music from FILE."
+ (make-music (sdl2:load-music file)))
+
+(define (music-volume)
+ "Return the volume level for music, an integer value between 0 and
+128."
+ (sdl2:music-volume))
+
+(define (set-music-volume! volume)
+ "Set the volume that music is played at to VOLUME, an integer value
+between 0 and 128."
+ (ignore-value (sdl2:set-music-volume! volume)))
+
+(define* (play-music music #:key loop?)
+ "Play MUSIC. If LOOP?, play it over and over and over and over
+and..."
+ (sdl2:play-music! (music-audio music) (if loop? #f 1)))
+
+(define (pause-music)
+ "Pause the current music track."
+ (sdl2:pause-music!))
+
+(define (resume-music)
+ "Resume the current music track."
+ (sdl2:resume-music!))
+
+(define (rewind-music)
+ "Restart the current music track from the beginning."
+ (sdl2:rewind-music!))
+
+(define (stop-music)
+ "Stop playing the current music track."
+ (sdl2:stop-music!))
+
+(define (music-playing?)
+ "Return #t if music is currently playing."
+ (sdl2:music-playing?))
+
+(define (music-paused?)
+ "Return #t if music is currently paused."
+ (sdl2:music-paused?))
diff --git a/doc/api.texi b/doc/api.texi
index 554b531..d72980a 100644
--- a/doc/api.texi
+++ b/doc/api.texi
@@ -732,4 +732,63 @@ considered an advanced feature.
@node Audio
@section Audio
-There is no audio support yet. Stay tuned!
+Chickadee has two data types for audio: samples and music. Samples
+are for short sound effects like explosions. Music is for, well,
+uh@dots{}, music.
+
+Supported file formats include WAV and OGG.
+
+@deffn {Scheme Procedure} load-sample @var{file}
+Load audio sample from @var{file}.
+@end deffn
+
+@deffn {Scheme Procedure} set-sample-volume! @var{volume}
+Set the volume that all samples are played at to @var{volume}, an
+integer value between 0 and 128.
+@end deffn
+
+@deffn {Scheme Procedure} play-sample @var{sample}
+Play @var{sample}. Pretty straightforward!
+@end deffn
+
+@deffn {Scheme Procedure} load-music @var{file}
+Load music from @var{file}.
+@end deffn
+
+@deffn {Scheme Procedure} music-volume
+Return the volume level for music, an integer value between 0 and 128.
+@end deffn
+
+@deffn {Scheme Procedure} set-music-volume! @var{volume}
+Set the volume that music is played at to @var{volume}, an integer
+value between 0 and 128.
+@end deffn
+
+@deffn {Scheme Procedure} play-music @var{music} [@var{loop?}]
+Play @var{music}. If @var{loop?}, play it over and over and over and
+over and@dots{}
+@end deffn
+
+@deffn {Scheme Procedure} pause-music
+Pause the current music track.
+@end deffn
+
+@deffn {Scheme Procedure} resume-music
+Resume the current music track.
+@end deffn
+
+@deffn {Scheme Procedure} rewind-music
+estart the current music track from the beginning.
+@end deffn
+
+@deffn {Scheme Procedure} stop-music
+Stop playing the current music track.
+@end deffn
+
+@deffn {Scheme Procedure} music-playing?
+Return @code{#t} if music is currently playing.
+@end deffn
+
+@deffn {Scheme Procedure} music-paused?
+Return @code{#t} if music is currently paused.
+@end deffn