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

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 _AUDFMT_H_
  36. #define _AUDFMT_H_
  37. /****************************************************************************
  38.  *  Includes
  39.  */
  40. #include "hxtypes.h"
  41. #include "hxcom.h"
  42. #include "hxslist.h"
  43. #include "hxcomm.h"
  44. #include "ihxpckts.h"
  45. #include "hxthread.h"
  46. #include "hxausvc.h"
  47. #include "mdpkt.h"
  48. enum AUDIO_STATE
  49. {
  50.     AUDIO_NORMAL,
  51.     AUDIO_DRYNOTIFICATION,
  52.     AUDIO_END_OF_PACKETS
  53. };
  54. #ifndef NO_TIME_SET
  55. #define NO_TIME_SET 0xFFFFFFFF
  56. #endif
  57. #define MAX_AUSTR_SIZE 64
  58. _INTERFACE IHXCommonClassFactory;
  59. /****************************************************************************
  60.  *  Globals
  61.  */
  62. class CAudioRenderer;
  63. class CHXSimpleList;
  64. /////////////////////////////////////////////////////////////////////////////
  65. // 
  66. //  Class:
  67. //
  68. // CAudioFormat
  69. //
  70. //  Purpose:
  71. //
  72. // Implementation of a RealAudio File Format reader.
  73. //
  74. class CAudioFormat
  75. {
  76. public:
  77.     /*
  78.      * Constructor/Destructor
  79.      */
  80.     CAudioFormat(IHXCommonClassFactory* pCommonClassFactory, 
  81.  CAudioRenderer* pAudioRenderer);
  82.     /*
  83.      * IUnknown methods
  84.      */
  85.     STDMETHOD(QueryInterface) (THIS_
  86. REFIID riid,
  87. void** ppvObj);
  88.     STDMETHOD_(ULONG32,AddRef) (THIS);
  89.     STDMETHOD_(ULONG32,Release) (THIS);
  90.     /*
  91.      * Public but Fixed Core functionality - not deriveable
  92.      */
  93.     void OverrideFactory(IHXCommonClassFactory* pCommonClassFactory);
  94.     BOOL Enqueue(IHXPacket* pCodecData);
  95.     HX_RESULT CreateAudioFrame(HXAudioData& audioData, AUDIO_STATE audioState);
  96.     HX_RESULT GetAudioFormat(HXAudioFormat& audioFmt);
  97.     BOOL ClipAudioBuffer(HXAudioData* pAudioData, 
  98.  UINT32 ulAudioTime, 
  99.  BOOL bFromStart);
  100.     void DiscardAudioUntil(UINT32 ulTimestamp);
  101.     void SetStartTime(ULONG32 ulTime) { m_ulStartTime = ulTime; }
  102.     ULONG32 GetStartTime(void) { return m_ulStartTime; }
  103.     // Assembled Audio Packet Queue 
  104.     HX_RESULT PutAudioPacket(CMediaPacket* pMediaPacket);
  105.     CMediaPacket* PeekAudioPacket(void);
  106.     CMediaPacket* GetAudioPacket(void);
  107.     // Byte <-> Ms conversion functions
  108.     UINT32 ConvertMsToBytes(UINT32 ulMs);
  109.     UINT32 ConvertBytesToMs(UINT32 ulBytes);
  110.     // Sample <-> Ms conversion functions
  111.     UINT32 ConvertMsToSamples(UINT32 ulMs);
  112.     UINT32 ConvertSamplesToMs(UINT32 ulSamples);
  113.     // Sample <-> Bytes conversion functions
  114.     UINT32 ConvertBytesToSamples(UINT32 ulBytes);
  115.     UINT32 ConvertSamplesToBytes(UINT32 ulSamples);
  116.     // Compressed Byte <-> Ms conversion functions 
  117.     // (compression ration is needed)
  118.     void SetCompressionRation(double fCompressionRatio);
  119.     UINT32 ConvertCompressedBytesToMs(UINT32 ulBytes);
  120.     UINT32 ConvertMsToCompressedBytes(UINT32 ulMs);
  121.     // Sample <-> Time conversion functions
  122.     UINT32 ConvertSamplesToTime(UINT32 ulSamples)
  123.     {    
  124. return (ulSamples / m_pAudioFmt->uChannels);
  125.     }
  126.     UINT32 ConvertTimeToSamples(UINT32 ulSamples)
  127.     {    
  128. return (ulSamples * m_pAudioFmt->uChannels);
  129.     }
  130.     // Time <-> Ms conversion routines
  131.     UINT32 ConvertMsToTime(UINT32 ulMs);
  132.     UINT32 ConvertTimeToMs(UINT32 ulTime);
  133.     // Return an AU String
  134.     const char* GetAutoUpgradeString() { return (const char*) &m_szAUStr[0]; }
  135.     /*
  136.      * Public and Customizable functionality - derive to customize
  137.      */
  138.     virtual HX_RESULT Init(IHXValues* pHeader);
  139.     virtual void Reset(void);
  140.     virtual ULONG32 GetDefaultPreroll(IHXValues* pValues);
  141.     virtual ULONG32 GetMaximumPreroll(IHXValues* pValues);
  142.     // This returns flag saying whether or not this format
  143.     // will change the audio stream parameters on the fly
  144.     // or not (i.e. - successive packets can result in 
  145.     // audio stream parameter changes). If this flag returns
  146.     // FALSE, then the base audio renderer doesn't need to
  147.     // check before every write to audio services
  148.     virtual BOOL CanChangeAudioStream() { return FALSE; }
  149.     
  150. protected:
  151.     virtual ~CAudioFormat();
  152.     /*
  153.      * Renderer's customizable fuctions
  154.      */
  155.     virtual CMediaPacket* CreateAssembledPacket(IHXPacket* pPayloadPacket);
  156.     virtual HX_RESULT DecodeAudioData(HXAudioData& audioData, 
  157.       BOOL bFlushCodec = FALSE);
  158.     UINT32  GetULONG32Property(IHXValues*  pValues,
  159.                                const char* pszName,
  160.                                UINT32      ulDefault = 0);
  161.     IUnknown* m_pContext;
  162.     IHXCommonClassFactory* m_pCommonClassFactory;
  163.     HXAudioFormat* m_pAudioFmt;
  164.     char           m_szAUStr[MAX_AUSTR_SIZE];
  165.     
  166. private:
  167.     void FlushQueues(void);
  168.     inline BOOL AdjustAudioData(REF(HXAudioData) audioData);
  169.     
  170.     CHXSimpleList   *m_pPendingPacketQueue;
  171.     BOOL     m_bPostStartTime;
  172.     UINT32     m_ulTrackStartTime;
  173.     UINT32     m_ulTrackEndTime;
  174.     UINT32     m_ulForceDiscardUntilTime;
  175.     UINT32     m_ulStartTime;
  176.     double     m_fCompressionRatio;
  177.     LONG32     m_lRefCount;
  178. };
  179. #endif // ndef _AUDFMT_H_