没有合适的资源?快使用搜索试试~ 我知道了~
首页OpenMax IL 1.2.0 规范
OpenMax IL 1.2.0 规范
4星 · 超过85%的资源 需积分: 17 14 下载量 154 浏览量
更新于2023-05-24
评论
收藏 5.79MB PDF 举报
This document details the Application Programming Interface (API) for the OpenMAX Integration Layer (IL). Developed as an open standard by The Khronos Group, the IL serves as a low-level interface for audio, video, and imaging components used in embedded and/or mobile devices. The principal goal of the IL is to give components a degree of system abstraction for the purpose of portability across operating systems and software stacks
资源详情
资源评论
资源推荐
OpenMAX™ Integration Layer
Application Programming Interface
Specification
Version 1.2.0 Provisional
Copyright © 2011 The Khronos Group Inc.
November 7, 2011
Document version 1.2.0.0
2
Copyright © 2005-2011 The Khronos Group Inc. All Rights Reserved.
This specification is protected by copyright laws and contains material proprietary to the
Khronos Group, Inc. It or any components may not be reproduced, republished, distributed,
transmitted, displayed, broadcast, or otherwise exploited in any manner without the express prior
written permission of the Khronos Group. You may use this specification for implementing the
functionality therein, without altering or removing any trademark, copyright or other notice from
the specification, but the receipt or possession of this specification does not convey any rights to
reproduce, disclose, or distribute its contents, or to manufacture, use, or sell anything that it may
describe, in whole or in part.
Khronos Group grants express permission to any current Promoter, Contributor or Adopter
member of Khronos to copy and redistribute UNMODIFIED versions of this specification in any
fashion, provided that NO CHARGE is made for the specification and the latest available update
of the specification for any version of the API is used whenever possible. Such distributed
specification may be reformatted AS LONG AS the contents of the specification are not changed
in any way. The specification may be incorporated into a product that is sold as long as such
product includes significant independent work developed by the seller. A link to the current
version of this specification on the Khronos Group website should be included whenever
possible with specification distributions.
Khronos Group makes no, and expressly disclaims any, representations or warranties, express or
implied, regarding this specification, including, without limitation, any implied warranties of
merchantability or fitness for a particular purpose or non-infringement of any intellectual
property. Khronos Group makes no, and expressly disclaims any, warranties, express or implied,
regarding the correctness, accuracy, completeness, timeliness, and reliability of the specification.
Under no circumstances will the Khronos Group, or any of its Promoters, Contributors or
Members or their respective partners, officers, directors, employees, agents or representatives be
liable for any damages, whether direct, indirect, special or consequential damages for lost
revenues, lost profits, or otherwise, arising from or in connection with these materials.
SAMPLE CODE and EXAMPLES, as identified herein, are expressly depicted herein with a
“grey” watermark and are included for illustrative purposes only and are expressly outside of the
Scope as defined in Attachment A - Khronos Group Intellectual Property (IP) Rights Policy of
the Khronos Group Membership Agreement. A Member or Promoter Member shall have no
obligation to grant any licenses under any Necessary Patent Claims covering SAMPLE CODE
and EXAMPLES.
Khronos and OpenMAX are trademarks of the Khronos Group Inc. Bluetooth is a registered
trademark of the Bluetooth Special Interest Group. RealAudio and RealVideo are registered
trademarks of RealNetworks, Inc. Windows Media is a registered trademark of Microsoft
Corporation.
3
Contents
1 OVERVIEW ........................................................................................................................................................ 11
1.1 INTRODUCTION .................................................................................................................................................. 11
1.1.1 About the Khronos Group....................................................................................................................... 11
1.1.2 A Brief History of OpenMAX .................................................................................................................. 11
1.2 THE OPENMAX INTEGRATION LAYER ............................................................................................................. 11
1.2.1 Key Features and Benefits ...................................................................................................................... 11
1.2.2 Design Philosophy .................................................................................................................................. 12
1.2.3 Software Landscape ................................................................................................................................ 13
1.2.4 Stakeholders ............................................................................................................................................ 13
1.2.5 The Interface ........................................................................................................................................... 14
1.3 DEFINITIONS ...................................................................................................................................................... 15
1.4 AUTHORS ........................................................................................................................................................... 16
1.5 FEATURES NEW TO VERSION 1.2 ...................................................................................................................... 17
1.6 BACKWARD COMPATIBILITY ............................................................................................................................ 20
2 OPENMAX IL INTRODUCTION AND ARCHITECTURE ........................................................................ 24
2.1 ARCHITECTURAL OVERVIEW ............................................................................................................................ 24
2.2 KEY VOCABULARY ........................................................................................................................................... 25
2.2.1 Key Definitions ....................................................................................................................................... 26
2.3 SYSTEM COMPONENTS ...................................................................................................................................... 27
2.3.1 Component Profiles ................................................................................................................................ 28
2.4 COMPONENT STATES ......................................................................................................................................... 29
2.5 COMPONENT ARCHITECTURE ............................................................................................................................ 31
2.6 COMMUNICATION BEHAVIOR ............................................................................................................................ 32
2.7 THREAD SAFETY ............................................................................................................................................... 33
2.8 TUNNELED BUFFER ALLOCATION ..................................................................................................................... 34
2.8.1 IL Client Component Setup .................................................................................................................... 37
2.8.2 Component Transition from OMX_StateLoaded to OMX_StateIdle ..................................................... 37
2.9 PORT RECONNECTION ....................................................................................................................................... 38
2.10 QUEUES AND FLUSH ..................................................................................................................................... 39
2.11 MARKING BUFFERS ...................................................................................................................................... 40
2.12 EVENTS AND CALLBACKS ............................................................................................................................ 40
2.13 BUFFER PAYLOAD ........................................................................................................................................ 41
2.14 SIGNALLING FRAMES AND SUBFRAMES ........................................................................................................ 44
2.14.1 Signalling frames .................................................................................................................................... 44
2.14.2 Signalling subframes .............................................................................................................................. 45
2.15 BUFFER FLAGS AND TIMESTAMPS ................................................................................................................ 47
2.16 SYNCHRONIZATION ...................................................................................................................................... 47
2.17 RATE CONTROL ............................................................................................................................................ 48
2.18 COMPONENT REGISTRATION ........................................................................................................................ 48
2.19 RESOURCE MANAGEMENT ........................................................................................................................... 48
2.19.1 Need for Resource Management ............................................................................................................ 49
2.19.2 Example Architecture ............................................................................................................................. 50
2.19.3 Component Priorities.............................................................................................................................. 51
2.19.4 Behavioral Rules ..................................................................................................................................... 51
2.19.5 Hardware Vendor-Specific Resource Manager ..................................................................................... 52
2.19.6 Component Suspension ........................................................................................................................... 52
2.20 CONTENT PIPES ............................................................................................................................................ 53
2.21 FILE PARSING ............................................................................................................................................... 53
2.22 VIDEO DECODER ERROR MAPPING .............................................................................................................. 54
2.23 BUFFER PAYLOAD ADDITIONAL INFORMATION ........................................................................................... 54
2.23.1 Buffer Data Formatting .......................................................................................................................... 55
2.24 ENDIANNESS ................................................................................................................................................. 56
4
3 OPENMAX INTEGRATION LAYER CONTROL API ............................................................................... 57
3.1 OPENMAX IL TYPES ........................................................................................................................................ 58
3.1.1 Enumerations .......................................................................................................................................... 58
3.1.2 Data Types .............................................................................................................................................. 75
3.1.3 Structures ................................................................................................................................................ 77
3.2 OPENMAX IL CORE METHODS/MACROS ....................................................................................................... 109
3.2.1 Return Codes for the Functions ............................................................................................................ 110
3.2.2 Macros .................................................................................................................................................. 112
3.2.3 Functions ............................................................................................................................................... 141
3.3 OPENMAX IL COMPONENT METHODS AND STRUCTURES ............................................................................. 153
3.3.1 pComponentPrivate .............................................................................................................................. 155
3.3.2 pApplicationPrivate .............................................................................................................................. 155
3.3.3 GetComponentVersion .......................................................................................................................... 155
3.3.4 SendCommand ...................................................................................................................................... 155
3.3.5 GetParameter ........................................................................................................................................ 156
3.3.6 SetParameter......................................................................................................................................... 156
3.3.7 GetConfig .............................................................................................................................................. 156
3.3.8 SetConfig ............................................................................................................................................... 156
3.3.9 GetExtensionIndex ................................................................................................................................ 157
3.3.10 GetState ................................................................................................................................................. 157
3.3.11 ComponentTunnelRequest .................................................................................................................... 157
3.3.12 UseBuffer .............................................................................................................................................. 159
3.3.13 AllocateBuffer ....................................................................................................................................... 159
3.3.14 FreeBuffer ............................................................................................................................................. 159
3.3.15 EmptyThisBuffer ................................................................................................................................... 160
3.3.16 FillThisBuffer ........................................................................................................................................ 160
3.3.17 SetCallbacks .......................................................................................................................................... 160
3.3.18 ComponentDeinit .................................................................................................................................. 161
3.3.19 UseEGLImage ....................................................................................................................................... 162
3.4 CALLING SEQUENCES ...................................................................................................................................... 162
3.4.1 Initialization .......................................................................................................................................... 162
3.4.2 Data Flow ............................................................................................................................................. 171
3.4.3 De-Initialization .................................................................................................................................... 174
3.4.4 Port Disablement and Enablement....................................................................................................... 183
3.4.5 Dynamic Port Reconfiguration............................................................................................................. 187
3.4.6 Autodetect Port Reconfiguration .......................................................................................................... 189
3.4.7 Resource Management ......................................................................................................................... 191
3.4.8 Component Suspension ......................................................................................................................... 195
3.5 SLAVING BEHAVIOR FOR PORT SETTINGS ...................................................................................................... 199
4 OPENMAX IL DATA API ............................................................................................................................... 200
4.1 AUDIO .............................................................................................................................................................. 200
4.1.1 Audio Use Case Examples .................................................................................................................... 200
4.1.2 Minimum Buffer Payload Size for Uncompressed Data ...................................................................... 201
4.1.3 Whole-file Buffering for MIDI Formats ............................................................................................... 201
4.1.4 General Enumerations .......................................................................................................................... 201
4.1.5 Parameter and Configuration Indexes ................................................................................................. 204
4.1.6 OMX_AUDIO_PORTDEFINITIONTYPE ........................................................................................... 206
4.1.7 OMX_AUDIO_PARAM_PORTFORMATTYPE .................................................................................. 207
4.1.8 OMX_AUDIO_PARAM_PCMMODETYPE ........................................................................................ 208
4.1.9 OMX_AUDIO_PARAM_MP3TYPE ..................................................................................................... 210
4.1.10 OMX_AUDIO_PARAM_AACPROFILETYPE .................................................................................... 212
4.1.11 OMX_AUDIO_PARAM_VORBISTYPE ............................................................................................... 215
4.1.12 OMX_AUDIO_PARAM_WMATYPE ................................................................................................... 216
4.1.13 OMX_AUDIO_PARAM_RATYPE ........................................................................................................ 219
5
4.1.14 OMX_AUDIO_PARAM_SBCTYPE ..................................................................................................... 220
4.1.15 OMX_AUDIO_PARAM_ADPCMTYPE .............................................................................................. 221
4.1.16 OMX_AUDIO_PARAM_G723TYPE ................................................................................................... 222
4.1.17 OMX_AUDIO_PARAM_G726TYPE ................................................................................................... 223
4.1.18 OMX_AUDIO_PARAM_G729TYPE ................................................................................................... 224
4.1.19 OMX_AUDIO_PARAM_AMRTYPE .................................................................................................... 225
4.1.20 OMX_AUDIO_PARAM_GSMFRTYPE ............................................................................................... 231
4.1.21 OMX_AUDIO_PARAM_GSMEFRTYPE ............................................................................................. 232
4.1.22 OMX_AUDIO_PARAM_GSMHRTYPE ............................................................................................... 233
4.1.23 OMX_AUDIO_PARAM_TDMAFRTYPE ............................................................................................ 233
4.1.24 OMX_AUDIO_PARAM_TDMAEFRTYPE .......................................................................................... 234
4.1.25 OMX_AUDIO_PARAM_PDCFRTYPE ............................................................................................... 235
4.1.26 OMX_AUDIO_PARAM_PDCEFRTYPE ............................................................................................. 236
4.1.27 OMX_AUDIO_PARAM_PDCHRTYPE ............................................................................................... 237
4.1.28 OMX_AUDIO_PARAM_QCELP8TYPE .............................................................................................. 238
4.1.29 OMX_AUDIO_PARAM_QCELP13TYPE ............................................................................................ 239
4.1.30 OMX_AUDIO_PARAM_EVRCTYPE .................................................................................................. 240
4.1.31 OMX_AUDIO_PARAM_SMVTYPE ..................................................................................................... 242
4.1.32 OMX_AUDIO_PARAM_MIDITYPE ................................................................................................... 243
4.1.33 OMX_AUDIO_PARAM_MIDILOADUSERSOUNDTYPE ................................................................. 244
4.1.34 OMX_AUDIO_CONFIG_MIDIIMMEDIATEEVENTTYPE ............................................................... 246
4.1.35 OMX_AUDIO_CONFIG_MIDISOUNDBANKPROGRAMTYPE ....................................................... 247
4.1.36 OMX_AUDIO_CONFIG_MIDICONTROLTYPE ............................................................................... 247
4.1.37 OMX_AUDIO_CONFIG_MIDISTATUSTYPE .................................................................................... 249
4.1.38 OMX_AUDIO_CONFIG_MIDIMETAEVENTTYPE ........................................................................... 251
4.1.39 OMX_AUDIO_CONFIG_MIDIMETAEVENTDATATYPE ................................................................ 252
4.1.40 OMX_AUDIO_CONFIG_VOLUMETYPE .......................................................................................... 252
4.1.41 OMX_AUDIO_CONFIG_CHANNELVOLUMETYPE ........................................................................ 253
4.1.42 OMX_AUDIO_CONFIG_BALANCETYPE ......................................................................................... 254
4.1.43 OMX_AUDIO_CONFIG_MUTETYPE ................................................................................................ 254
4.1.44 OMX_AUDIO_CONFIG_CHANNELMUTETYPE ............................................................................. 255
4.1.45 OMX_AUDIO_CONFIG_LOUDNESSTYPE ...................................................................................... 256
4.1.46 OMX_AUDIO_CONFIG_BASSTYPE .................................................................................................. 256
4.1.47 OMX_AUDIO_CONFIG_TREBLETYPE ............................................................................................ 257
4.1.48 OMX_AUDIO_CONFIG_EQUALIZERTYPE ..................................................................................... 257
4.1.49 OMX_AUDIO_CONFIG_STEREOWIDENINGTYPE ........................................................................ 258
4.1.50 OMX_AUDIO_CONFIG_CHORUSTYPE ........................................................................................... 259
4.1.51 OMX_AUDIO_CONFIG_REVERBERATIONTYPE ........................................................................... 260
4.1.52 OMX_AUDIO_CONFIG_ECHOCANCELATIONTYPE..................................................................... 262
4.1.53 OMX_AUDIO_CONFIG_NOISEREDUCTIONTYPE ........................................................................ 263
4.1.54 OMX_AUDIO_CONFIG_3DOUTPUTTYPE ...................................................................................... 263
4.1.55 OMX_AUDIO_CONFIG_3DLOCATIONTYPE .................................................................................. 264
4.1.56 OMX_AUDIO_PARAM_3DDOPPLERMODETYPE .......................................................................... 265
4.1.57 OMX_AUDIO_CONFIG_3DDOPPLERSETTINGSTYPE .................................................................. 265
4.1.58 OMX_AUDIO_CONFIG_3DLEVELSTYPE ........................................................................................ 266
4.1.59 OMX_AUDIO_CONFIG_3DDISTANCEATTENUATIONTYPE ........................................................ 267
4.1.60 OMX_AUDIO_CONFIG_3DDIRECTIVITYSETTINGSTYPE ............................................................ 268
4.1.61 OMX_AUDIO_CONFIG_3DDIRECTIVITYORIENTATIONTYPE .................................................... 269
4.1.62 OMX_AUDIO_CONFIG_3DMACROSCOPICORIENTATIONTYPE................................................ 269
4.1.63 OMX_AUDIO_CONFIG_3DMACROSCOPICSIZETYPE ................................................................. 270
4.1.64 OMX_AUDIO_CHANNELMAPPINGTYPE ........................................................................................ 271
4.1.65 OMX_AUDIO_SBCBITPOOLTYPE .................................................................................................... 272
4.1.66 OMX_AUDIO_AMRMODETYPE ........................................................................................................ 272
4.1.67 OMX_AUDIO_CONFIG_BITRATETYPE ........................................................................................... 273
4.1.68 OMX_AUDIO_CONFIG_AMRISFTYPE ............................................................................................ 273
4.1.69 OMX_AUDIO_FIXEDPOINTTYPE .................................................................................................... 274
剩余652页未读,继续阅读
cctbdlm
- 粉丝: 0
- 资源: 21
上传资源 快速赚钱
- 我的内容管理 收起
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
会员权益专享
最新资源
- zigbee-cluster-library-specification
- JSBSim Reference Manual
- c++校园超市商品信息管理系统课程设计说明书(含源代码) (2).pdf
- 建筑供配电系统相关课件.pptx
- 企业管理规章制度及管理模式.doc
- vb打开摄像头.doc
- 云计算-可信计算中认证协议改进方案.pdf
- [详细完整版]单片机编程4.ppt
- c语言常用算法.pdf
- c++经典程序代码大全.pdf
- 单片机数字时钟资料.doc
- 11项目管理前沿1.0.pptx
- 基于ssm的“魅力”繁峙宣传网站的设计与实现论文.doc
- 智慧交通综合解决方案.pptx
- 建筑防潮设计-PowerPointPresentati.pptx
- SPC统计过程控制程序.pptx
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论1