quakespasm/Quake/snd_vorbis.c
sezero 2950b5cdf9 Backported external music files support using decoder libraries and the
new raw samples interface from Hammer of Thyrion (uhexen2) :
- bgmusic.c, bgmusic.h: New BGM interface for background music handling.
  Handles streaming music as raw sound samples.
- bgmnull.c: BGM source for cases where the engine is configured for no
  sound.
- cl_main.c: Include bgmusic.h. Call BGM_Stop() and CDAudio_Stop() in
  CL_Disconnect().
- cd_sdl.c: Moved bgmvolume boundary checking to bgmusic.c upon value
  changes.
- gl_vidnt.c, gl_vidsdl.c, cl_parse.c: Include bgmusic.h. Add BGM_Pause()
  and BGM_Resume() calls along with CDAudio_ counterparts.
- cl_parse.c: Replace CDAudio_Play() call by the new BGM_PlayCDtrack()
  which first tries CDAudio_Play() and then streaming music if it fails.
- host.c: Include bgmusic.h. Call BGM_Update() just before S_Update()
  in Host_Frame(). In Host_Init(), call BGM_Init() after other audio init
  calls. In Host_Shutdown(), call BGM_Shutdown() before all other audio
  shutdown calls.
- snd_dma.c: Include snd_codec.h and bgmusic.h. Call S_CodecInit() from
  S_Init(). Call S_CodecShutdown() from S_Shutdown().
- snd_codec.c, snd_codec.h: New public codec interface for streaming
  music as raw samples. Adapted from quake2 and ioquake3 with changes.
  Individual codecs are responsible for handling any necessary byte swap
  operations.
- snd_codeci.h: New header for snd_codec internals.
- snd_wave.c, snd_wave.h: Codec for WAV format streaming music. Adapted
  from ioquake3 with changes.
- snd_vorbis.c, snd_vorbis.h: Codec for Ogg/Vorbis format streaming music.
- snd_mp3.c, snd_mp3.h: Codec for MP3 format streaming music using libmad.
  Adapted from the SoX project with changes.
- Makefile: Adjusted for the new sources. Added switches USE_CODEC_WAVE,
  USE_CODEC_MP3, USE_CODEC_VORBIS for enabling and disabling individual
  codecs.
- Windows makefiles and project files as well as other CodeBlocks project
  files will be updated shortly.


git-svn-id: http://svn.code.sf.net/p/quakespasm/code/trunk/quakespasm@374 af15c1b1-3010-417e-b628-4374ebc0bcbd
2011-01-05 19:50:43 +00:00

169 lines
3.9 KiB
C

/*
* Ogg/Vorbis streaming music support, adapted from several open source
* Quake engine based projects with many modifications.
*
* This program 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 2 of the License, or (at
* your option) any later version.
*
* This program 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, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*
*/
#include "quakedef.h"
#if defined(USE_CODEC_VORBIS)
#include "snd_codec.h"
#include "snd_codeci.h"
#include "snd_vorbis.h"
#define OV_EXCLUDE_STATIC_CALLBACKS
#include <vorbis/vorbisfile.h>
/* The OGG codec can return the samples in a number of different
* formats, we use the standard signed short format. */
#define OGG_SAMPLEWIDTH 2
#define OGG_SIGNED_DATA 1
static int ogg_bigendian = 0;
/* CALLBACK FUNCTIONS: */
static int ovc_fclose (void *f)
{
return 0; /* we fclose() elsewhere. */
}
static int ovc_fseek (void *f, ogg_int64_t off, int whence)
{
if (f == NULL) return (-1);
return FS_fseek((fshandle_t *)f, (long) off, whence);
}
static const ov_callbacks ovc_qfs =
{
(size_t (*)(void *, size_t, size_t, void *)) FS_fread,
(int (*)(void *, ogg_int64_t, int)) ovc_fseek,
(int (*)(void *)) ovc_fclose,
(long (*)(void *)) FS_ftell
};
static qboolean S_OGG_CodecInitialize (void)
{
ogg_bigendian = (bigendien == true) ? 1 : 0;
ogg_codec.initialized = true;
return true;
}
static void S_OGG_CodecShutdown (void)
{
}
static snd_stream_t *S_OGG_CodecOpenStream (const char *filename)
{
snd_stream_t *stream;
OggVorbis_File *ovFile;
vorbis_info *ogg_info;
int res;
stream = S_CodecUtilOpen(filename, &ogg_codec);
if (!stream)
return NULL;
ovFile = (OggVorbis_File *) Z_Malloc(sizeof(OggVorbis_File));
res = ov_open_callbacks(&stream->fh, ovFile, NULL, 0, ovc_qfs);
if (res < 0)
{
Con_Printf("%s is not a valid Ogg Vorbis file (error %i).\n", filename, res);
Z_Free(ovFile);
S_CodecUtilClose(&stream);
return NULL;
}
stream->priv = ovFile;
if (!ov_seekable(ovFile))
{
Con_Printf("OGG_Open: stream %s not seekable.\n", filename);
ov_clear(ovFile);
Z_Free(ovFile);
S_CodecUtilClose(&stream);
return NULL;
}
ogg_info = ov_info(ovFile, 0);
if (!ogg_info)
{
Con_Printf("Unable to get stream information for %s.\n", filename);
ov_clear(ovFile);
Z_Free(ovFile);
S_CodecUtilClose(&stream);
return NULL;
}
stream->info.rate = ogg_info->rate;
stream->info.channels = ogg_info->channels;
stream->info.width = OGG_SAMPLEWIDTH;
return stream;
}
static int S_OGG_CodecReadStream (snd_stream_t *stream, int bytes, void *buffer)
{
int section; /* FIXME: handle section changes */
int cnt, res, rem;
char * ptr;
cnt = 0; rem = bytes;
ptr = (char *) buffer;
while (1)
{
res = ov_read((OggVorbis_File *) stream->priv, ptr, rem, ogg_bigendian,
OGG_SAMPLEWIDTH, OGG_SIGNED_DATA, &section);
if (res <= 0)
break;
rem -= res;
cnt += res;
if (rem <= 0)
break;
ptr += res;
}
return (res >= 0) ? cnt : res;
}
static void S_OGG_CodecCloseStream (snd_stream_t *stream)
{
ov_clear((OggVorbis_File *)stream->priv);
Z_Free(stream->priv);
S_CodecUtilClose(&stream);
}
static int S_OGG_CodecRewindStream (snd_stream_t *stream)
{
return ov_time_seek ((OggVorbis_File *)stream->priv, 0.0);
}
snd_codec_t ogg_codec =
{
CODECTYPE_OGG,
false,
".ogg",
S_OGG_CodecInitialize,
S_OGG_CodecShutdown,
S_OGG_CodecOpenStream,
S_OGG_CodecReadStream,
S_OGG_CodecRewindStream,
S_OGG_CodecCloseStream,
NULL
};
#endif /* USE_CODEC_VORBIS */