OpenMAX大意（四） OpenMAX组件

OpenMAX组件基类在omx_base_component.c中定义。

1. 组件构造和析构

1) 构造函数 Constructor
基类构造函数为omx_base_component_Constructor
这是基于C方式的构造函数实现，其中openmaxStandComp->pComponentPrivate指针指向可能的私有数据。私有数据指针原型为omx_base_component_PrivateType，所有的组件数据继承基本以此为基础。
构造函数的下一个任务是设置有关数据结构，包括：
messageQueue 消息队列
messageSem 消息信号量
bMgmtSem 管理信号量
bStateSem 状态信号量
bufferMgmtThread 缓冲管理线程结构体
messageHandlerThread 消息处理线程结构体

随后加载基类的方法（如果派生类有自定义的方法则在派生类的构造函数加载），并设置一些基本的数据。
最后创建该组件消息处理函数的线程，该线程入口函数为compMessageHandlerFunction。

2) 析构函数 Destructor
基类析构函数为omx_base_component_Destructor。

2. 组件方法

以下组件方法，OpenMAX组件基类均提供了实现，其函数命名为下列方法名加上前缀"omx_base_component_"。

1) 组件操作相关方法
- GetComponentVersion
获取组件版本

- SendCommand
向组件发送消息
首先创建命令结构体，并做一些检查。
设置messageParam，即nParam参数。
设置messageType，有以下不同情形，然后分别进行准备：
> OMX_CommandStateSet
nParam为目标状态。这里需要做一些状态转换的准备工作：
对于从OMX_StateLoaded到OMX_StateIdle的转换，为每个端口的分配bBufferStateAllocated数组，其元素个数为该端口的缓冲数，并为该数组赋初值BUFFER_FREE；和pInternalBufferStorage数组，个数亦为缓冲数。这些数据结构的销毁在状态转换OMX_StateIdle -> OMX_StateLoaded的实施过程中进行。之所以要在此处做内存分配是因为应用层调用SendCommand函数返回后可能直接会进行相关的内存操作，如果等到实际状态转换时（DoStateSet）再进行分配就迟了。
以下过渡量设置对应相应的状态转换命令：

OMX_TransStateIdleToLoaded
OMX_TransStateLoadedToIdle -- 在Buffer management函数中作为被处理的条件

OMX_TransStateExecutingToIdle

> OMX_CommandFlush
冲刷命令
nParam为端口号，检查。
> OMX_CommandPortDisable
端口禁用
nParam为端口号，检查。
如果nParam为-1则禁用所有端口，否则禁用指定端口。操作放在messageHandler中进行。
> OMX_CommandPortEnable
端口使能
nParam为端口号，检查。
如果nParam为-1则使能所有端口，否则使能指定端口。操作放在messageHandler中进行。
> OMX_CommandMarkBuffer
标注缓冲

最后将消息装入消息队列，并提升信号量messageSem以激活compMessageHandlerFunction。

- GetParameter
获取组件参数

- SetParameter
设置组件参数

- GetConfig
获取组件配置

- SetConfig
设置组件配置

- GetExtensionIndex
获取组件扩展名索引

- GetState
获取组件状态

- SetCallbacks
设置回调函数

- ComponentDeInit
反初始化组件

- ComponentRoleEnum
组件角色枚举

- ComponentTunnelRequest
组件隧道请求

2) 缓冲相关方法
- AllocateBuffer
为指定端口分配缓冲
调用端口的Port_AllocateBuffer方法完成功能

- UseBuffer
为指定端口指定缓冲
调用端口的Port_UseBuffer方法完成功能

- UseEGLImage
未实现

- FreeBuffer
将指定端口的缓冲释放
调用端口的Port_FreeBuffer方法完成功能

- EmptyThisBuffer
命令组件消耗指定缓冲
首先检查端口正确性，如端口索引，以及该端口是否为输入缓冲，然后调用端口的Port_SendBufferFunction方法完成功能。

- FillThisBuffer
命令组件填充指定缓冲
首先检查端口正确性，如端口索引，以及该端口是否为输出缓冲，然后调用端口的Port_SendBufferFunction方法完成功能。

