mixengine.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:10k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef _AFMTCVT_H_
  36. #define _AFMTCVT_H_
  37. #include "hxtypes.h"
  38. #include "hxresult.h"
  39. #include "hlxclib/string.h" // memcpy/memset
  40. // define the "native audio data type"
  41. // on memory- and resource-constrained devices, use 16-bit processing
  42. #if defined(_PALMOS) || defined(_SYMBIAN)
  43. typedef INT16 tAudioSample ;
  44. #if defined(HELIX_FEATURE_GAINTOOL) || defined(HELIX_FEATURE_CROSSFADE)
  45. #error "gain tool and crossfader do not work on 16-bit data types yet"
  46. #endif
  47. #else // all other platforms use 32-bit processing
  48. typedef INT32 tAudioSample ;
  49. #endif
  50. #define NBITS_PER_AUDIOSAMPLE (sizeof(tAudioSample)<<3)
  51. // derive your class from this. This will be used as a callback to convert samples from
  52. // the renderer input queues into the HXAudioSvcMixEngine source buffer
  53. class CAudioSvcSampleConverter
  54. {
  55. public:
  56.     // As a client of the MixEngine, you need to implement this function. Its
  57.     // purpose is to fill a mixengine-owned buffer with samples representing the
  58.     // time between llStartTime and llStartTime + nSamples.
  59.     // If you have data for all the buffer, convert it all and return 1.
  60.     // If you have partial data, convert what you have, and silence out the rest. Return 1.
  61.     // If you have no data at all, just return 0. You may silence the buffer, but don't have to.
  62.     virtual BOOL ConvertIntoBuffer(tAudioSample* buffer, UINT32 nSamples, INT64 llStartTimeInSamples) = 0;
  63. protected:
  64.     // using these utility functions.
  65.     static void cvt8 (const void *in, tAudioSample* out, int nSamples)
  66.     {
  67.         for (int i=0; i < nSamples; i++) out[i] = (((const UINT8*)in)[i] - 128) << (NBITS_PER_AUDIOSAMPLE-8) ;
  68.     }
  69.     static void cvt16(const void *in, tAudioSample* out, int nSamples)
  70.     {
  71.         for (int i=0; i < nSamples; i++) out[i] = ((const INT16*)in)[i] << (NBITS_PER_AUDIOSAMPLE-16) ;
  72.     }
  73.     static void cvt32(const void *in, tAudioSample* out, int nSamples)
  74.     {
  75.         if (NBITS_PER_AUDIOSAMPLE == 32)
  76.             memcpy(out, in, nSamples * sizeof(*out));
  77.         else
  78.             for (int i=0; i < nSamples; i++) out[i] = (INT16)(((const INT32*)in)[i] >> (NBITS_PER_AUDIOSAMPLE-16)) ;
  79.     }
  80.     static void silence(tAudioSample* out, int nSamples)
  81.     {
  82.         memset(out, 0, nSamples * sizeof(*out)) ;
  83.     }
  84. } ;
  85. // forward and other definitions
  86. struct COEFF ;
  87. class RAExactResampler ;
  88. typedef struct GAIN_STATE GAIN_STATE ;
  89. typedef struct XFADER_STATE XFADER_STATE ;
  90. typedef struct LIMSTATE LIMSTATE ;
  91. typedef struct UpMixMachine  tUpMixMachine ;
  92. class HXAudioSvcMixEngine
  93. {
  94. public:
  95.     HXAudioSvcMixEngine() ;
  96.     ~HXAudioSvcMixEngine() ;
  97.     // set the parameters. You can call this (and change the parameters) in operation,
  98.     // but it will reset the time line.
  99.     HX_RESULT Init(INT32 sampleRateIn, INT32 sampleRateOut, INT32 nChannelsIn, INT32 nChannelsOut) ;
  100.     // set the output bytes per sample. Set it to 2 for 16-bit output, 4 for 32-bit
  101.     // output. Note that this does not influence the datatype of internal computations.
  102.     HX_RESULT SetOutputBytesPerSample(UINT32 bps) ;
  103.     // Set the sample converter. The mix engine uses the sample converter to read
  104.     // new samples.
  105.     HX_RESULT SetSampleConverter(CAudioSvcSampleConverter *pCvt) ;
  106.     // set the volume/gain. This is in tenth of a dB. 0 == unity gain, 6dB = twice as loud, -6dB = half as loud
  107.     // set bImmediate if you want the gain change to be immediate
  108.     // (if you don't know what this means, then you don't want it to be immediate)
  109.     HX_RESULT SetVolume(INT32 tenthOfDB, BOOL bImmediate = FALSE) ;
  110.     // use this to convert from "Helix Volume Scale" to tenth of dB.
  111.     static INT32 HXVolume2TenthOfDB(INT32 vol) ;
  112.     enum
  113.     {
  114.         VOLUME_SILENT = -200 * 10 // -200 dB is as good as silent.
  115.     } ;
  116.     // set the downmix matrix. There are default downmix matrices, so you don't need to 
  117.     // call this function. In fact, it is not yet spec'ed out.
  118.     // SetDownmixMatrix() ;
  119.     // This will issue a series of Convert::ConvertIntoBuffer() callbacks,
  120.     // and will return with a full buffer of resampled/channel converted/mixed data.
  121.     HX_RESULT MixIntoBuffer(
  122.         void* pPlayerBuf,
  123.         UINT32 ulBufSizeInBytes,
  124.         BOOL&    bIsMixBufferDirty
  125.     ) ;
  126.     // guess what.
  127.     enum eCrossfadeDirection
  128.     {
  129.       FADE_IN  = 0,
  130.       FADE_OUT = 1
  131.     } ;
  132.     // This will register a cross fade. The cross fade will be unregistered only
  133.     // when ResetTimeline() is called or when the fade is done.
  134.     // the time stamps are in units of samples of the output signal.
  135.     HX_RESULT SetCrossFade(
  136.         enum eCrossfadeDirection inOut, // 0 for fade in, 1 for fade out.
  137.         INT64 llStarttimeInSamples,
  138.         INT64 llEndtimeInSamples
  139.     ) ;
  140.     // reset the time line. Call this whenever the next call to MixIntoBuffer()
  141.     // will have a time stamp that is non-contiguous with the previous mix.
  142.     // This should only be the case after Seek/Resume
  143.     HX_RESULT ResetTimeLineInMillis(INT64 millis) ;
  144.     // the time of the next mix, in ms.
  145.     INT64 GetNextMixTimeMillis(void) const;
  146.     // ask the mixer which range of input samples it will request in a mix operation
  147.     // of size nBytesToMix.
  148.     void GetMixRange(UINT32 nBytesToMix, INT64& llStart, INT64& llEnd) const;
  149. protected:
  150.     // the sample converter we call back into
  151.     CAudioSvcSampleConverter *m_pCvt ;
  152. private:
  153.     // we process audio in batches, so that we don't have to dynamically
  154.     // allocate memory and can work inside of the cache. This is the number
  155.     // of samples we process at any one time.
  156.     enum
  157.     {
  158.         BATCHSIZE = 2048
  159.     } ;
  160.     // helper functions
  161.     void releaseResources() ;
  162.     HX_RESULT SetupResamplerAndBuffers(void) ;
  163.     HX_RESULT SetupUpDownmix(void) ;
  164.     // timekeeping & other variables
  165.     INT64 m_llTimestamp_1, m_llTimestamp_3 ; // time on input & output
  166.     UINT32 m_ulSampleRate_1_2, m_ulSampleRate_3_4 ;
  167.     UINT32 m_nChannels_1, m_nChannels_2_3, m_nChannels_4 ;
  168.     UINT32 m_ulChunkSize_1,m_ulChunkSize_3 ;
  169.     UINT32 m_ulBytesPerSample ; // bytes per sample on the output
  170.     UINT32 m_nOutputSamplesLeft_3 ;
  171.     UINT32 m_ulBufferSize_3 ;
  172.     tAudioSample *m_pBuffer_1, *m_pBuffer_3 ; // buffer pre- and post resampler
  173.     // resampler
  174.     RAExactResampler *m_pResampler ;
  175.     UINT32 m_ulResamplerPhase ;
  176.     // XFader
  177.     INT64 m_llFadeStart ;
  178.     UINT32 m_ulXFadeSamples ;
  179.     BOOL m_bPastXFade ; // set to TRUE if we have passed the X-Fade point.
  180.     enum eCrossfadeDirection m_eCrossFadeDirection ;
  181.     XFADER_STATE *m_pXFader ;
  182.     // gain tool
  183.     GAIN_STATE *m_pGaintool ;
  184.     // limiter
  185.     LIMSTATE *m_pLimiter ;
  186.     // downmix/upmix
  187.     enum { HEADROOM = 3 } ;
  188.     int m_slev, m_clev ;
  189.     UINT32 upmix(const tAudioSample *pIn, INT32 *pOut, const tUpMixMachine *pUpmixMachine, int nSamples, BOOL isDirty) ;
  190.     UINT32 upmix(const tAudioSample *pIn, INT16 *pOut, const tUpMixMachine *pUpmixMachine, int nSamples, BOOL isDirty) ;
  191.     const tUpMixMachine *m_upmixMachine ; // how to "up"-mix the audio
  192.     void downmix2_1(tAudioSample *pBuffer, int nSamples) ;
  193.     void downmix5_1(tAudioSample *pBuffer, int nSamples) ;
  194.     void downmix4_2_stereo(tAudioSample *pBuffer, int nSamples) ;
  195.     void downmix4_2_matrix(tAudioSample *pBuffer, int nSamples) ;
  196.     void downmix5_2_stereo(tAudioSample *pBuffer, int nSamples) ;
  197.     void downmix5_2_matrix(tAudioSample *pBuffer, int nSamples) ;
  198.     void downmix6_1(tAudioSample *pBuffer, int nSamples) ;
  199.     void downmix6_2_stereo(tAudioSample *pBuffer, int nSamples) ;
  200.     void downmix6_2_matrix(tAudioSample *pBuffer, int nSamples) ;
  201.     void downmix6_5(tAudioSample *pBuffer, int nSamples) ;
  202.     typedef void (HXAudioSvcMixEngine::*tDownmixfunc)(tAudioSample *pBuffer, int nSamples) ;
  203.     tDownmixfunc m_pfDownmix ; // function to downmix the audio
  204. } ;
  205. #endif /* _AFMTCVT_H_ */