Glenn Maynard
1bd5513698
This allows us to change the volume of sounds in filters ("volume",
"fade" properties) without quantizing the audio prematurely. Previously,
we had a hack to apply volume changes as a mixing-time step. This
can be done at any point in the filter chain now.
This also means we only need to worry about clipping at the very
last mixing step, instead of at every place we change sound.
Dithering for 16-bit audio and more intelligent gain control
is possible, as we have full-resolution, unclipped sound at the
mixing phase.
We support high resolution source sounds; both Vorbis and MAD
supply more than 16 bits.
Several filters, such as resampling, are easier to implement as
floats; these no longer need to convert back and forth.
Negatives:
- More memory use. The main case of this is in RageSoundReader_Preload,
which will be fixed: we can preload in 16-bit without losing most of the
above.
- Some extra overhead for accessing more memory.
72 lines
2.9 KiB
C++
72 lines
2.9 KiB
C++
/* RageSoundReader - Data source for a RageSound. */
|
|
|
|
#ifndef RAGE_SOUND_READER_H
|
|
#define RAGE_SOUND_READER_H
|
|
|
|
class RageSoundReader
|
|
{
|
|
public:
|
|
virtual int GetLength() const = 0; /* ms */
|
|
virtual int GetLength_Fast() const { return GetLength(); } /* ms */
|
|
virtual int SetPosition( int iSample ) = 0;
|
|
virtual int Read( float *pBuf, int iFrames ) = 0;
|
|
virtual ~RageSoundReader() { }
|
|
virtual RageSoundReader *Copy() const = 0;
|
|
virtual int GetSampleRate() const = 0;
|
|
virtual unsigned GetNumChannels() const = 0;
|
|
virtual bool SetProperty( const RString &sProperty, float fValue ) { return false; }
|
|
virtual RageSoundReader *GetSource() { return NULL; }
|
|
|
|
/* Return values for Read(). */
|
|
enum {
|
|
/* An error occurred; GetError() will return a description of the error. */
|
|
ERROR = -1,
|
|
END_OF_FILE = -2,
|
|
|
|
/* A nonblocking buffer in the filter chain has underrun, and no data is
|
|
* currently available. */
|
|
WOULD_BLOCK = -3,
|
|
|
|
/* The source position has changed in an expected way, such as looping.
|
|
* Seeking manually will not cause this. */
|
|
STREAM_LOOPED = -4,
|
|
};
|
|
|
|
/* GetNextSourceFrame() provides the source frame associated with the next frame
|
|
* that will be read via Read(). GetStreamToSourceRatio() returns the ratio
|
|
* for extrapolating the source frames of the remainder of the block. These
|
|
* values are valid so long as no parameters are changed before the next Read(). */
|
|
virtual int GetNextSourceFrame() const = 0;
|
|
virtual float GetStreamToSourceRatio() const = 0;
|
|
|
|
virtual RString GetError() const = 0;
|
|
int RetriedRead( float *pBuffer, int iFrames, int *iSourceFrame = NULL, float *fRate = NULL );
|
|
};
|
|
|
|
#endif
|
|
|
|
/*
|
|
* Copyright (c) 2002-2003 Glenn Maynard
|
|
* All rights reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, and/or sell copies of the Software, and to permit persons to
|
|
* whom the Software is furnished to do so, provided that the above
|
|
* copyright notice(s) and this permission notice appear in all copies of
|
|
* the Software and that both the above copyright notice(s) and this
|
|
* permission notice appear in supporting documentation.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
|
|
* THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS
|
|
* INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT
|
|
* OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
|
|
* OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
|
* OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
* PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|