3) 状态和消息相关处理
- DoStateSet
实施状态转换。这是一个重要的功能函数，它规定了组件的默认行为。它本质上反映了OpenMAX组件状态转换自动机。
以下列出允许的状态转换和相应需要进行的工作：

> OMX_StateWaitForResources <-> OMX_StateLoaded
无操作

> OMX_StateWaitForResources -> OMX_StateIdle
无操作

> OMX_StateIdle -> OMX_StateLoaded
释放各端口。如果端口是Tunnel模式中的缓冲主动方（供应者，Supplier），则需要释放该端口缓冲；否则，如果端口使能需要挂起等待 pAllocSem信号量（缓冲释放）。最后将端口bPopulated置为FALSE。然后提升bMgmtSem信号量以激活缓冲管理线程，退出并销毁缓冲管理线程。最后销毁各端口上bBufferStateAllocated和pInternalBufferStorage数据结构。

> OMX_StateLoaded -> OMX_StateIdle
配置各端口。如果端口是Tunnel模式中的缓冲主动方，则需要为之分配缓冲；否则，如果端口使能，需要挂起等待pAllocSem信号量（缓冲分配），并且把端口bPopulated置为TRUE。然后创建缓冲管理线程，其入口函数为BufferMgmtFunction，从而建立组件处理操作的基础。

> OMX_StateExecuting -> OMX_StateIdle
调用端口的FlushProcessingBuffers方法冲刷各端口的数据。

> OMX_StateIdle -> OMX_StateExecuting
对于Tunnel模式中的缓冲主动方端口，对其上所有缓冲提升(up)pBufferSem信号量，并提升bMgmtSem信号量。

该转换涉及到过渡量transientState复位（在0.9.0中改进）到OMX_TransStateMax。

> OMX_StatePause -> OMX_StateIdle
脉冲(signal)bStateSem信号量以通知可能挂起在Pause状态的缓冲管理线程。

> OMX_StateExecuting -> OMX_StatePause
无操作

> OMX_StateIdle -> OMX_StatePause
无操作

> OMX_StatePause -> OMX_StateExecuting
脉冲(signal)bStateSem信号量以通知可能挂起在Pause状态的缓冲管理线程。

> ANY -> OMX_StateInvalid
提升bMgmtSem信号量以激活缓冲管理线程，退出并销毁缓冲管理线程。

- messageHandler
处理消息
主要包括以下消息了：
> OMX_CommandStateSet
首先调用组件的DoStateSet方法实施状态切换。
如果切换成功，则调用组件的事件处理回调函数EventHandler通知应用层状态切换完成；否则也调用该函数通知状态切换失败
> OMX_CommandFlush
实施缓冲冲刷
message->messageParam为端口号，如果为-1则调用端口FlushProcessingBuffers方法冲刷所有端口，并将所有端口的bIsPortFlushed置为TRUE；否则仅冲刷指定端口。如果冲刷失败则调用回调函数通知；如果成功则对每个完成个冲刷端口调用回调函数EventHandler通知应用层操作成功，以冲刷过的端口作为参数。
> OMX_CommandPortDisable
如果状态不是Loaded，则首先冲刷需要禁用的端口，然后调用端口Port_DisablePort方法禁用端口。最后以相似的策略通知应用层操作结果。
> OMX_CommandPortEnable
调用Port_EnablePort方法使能端口，并通知应用层操作结果。
> OMX_CommandMarkBuffer
将组件成员变量pMark设置为(OMX_MARKTYPE*)message->pCmdData。

3. 全局方法
+ compMessageHandlerFunction
该函数是一个阻塞于messageSem信号量的死循环，它从messageQueue中读出消息并调用组件的messageHandler方法想组件发送消息。

+ BufferMgmtFunction
该函数是组件数据处理的主线程函数，OpenMAX常用的Filter组件基类对其做了详细定义。

+ checkHeader

+ setHeader

+ omx_base_component_ParameterSanityCheck