openmax component类的继承关系

向OpenCORE里继承一个新的codec时，需要用到OpenMAX接口规范对该codec进行封装，即要定义一个用于封装的类(wrapper)，实现OpenMAX规定的集中核心方法(omx core methods)。若该codec是一个音频解码器，则该类继承OmxComponentAudio类；若是视频解码器，则继承OmxComponentVideo类。而OmxComponentAudio和OmxComponentVideo类都是继承了OmxComponentBase类；OmxComponentBase类又继承自OsclActiveObject类。

为了深入点理解每OMX Component每个接口(core methods)具体要实现些什么功能，我们逐一深入这些相关的类的定义中。

【1】OsclActiveObject类

该类的定义在.../opencore/oscl/oscl/osclproc/src/oscl_scheduler_ao.h文件中。看给类的注释：

/**

 * User base class for execution objects.

 * OsclActiveObject defines an execution object without any timer.

 * This AO can be used across threads, i.e. the request

 * can be activated in one thread and completed in another.

 */

即该类是用于执行（或运行）对象的用户基础类，该运行对象没有计时器。 这个正在运行的对象(AO)可以在多个线程间被使用，如在一个线程中的请求可以在另一个线程中完成。

OsclActiveObject类又继承自两个类：HeapBase和PVActiveBase类，其中类HeapBase是用于基础的堆操作，如分配、释放内存等。类PVActiveBase主要是跟线程相关的(PV Scheduler internal AO base class)。

OsclActiveObject类主要是定义了对象运行的相关操作，如优先级、对象状态等。

【2】OmxComponentBase类

其中一些接口涉及到proxy(代理？？)，不知道具体什么差别！！！

/** Component entry points declarations without proxy interface*/

……

/** Component entry points declarations with proxy interface*/

……

接着是最重要的部分，

        /*NON STATIC COUNTERPARTS OF STATIC MEMBER API'S */

        //Pure virtual functions, definition to be written in derived class

        /*

          纯虚函数，具体实现在派生的类中。

        */

        virtual OMX_ERRORTYPE GetParameter(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nParamIndex,

            OMX_INOUT OMX_PTR ComponentParameterStructure) = 0;

        virtual OMX_ERRORTYPE SetParameter(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nParamIndex,

            OMX_IN  OMX_PTR ComponentParameterStructure) = 0;

        virtual OSCL_IMPORT_REF OMX_ERRORTYPE GetConfig(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nIndex,

            OMX_INOUT OMX_PTR pComponentConfigStructure);

        //Making Setconfig as virtual function to be implemented in respective component class

// 在各个派生的component中各自实现该函数

        virtual OSCL_IMPORT_REF OMX_ERRORTYPE SetConfig(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nIndex,

            OMX_IN  OMX_PTR pComponentConfigStructure);

……

        /*OTHER PROCESSING FUNCTIONS */

        //Pure virtual function called from base, must have a definition in derived components

        //virtual void Decode() = 0;

        /*

          纯虚函数，必须在派生的类中实现。

           --> OmxComponentAudio --> omx_audio_xxx

           --> OmxComponentVideo --> omx_video_xxx

          

            该函数不是在OmxComponentAudio/OmxComponentVideo中实现，

而是在最终的派生类的实现，不同的编解码器其实现过程是不一样的。

        */

        virtual void ProcessData() = 0;

……

      /*

         需要在派生的类(最终的component)中实现!!

      */

        virtual OMX_ERRORTYPE ComponentInit() = 0;

        virtual OMX_ERRORTYPE ComponentDeInit() = 0;

……

这些接口是每一个OMX component都必须实现的函数(core methods)，其中最重要的5种方法：

(1) ComponentInit()

(2) ComponentDeinit()

(3) GetParameter()

(4) SetParameter()

(5) ProcessData()

【3】OmxComponentAudio类

每个音频解码器组件都必须继承的类，其中GetParameter()和SetParameter()方法在该类中实现，其余方法在最终派生的component类中实现。

class OmxComponentAudio : public OmxComponentBase

{

    public:

        OSCL_IMPORT_REF OmxComponentAudio();

        OSCL_IMPORT_REF virtual ~OmxComponentAudio();

        OSCL_IMPORT_REF OMX_ERRORTYPE GetParameter(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nParamIndex,

            OMX_INOUT OMX_PTR ComponentParameterStructure);

        OSCL_IMPORT_REF OMX_ERRORTYPE SetParameter(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nParamIndex,

            OMX_IN  OMX_PTR ComponentParameterStructure);

        virtual void UpdateAACPlusFlag(OMX_BOOL aAacPlusFlag)

        {

            OSCL_UNUSED_ARG(aAacPlusFlag);

        }

        OSCL_IMPORT_REF virtual void CalculateBufferParameters(OMX_U32 PortIndex);

};

注意：

