AudioCue is a Java class for audio
playback from memory, modeled on the javax.sound.sampled.Clip class, but with
concurrent playback and built-in real-time controls for volume, pan and speed.
This library provides a collection of programs which demonstrate many of AudioCue's
capabilities. This project's pom.xml shows how to link the AudioCue library
using Maven. More info on how to obtain and configure AudioCue can be found in
the README for the AudioCue project.
There are four sections. Each contains a program (or two) with its own main().
SimplePlayback : This example shows the playing of a cue in a fire-and-forget
manner. The play command is triggered from a JButton. The sound is configured
to allow up to 6 concurrent plays.
RealTimeslidersCue : This example has two controls that make use of the same
audio asset: a bell pitched at A3 (220 Hz). The upper control is a JLabel that
plays the sound in response to a MouseDown event. Each play grabs an available
instance and assigns it a random volume, pan and speed. The lower control is a
JButton. This control makes use of a single, reserved instance that has been
obtained from the AudioCue. Below are three sliders that affect playback in
real time: one for volume, one for pan, one for speed.
AudioCueListenerDemo : In this example a button plays the sound of a crow cawing
a random number of times (from 1 to 4). The graphic used for the face of the button
displays one of two images of a crow. When the AudioCue is started, the image is
changed from a quiet crow to one that is cawing. When the AudioCue finishes looping,
the image reverts to the quiet crow. A JFrame implements AudioCueListener and
is registered as a Listener via AudioCue's addAudioCueListener method.
PCMDemo : In this example, two AudioCues are loaded directly with PCM data. The
first is given filtered pink noise that is read from a wav file created using
Audacity. The data is then given a simple Attack-Release
envelope. With the second AudioCue, a sawtooth wave is constructed from sine
waves. The PCM values for 32 harmonics are calculated using a sine function and summed
together.
SoundscapeBattlefield : This example shows how a single cue can be used multiple
ways to create a sonic landscape. The source of the AudioCue is a wav file of a
single gunshot. This shot, when played at low speeds, sounds much like a bomb explosion.
The cue has a long, reverberant tail. In the demo, a copy of the PCM of the gunshot is
obtained and edited into a much shorter, loopable cue. This is then loaded into a new
AudioCue that is used to create the sound of a machine gun. The example also shows
two possible ways in which one can associate an AudioCue with properties or methods
to create the illusion of an 'entity' with a location and behavioral tendencies. Also,
the demo includes a class which implements AudioMixerTrack and is used to play
a sound effect of a helicopter flyover. An AudioMixer merges three AudioMixerTracks:
one for the helicopter, one for the machine guns, and one that is used for both the bombs
and single-shot rifles.