OpenMAX大意(一~三)
解析以OpenMAX非Tunneled为例,从应用线程开始。
一、应用线程基本流程
1. OMX_Init()
2. 获取句柄,组件转到Loaded状态
OMX_GetHandle(out handle, in componentName, in appData, in callbacks);
其中callbacks结构包括三个回调函数指针(作用后文介绍):
1) EventHandler
2) EmptyBufferDone
3) FillBufferDone
3. 参数交互
如:
OMX_GetParameter(in handle, in type, out param);
OMX_SetParameter(in handle, in type, in param);
其中关键需要设置每个端口上的Buffer数量,一般采用2个Buffer,如下对端口参数进行设置:
paramPort.nBufferCountActual = 2;
具体参数详见后文介绍
4. 命令组件转到Idle状态
OMX_SendCommand(in handle, in cmd = OMX_CommandStateSet, in nParam = OMX_StateIdle, in pCmdData = 0);
5. Idle期准备
包括:
1) Buffer分配
2) 等待组件正式转到Idle状态,这个由信号量控制。这个信号量在上述EventHandler回调函数中put,而这个回调函数在状态转换完毕以后作为OMX_EventCmdComplete事件的响应被调用。
6. 组件转到Executing状态
OMX_SendCommand(in handle, in cmd = OMX_CommandStateSet, in nParam = OMX_StateExecuting, in pCmdData = 0);
命令组件转到Executing状态
等待转换完成,同样用信号量控制。
7. 初始化端口Buffer并绑定
通过调用OMX_FillThisBuffer设置组件的输出Buffer
通过调用OMX_EmptyThisBuffer设置组件的输入Buffer,此处可为输入Buffer加载初始数据流。
8. 主线程消息循环
在这里等待应用信号量,其中包括组件完毕的消息,用以退出循环。
9. 收尾工作1:命令并等待组件进入Idle状态
10. 收尾工作2:命令并等待组件进入Loaded状态,并销毁Buffer
11. 释放组件句柄
二、组件缓冲处理
当组件完成数据输出(Fill Buffer)后会调用FillBufferDone回调函数以通知应用层准备数据(仅非Tunneled模式)
函数C代码原型:
FillBufferDone(OMX_OUT OMX_HANDLETYPE hComponent, OMX_OUT OMX_PTR pAppData, OMX_OUT OMX_BUFFERHEADERTYPE *pBuffer)
其中hComponent是组件句柄;pAppData为GetHandle时赋入的应用数据;pBuffer为缓冲地址。由于该缓冲已经填写完毕(通常是一帧完成),回调函数将改数据输出到适当位置,完后再次调用OMX_FillThisBuffer,链入下一轮工作。
当组件完成数据消耗(Empty Buffer)后会调用EmptyBufferDone回调函数以通知应用层准备数据(仅非Tunneled模式)
函数C代码原型:
EmptyBufferDone(OMX_OUT OMX_HANDLETYPE hComponent, OMX_OUT OMX_PTR pAppData, OMX_OUT OMX_BUFFERHEADERTYPE *pBuffer)
三个参数含义同上。由于改缓冲已经消耗殆尽,回调函数将读入数据载入缓冲,完后再次调用OMX_EmptyThisBuffer,链入下一轮工作。
上述缓冲操作是组件运行的一个环节,OpenMAX组件运行于一个独立线程。
三、组件事件处理
当组件接收到一个OpenMAX事件时会调用EventHandler
EventHandler(OMX_OUT OMX_HANDLETYPE hComponent, OMX_OUT OMX_PTR pAppData, OMX_OUT OMX_EVENTTYPE eEvent, OMX_OUT OMX_U32 nData1, OMX_OUT OMX_U32 nData2, OMX_IN OMX_PTR pEventData);
其中前两个参数已在第二章介绍。eEvent为事件代号,例如第一章提到的OMX_SendCommand,对命令完成的所引发的事件即OMX_EventCmdComplete。
nData1和nData2是该事件的两个关联数据。例如,对于命令完成事件,如果命令为状态切换,其中nData1即OMX_CommandStateSet;nData2即对应的目标状态,如OMX_StateIdle等。又如对于缓冲事件,其eEvent为OMX_EventBufferFlag,当nData2为OMX_BUFFERFLAG_EOS时往往说明输入码流结束,从而对该事件的响应通常是设置EOF标记并put信号量通知处于循环中的应用线程。
一、应用线程基本流程
1. OMX_Init()
2. 获取句柄,组件转到Loaded状态
OMX_GetHandle(out handle, in componentName, in appData, in callbacks);
其中callbacks结构包括三个回调函数指针(作用后文介绍):
1) EventHandler
2) EmptyBufferDone
3) FillBufferDone
3. 参数交互
如:
OMX_GetParameter(in handle, in type, out param);
OMX_SetParameter(in handle, in type, in param);
其中关键需要设置每个端口上的Buffer数量,一般采用2个Buffer,如下对端口参数进行设置:
paramPort.nBufferCountActual = 2;
具体参数详见后文介绍
4. 命令组件转到Idle状态
OMX_SendCommand(in handle, in cmd = OMX_CommandStateSet, in nParam = OMX_StateIdle, in pCmdData = 0);
5. Idle期准备
包括:
1) Buffer分配
2) 等待组件正式转到Idle状态,这个由信号量控制。这个信号量在上述EventHandler回调函数中put,而这个回调函数在状态转换完毕以后作为OMX_EventCmdComplete事件的响应被调用。
6. 组件转到Executing状态
OMX_SendCommand(in handle, in cmd = OMX_CommandStateSet, in nParam = OMX_StateExecuting, in pCmdData = 0);
命令组件转到Executing状态
等待转换完成,同样用信号量控制。
7. 初始化端口Buffer并绑定
通过调用OMX_FillThisBuffer设置组件的输出Buffer
通过调用OMX_EmptyThisBuffer设置组件的输入Buffer,此处可为输入Buffer加载初始数据流。
8. 主线程消息循环
在这里等待应用信号量,其中包括组件完毕的消息,用以退出循环。
9. 收尾工作1:命令并等待组件进入Idle状态
10. 收尾工作2:命令并等待组件进入Loaded状态,并销毁Buffer
11. 释放组件句柄
二、组件缓冲处理
当组件完成数据输出(Fill Buffer)后会调用FillBufferDone回调函数以通知应用层准备数据(仅非Tunneled模式)
函数C代码原型:
FillBufferDone(OMX_OUT OMX_HANDLETYPE hComponent, OMX_OUT OMX_PTR pAppData, OMX_OUT OMX_BUFFERHEADERTYPE *pBuffer)
其中hComponent是组件句柄;pAppData为GetHandle时赋入的应用数据;pBuffer为缓冲地址。由于该缓冲已经填写完毕(通常是一帧完成),回调函数将改数据输出到适当位置,完后再次调用OMX_FillThisBuffer,链入下一轮工作。
当组件完成数据消耗(Empty Buffer)后会调用EmptyBufferDone回调函数以通知应用层准备数据(仅非Tunneled模式)
函数C代码原型:
EmptyBufferDone(OMX_OUT OMX_HANDLETYPE hComponent, OMX_OUT OMX_PTR pAppData, OMX_OUT OMX_BUFFERHEADERTYPE *pBuffer)
三个参数含义同上。由于改缓冲已经消耗殆尽,回调函数将读入数据载入缓冲,完后再次调用OMX_EmptyThisBuffer,链入下一轮工作。
上述缓冲操作是组件运行的一个环节,OpenMAX组件运行于一个独立线程。
三、组件事件处理
当组件接收到一个OpenMAX事件时会调用EventHandler
EventHandler(OMX_OUT OMX_HANDLETYPE hComponent, OMX_OUT OMX_PTR pAppData, OMX_OUT OMX_EVENTTYPE eEvent, OMX_OUT OMX_U32 nData1, OMX_OUT OMX_U32 nData2, OMX_IN OMX_PTR pEventData);
其中前两个参数已在第二章介绍。eEvent为事件代号,例如第一章提到的OMX_SendCommand,对命令完成的所引发的事件即OMX_EventCmdComplete。
nData1和nData2是该事件的两个关联数据。例如,对于命令完成事件,如果命令为状态切换,其中nData1即OMX_CommandStateSet;nData2即对应的目标状态,如OMX_StateIdle等。又如对于缓冲事件,其eEvent为OMX_EventBufferFlag,当nData2为OMX_BUFFERFLAG_EOS时往往说明输入码流结束,从而对该事件的响应通常是设置EOF标记并put信号量通知处于循环中的应用线程。
enjoy every minute of an appless, googless and oracless life