engine/engine/client/snd_mp3.c

502 lines
12 KiB
C

//source file by david walton, derived from minimad.c
//modified slightly to use new library functions instead for single threaded asyncronous mp3 sound.
//in Quake!
//Be aware that MP3s are patented and thus not GPLable. This file is an interface to madlib which contains the decoder.
//This file is excluded from the main source tree because of this, and madlib is not distributed - in binary or source form.
//The GPL disallows distribution of patented software. You may reactive, but do not distribute binaries.
//Really madlib should come with the exception of the mp3 patent.
#include "quakedef.h"
#ifdef AVAIL_MP3
#include "winquake.h"
#undef channels
#ifdef _WIN32
#define inline _inline
#endif
//the problem with this is that we store the entire decoded file in memory.
//this takes a lot of mem.
//uses madlib
/*
* mad - MPEG audio decoder
* Copyright (C) 2000-2001 Robert Leslie
*
* 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
# include "libmad/mad.h"
#define USE_MADLIB
#include "mymad.c"
/*
* This is perhaps the simplest example use of the MAD high-level API.
* Standard input is mapped into memory via mmap(), then the high-level API
* is invoked with three callbacks: input, output, and error. The output
* callback converts MAD's high-resolution PCM samples to 16 bits, then
* writes them to standard output in little-endian, stereo-interleaved
* format.
*/
/*
* This is a private message structure. A generic pointer to this structure
* is passed to each of the callback functions. Put here any data you need
* to access from within the callbacks.
*/
typedef struct {
unsigned char *start;
unsigned long length;
qboolean failed;
sfxcache_t mp3sc;
char *mp3aswavdata;
int mp3aswavpos;
int mp3aswavbuflen;
struct mad_decoder decoder;
sfx_t *s;
} decoderbuffer_t;
int mymad_run(struct mad_decoder *decoder);
int mymad_reset(struct mad_decoder *decoder);
void mymad_finish(struct mad_decoder *decoder);
static int startdecode(unsigned char *start, unsigned long length, decoderbuffer_t *buffer);
#define BUFFERSIZEINC (2*1024*1024)
int DecodeSomeMP3(sfx_t *s, int minlength);
qbyte *COM_LoadFile (char *path, int usehunk);
int MP3_decode(unsigned char *start, unsigned long length, decoderbuffer_t *buffer);
void CancelDecoder(sfx_t *s);
sfxcache_t *S_LoadMP3Sound (sfx_t *s)
{
char namebuffer[MAX_OSPATH];
char *name;
decoderbuffer_t *buffer;
char *data;
qboolean telluser;
int len;
name = s->name;
if (name[0] == '#')
strcpy(namebuffer, &name[1]);
else
Q_snprintfz (namebuffer, sizeof(namebuffer), "sound/%s", name);
len = strlen(namebuffer);
telluser = strcmp(namebuffer+len-4, ".wav");
if (!telluser)
strcpy(namebuffer+len-4, ".mp3");
//try opening from a quake path
data = COM_LoadFile(namebuffer, 5);
if (!data)
{//if that didn't work, try opening direct from exe - this is media after all.
FILE *f;
if (!telluser)
return NULL; //never go out of the quake path for a wav replacement.
#ifndef _WIN32
char unixname[128];
if (name[1] == ':' && name[2] == '\\') //convert from windows to a suitable alternative.
{
snprintf(unixname, sizeof(unixname), "/mnt/%c/%s", name[0]-'A'+'a', name+3);
name = unixname;
while (*name)
{
if (*name == '\\')
*name = '/';
name++;
}
name = unixname;
}
#endif
if ((f = fopen(name, "rb")))
{
com_filesize = COM_filelength(f);
data = BZ_Malloc(com_filesize);
fread(data, 1, com_filesize, f);
fclose(f);
}
else
{
Con_SafePrintf ("Couldn't load %s\n", namebuffer);
return NULL;
}
}
if (s->decoder)
Sys_Error("Decoding already decoding file\n");
s->decoder = Z_Malloc(sizeof(decoderbuffer_t) + sizeof(sfxdecode_t));
buffer = (decoderbuffer_t*)(s->decoder+1);
buffer->mp3aswavpos=0;
buffer->mp3sc.length=0;
buffer->s = s;
s->decoder->buf = buffer;
s->decoder->decodemore = DecodeSomeMP3;
s->decoder->abort = CancelDecoder;
if (!startdecode(data, com_filesize, buffer))
{
if (buffer->mp3aswavdata)
{
BZ_Free(buffer->mp3aswavdata);
buffer->mp3aswavdata=NULL;
}
Con_SafePrintf ("Couldn't load %s - corrupt.\n", namebuffer);
return NULL;
}
s->decoder->decodemore(s, 100);
if (!s->decoder) //wow, short file. :/
return s->cache.data;
s->cache.fake=true;
return buffer->s->cache.data;
}
/*
* This is the input callback. The purpose of this callback is to (re)fill
* the stream buffer which is to be decoded. In this example, an entire file
* has been mapped into memory, so we just call mad_stream_buffer() with the
* address and length of the mapping. When this callback is called a second
* time, we are finished decoding.
*/
static
enum mad_flow input(void *data,
struct mad_stream *stream)
{
decoderbuffer_t *buffer = data;
if (!buffer->length)
return MAD_FLOW_STOP;
mad_stream_buffer(stream, buffer->start, buffer->length);
buffer->length = 0;
return MAD_FLOW_CONTINUE;
}
/*
* The following utility routine performs simple rounding, clipping, and
* scaling of MAD's high-resolution samples down to 16 bits. It does not
* perform any dithering or noise shaping, which would be recommended to
* obtain any exceptional audio quality. It is therefore not recommended to
* use this routine if high-quality output is desired.
*/
static inline
signed int scale(mad_fixed_t sample)
{
/* round */
sample += (1L << (MAD_F_FRACBITS - 16));
/* clip */
if (sample >= MAD_F_ONE)
sample = MAD_F_ONE - 1;
else if (sample < -MAD_F_ONE)
sample = -MAD_F_ONE;
/* quantize */
return sample >> (MAD_F_FRACBITS + 1 - 16);
}
/*
* This is the output callback function. It is called after each frame of
* MPEG audio data has been completely decoded. The purpose of this callback
* is to output (or play) the decoded PCM audio.
*/
static
enum mad_flow output(void *data,
struct mad_header const *header,
struct mad_pcm *pcm)
{
decoderbuffer_t *buffer = data;
sfxcache_t *cache;
unsigned int nchannels, nsamples;
mad_fixed_t const *left_ch, *right_ch;
char *outpos;
signed int sample;
float speedfactor;
speedfactor = (float)snd_speed/buffer->mp3sc.speed;
/* pcm->samplerate contains the sampling frequency */
nchannels = pcm->channels;
nsamples = pcm->length*speedfactor;
left_ch = pcm->samples[0];
right_ch = pcm->samples[1];
if (buffer->mp3aswavpos + nsamples*nchannels*sizeof(short) > buffer->mp3aswavbuflen || !buffer->mp3aswavdata)
{
int newsize = buffer->mp3aswavpos + nsamples*nchannels*sizeof(short) + BUFFERSIZEINC+sizeof(sfxcache_t);
char *newbuf = BZ_Malloc(newsize);
if (!newbuf)
return MAD_FLOW_STOP; //damn and blast!
if (buffer->mp3aswavdata) //if we had an old buffer, fill the new one and free the old
{
// memset(newbuf, 0, newsize);
memcpy(newbuf, buffer->mp3aswavdata, buffer->mp3aswavpos+sizeof(sfxcache_t));
// newbuf[newsize] = '\0';
BZ_Free(buffer->mp3aswavdata);
}
buffer->mp3aswavdata = newbuf;
buffer->mp3aswavbuflen = newsize;
buffer->s->cache.data = buffer->mp3aswavdata;
}
cache = (sfxcache_t *)buffer->mp3aswavdata;
outpos = buffer->mp3aswavdata+sizeof(sfxcache_t) + buffer->mp3aswavpos;
if (nchannels == 1)
{
if (speedfactor==1) //fast
{
while (nsamples--)
{
sample = scale(*left_ch++);
*outpos++ = ((sample >> 0) & 0xff);
*outpos++ = ((sample >> 8) & 0xff);
}
}
else
{
int src=0;
int pos=0;
while (pos < nsamples)
{
src = pos/speedfactor;
sample = scale(left_ch[src]);
*outpos++ = (((sample >> 0) & 0xff));
*outpos++ = (((sample >> 8) & 0xff));
pos++;
}
}
cache->stereo = 0;
}
else
{
if (speedfactor==1) //fast
{
while (nsamples--)
{ //merge channels?
sample = scale(*left_ch++);
*outpos++ = (((sample >> 0) & 0xff));
*outpos++ = (((sample >> 8) & 0xff));
sample = scale(*right_ch++)/2;
*outpos++ = (((sample >> 0) & 0xff));
*outpos++ = (((sample >> 8) & 0xff));
}
}
else
{
int src=0;
int pos=0;
while (pos < nsamples)
{
src = pos/speedfactor;
sample = scale(left_ch[src]);
*outpos++ = (((sample >> 0) & 0xff));
*outpos++ = (((sample >> 8) & 0xff));
sample = scale(right_ch[src]);
*outpos++ = (((sample >> 0) & 0xff));
*outpos++ = (((sample >> 8) & 0xff));
pos++;
}
}
cache->stereo = 1;
}
buffer->mp3aswavpos += pcm->length*speedfactor*sizeof(short)*nchannels;
buffer->mp3sc.length+= pcm->length*speedfactor;
cache->speed = snd_speed;
cache->length = buffer->s->decoder->decodedlen = buffer->mp3sc.length;
cache->loopstart = -1;//buffer->mp3sc.loopstart;
cache->width = buffer->mp3sc.width;
return MAD_FLOW_CONTINUE;
}
/*
* This is the error callback function. It is called whenever a decoding
* error occurs. The error is indicated by stream->error; the list of
* possible MAD_ERROR_* errors can be found in the mad.h (or
* libmad/stream.h) header file.
*/
static
enum mad_flow error(void *data,
struct mad_stream *stream,
struct mad_frame *frame)
{
decoderbuffer_t *buffer = data;
if (stream->error == 257)
return MAD_FLOW_IGNORE;
if (developer.value)
Con_SafePrintf("MP3Error: decoding error 0x%04x (%s) at byte offset %u\n",
stream->error, mad_stream_errorstr(stream),
stream->this_frame - buffer->start);
buffer->failed = true;
return MAD_FLOW_IGNORE;
}
static enum mad_flow header(void *data,
struct mad_header const *header)
{
decoderbuffer_t *buffer = data;
buffer->mp3sc.speed = header->samplerate;
buffer->mp3sc.width = 2;
return MAD_FLOW_CONTINUE;
}
void CancelDecoder(sfx_t *s)
{
decoderbuffer_t *dec = s->decoder->buf;
mymad_finish(&dec->decoder);
mad_decoder_finish(&dec->decoder);
s->cache.fake = false; //give it a true cache now, and hope that we don't need to free it while it's still playing.
s->cache.data=NULL;
BZ_Free(dec->mp3aswavdata);
if (dec->start)
BZ_Free(dec->start);
Z_Free(s->decoder);
s->decoder = NULL;
}
/*
* This is the function called by main() above to perform all the
* decoding. It instantiates a decoder object and configures it with the
* input, output, and error callback functions above. A single call to
* mad_decoder_run() continues until a callback function returns
* MAD_FLOW_STOP (to stop decoding) or MAD_FLOW_BREAK (to stop decoding and
* signal an error).
*/
int DecodeSomeMP3(sfx_t *s, int minlength)
{
decoderbuffer_t *dec = s->decoder->buf;
// int oldlen;
if (!dec->start)
return 1;
while(dec->mp3sc.length <= minlength)
{
if (!mymad_run(&dec->decoder) || dec->failed)
{
if (dec->mp3aswavbuflen>441000)//10 secs at highest quality
{ //big fat heffers of mp3s are kept like this and are flushed when they finish playing fully.
BZ_Free(dec->start);
dec->start = NULL;
}
else
{ //small mp3 files are now treated like wavs
void *newmem;
mymad_finish(&dec->decoder);
mad_decoder_finish(&dec->decoder);
s->cache.fake = false; //give it a true cache now, and hope that we don't need to free it while it's still playing.
s->cache.data=NULL;
if (dec->mp3aswavdata)
{
newmem = Cache_Alloc(&s->cache, dec->mp3aswavbuflen+sizeof(sfxcache_t), s->name);
memcpy(newmem, dec->mp3aswavdata, dec->mp3aswavbuflen+sizeof(sfxcache_t));
BZ_Free(dec->mp3aswavdata);
}
BZ_Free(dec->start);
Z_Free(s->decoder);
s->decoder = NULL;
}
return 1;
}
}
return 0;
}
int mymad_decoder_run(struct mad_decoder *decoder, enum mad_decoder_mode mode);
static
int startdecode(unsigned char *start, unsigned long length, decoderbuffer_t *buffer)
{
/* initialize our private message structure */
buffer->start = start;
buffer->length = length;
buffer->failed = false;
/* configure input, output, and error functions */
mad_decoder_init(&buffer->decoder, buffer,
input, header, 0 /* filter */, output,
error, 0 /* message */);
/* start decoding */
mymad_reset(&buffer->decoder);
if (buffer->failed)
return false;
return true;
}
#endif