向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;
};
openmax component类的继承关系