由OmxComponentBase类继承来的其他虚函数，如ComponentInit(), ComponentDeinit(), ProcessData()等在这还没有具体实现。

【进一步分析GetParameter()和SetParameter()函数！！！！】

【4】OmxComponentVideo类

/*************************

 VIDEO BASE CLASS ROUTINES

 *************************/

class OmxComponentVideo : public OmxComponentBase

{

    public:

        OSCL_IMPORT_REF OmxComponentVideo();

        OSCL_IMPORT_REF virtual ~OmxComponentVideo();

        OSCL_IMPORT_REF OMX_ERRORTYPE GetParameter(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nParamIndex,

            OMX_INOUT OMX_PTR ComponentParameterStructure);

        OSCL_IMPORT_REF OMX_ERRORTYPE SetParameter(

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nParamIndex,

            OMX_IN  OMX_PTR ComponentParameterStructure);

        OSCL_IMPORT_REF virtual void CalculateBufferParameters(OMX_U32 PortIndex);

};

在OmxComponentVideo类中也是把从OmxComponentBase类中继承来的虚函数GetParameter()和SetParameter()函数做了实现。

【5】OpenmaxMp3AO类

该类是对MP3解码器按照openmax接口规范进行封装的类，以便作为一个音频解码的component集成进opencore框架中。

/*

按照openmax接口规范，对mp3 codec进行封装!!

*/

class OpenmaxMp3AO : public OmxComponentAudio

{

    public:

        OpenmaxMp3AO();

        ~OpenmaxMp3AO();

        OMX_ERRORTYPE ConstructComponent(OMX_PTR pAppData, OMX_PTR pProxy);

        OMX_ERRORTYPE DestroyComponent();

        OMX_ERRORTYPE ComponentInit(); // 继承自OmxComponentAudio

        OMX_ERRORTYPE ComponentDeInit(); // 继承自OmxComponentAudio

        void ProcessData(); // 继承自OmxComponentAudio

        void SyncWithInputTimestamp(); // 继承自OmxComponentAudio

        void ProcessInBufferFlag(); // 继承自OmxComponentBase

        void ResetComponent(); // 继承自OmxComponentBase

        OMX_ERRORTYPE GetConfig( // 覆盖掉OmxComponentAudio中的实现

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nIndex,

            OMX_INOUT OMX_PTR pComponentConfigStructure);

    private:

        void CheckForSilenceInsertion();

        void DoSilenceInsertion();

        Mp3Decoder*      ipMp3Dec; // 看具体实现！！！

        Mp3TimeStampCalc iCurrentFrameTS;

};

【6】OpenmaxAvcAO类

该类是对H264解码器按照openmax接口规范进行封装的类，以便作为一个视频解码的component集成进opencore框架中。

class OpenmaxAvcAO : public OmxComponentVideo

{

    public:

        OpenmaxAvcAO();

        ~OpenmaxAvcAO();

        OMX_ERRORTYPE ConstructComponent(OMX_PTR pAppData, OMX_PTR pProxy);

        OMX_ERRORTYPE DestroyComponent();

        OMX_ERRORTYPE ComponentInit();

        OMX_ERRORTYPE ComponentDeInit();

        void ComponentBufferMgmtWithoutMarker();

        OMX_BOOL ParseFullAVCFramesIntoNALs(OMX_BUFFERHEADERTYPE* aInputBuffer);

        void ProcessData();

        void DecodeWithoutMarker();

        void DecodeWithMarker();

        void ResetComponent();

        void ReleaseReferenceBuffers();

        OMX_ERRORTYPE GetConfig( // 覆盖继承类中的实现

            OMX_IN  OMX_HANDLETYPE hComponent,

            OMX_IN  OMX_INDEXTYPE nIndex,

            OMX_INOUT OMX_PTR pComponentConfigStructure);

        OMX_BOOL DetectStartCodeLength(OMX_U8* aBitstream,

                                       OMX_U8** aNalUnit,

                                       OMX_U32 aBufSize,

                                       OMX_U32* aSCSize);

        // ipOutputBuffer is fed to the decoder which may keep it as a reference

        // The decoder "spits" out another output buffer for rendering

        OMX_BUFFERHEADERTYPE *ipOutputBufferForRendering;

    private:

        AvcDecoder_OMX* ipAvcDec;

        OMX_BOOL        iDecodeReturn;

        OMX_BOOL        iFlushOutputStatus;

        // variables for "frame" mode i.e. iOMXComponentNeedsFullAVCFrames is turned on

        OMX_U32 iNALSizeArray[MAX_NAL_PER_FRAME]; // 100 should be more than enough NALs per frame

        OMX_U32 iNALStartCodeSizeArray[MAX_NAL_PER_FRAME]; // 100 should be more than enough NALs per frame

        OMX_U32 iCurrNAL;

        OMX_U32 iNumNALs;

        OMX_U32 iNALOffset;

        OMX_U32 iSizeOfNALSize;

};