1 /*
2  * Copyright (c) 2010 The Khronos Group Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining
5  * a copy of this software and associated documentation files (the
6  * "Software"), to deal in the Software without restriction, including
7  * without limitation the rights to use, copy, modify, merge, publish,
8  * distribute, sublicense, and/or sell copies of the Software, and to
9  * permit persons to whom the Software is furnished to do so, subject
10  * to the following conditions:
11  * The above copyright notice and this permission notice shall be included
12  * in all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
18  * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
19  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
20  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21  *
22  */
23 
24 /** @file OMX_IndexExt.h - OpenMax IL version 1.1.2
25  * The OMX_IndexExt header file contains extensions to the definitions
26  * for both applications and components .
27  */
28 
29 #ifndef OMX_IndexExt_h
30 #define OMX_IndexExt_h
31 
32 #ifdef __cplusplus
33 extern "C" {
34 #endif /* __cplusplus */
35 
36 /* Each OMX header shall include all required header files to allow the
37  * header to compile without errors.  The includes below are required
38  * for this header file to compile successfully
39  */
40 #include <OMX_Index.h>
41 
42 
43 /** Khronos standard extension indices.
44 
45 This enum lists the current Khronos extension indices to OpenMAX IL.
46 */
47 typedef enum OMX_INDEXEXTTYPE {
48 
49     /* Component parameters and configurations */
50     OMX_IndexExtComponentStartUnused = OMX_IndexKhronosExtensions + 0x00100000,
51     OMX_IndexConfigCallbackRequest,  /**< reference: OMX_CONFIG_CALLBACKREQUESTTYPE */
52     OMX_IndexConfigCommitMode,                      /**< reference: OMX_CONFIG_COMMITMODETYPE */
53     OMX_IndexConfigCommit,                          /**< reference: OMX_CONFIG_COMMITTYPE */
54     OMX_IndexConfigAndroidVendorExtension,          /**< reference: OMX_CONFIG_VENDOR_EXTENSIONTYPE */
55 
56     /* Port parameters and configurations */
57     OMX_IndexExtPortStartUnused = OMX_IndexKhronosExtensions + 0x00200000,
58 
59     /* Audio parameters and configurations */
60     OMX_IndexExtAudioStartUnused = OMX_IndexKhronosExtensions + 0x00400000,
61 
62     /* Image parameters and configurations */
63     OMX_IndexExtImageStartUnused = OMX_IndexKhronosExtensions + 0x00500000,
64 
65     /* Video parameters and configurations */
66     OMX_IndexExtVideoStartUnused = OMX_IndexKhronosExtensions + 0x00600000,
67     OMX_IndexParamNalStreamFormatSupported,         /**< reference: OMX_NALSTREAMFORMATTYPE */
68     OMX_IndexParamNalStreamFormat,                  /**< reference: OMX_NALSTREAMFORMATTYPE */
69     OMX_IndexParamNalStreamFormatSelect,            /**< reference: OMX_NALSTREAMFORMATTYPE */
70     OMX_IndexParamVideoVp8,                         /**< reference: OMX_VIDEO_PARAM_VP8TYPE */
71     OMX_IndexConfigVideoVp8ReferenceFrame,          /**< reference: OMX_VIDEO_VP8REFERENCEFRAMETYPE */
72     OMX_IndexConfigVideoVp8ReferenceFrameType,      /**< reference: OMX_VIDEO_VP8REFERENCEFRAMEINFOTYPE */
73     OMX_IndexParamVideoReserved,                    /**< Reserved for future index */
74     OMX_IndexParamVideoHevc,                        /**< reference: OMX_VIDEO_PARAM_HEVCTYPE */
75     OMX_IndexParamSliceSegments,                    /**< reference: OMX_VIDEO_SLICESEGMENTSTYPE */
76     OMX_IndexConfigAndroidIntraRefresh,             /**< reference: OMX_VIDEO_CONFIG_ANDROID_INTRAREFRESHTYPE */
77     OMX_IndexParamAndroidVideoTemporalLayering,     /**< reference: OMX_VIDEO_PARAM_ANDROID_TEMPORALLAYERINGTYPE */
78     OMX_IndexConfigAndroidVideoTemporalLayering,    /**< reference: OMX_VIDEO_CONFIG_ANDROID_TEMPORALLAYERINGTYPE */
79 
80     /* Image & Video common configurations */
81     OMX_IndexExtCommonStartUnused = OMX_IndexKhronosExtensions + 0x00700000,
82 
83     /* Other configurations */
84     OMX_IndexExtOtherStartUnused = OMX_IndexKhronosExtensions + 0x00800000,
85     OMX_IndexConfigAutoFramerateConversion,         /**< reference: OMX_CONFIG_BOOLEANTYPE */
86     OMX_IndexConfigPriority,                        /**< reference: OMX_PARAM_U32TYPE */
87     OMX_IndexConfigOperatingRate,                   /**< reference: OMX_PARAM_U32TYPE in Q16 format for video and in Hz for audio */
88 
89     /* Time configurations */
90     OMX_IndexExtTimeStartUnused = OMX_IndexKhronosExtensions + 0x00900000,
91 
92     OMX_IndexExtMax = 0x7FFFFFFF
93 } OMX_INDEXEXTTYPE;
94 #define OMX_MAX_STRINGVALUE_SIZE OMX_MAX_STRINGNAME_SIZE
95 #define OMX_MAX_ANDROID_VENDOR_PARAMCOUNT 32
96 
97 typedef enum OMX_ANDROID_VENDOR_VALUETYPE {
98     OMX_AndroidVendorValueInt32 = 0,   /*<< int32_t value */
99     OMX_AndroidVendorValueInt64,       /*<< int64_t value */
100     OMX_AndroidVendorValueString,      /*<< string value */
101     OMX_AndroidVendorValueEndUnused,
102 } OMX_ANDROID_VENDOR_VALUETYPE;
103 
104 /**
105  *
106  *  cKey        : parameter value name.
107  *  eValueType  : parameter value type
108  *  bSet        : if false, the parameter is not set (for OMX_GetConfig) or is unset (OMX_SetConfig)
109  *                if true, the parameter is set to the corresponding value below
110  *  nInt32      : int32 value
111  *  nInt64      : int64 value
112  *  cString     : string value
113  */
114 typedef struct OMX_CONFIG_ANDROID_VENDOR_PARAMTYPE {
115     OMX_U8 cKey[OMX_MAX_STRINGNAME_SIZE];
116     OMX_ANDROID_VENDOR_VALUETYPE eValueType;
117     OMX_BOOL bSet;
118     union {
119         OMX_S32 nInt32;
120         OMX_S64 nInt64;
121         OMX_U8 cString[OMX_MAX_STRINGVALUE_SIZE];
122     };
123 } OMX_CONFIG_ANDROID_VENDOR_PARAMTYPE;
124 
125 /**
126  *  nSize       : size of the structure in bytes
127  *  nVersion    : OMX specification version information
128  *  cName       : name of vendor extension
129  *  nParamCount : the number of parameter values that are part of this vendor extension
130  *  nParamSizeUsed : the size of nParam
131  *                (must be at least 1 and at most OMX_MAX_ANDROID_VENDOR_PARAMCOUNT)
132  *  nParam      : the parameter values
133  */
134 typedef struct OMX_CONFIG_ANDROID_VENDOR_EXTENSIONTYPE {
135     OMX_U32 nSize;
136     OMX_VERSIONTYPE nVersion;
137     OMX_U32 nIndex;
138     OMX_U8  cName[OMX_MAX_STRINGNAME_SIZE];
139     OMX_DIRTYPE eDir;
140     OMX_U32 nParamCount;
141     OMX_U32 nParamSizeUsed;
142     OMX_CONFIG_ANDROID_VENDOR_PARAMTYPE nParam[1];
143 } OMX_CONFIG_ANDROID_VENDOR_EXTENSIONTYPE;
144 
145 
146 #ifdef __cplusplus
147 }
148 #endif /* __cplusplus */
149 
150 #endif /* OMX_IndexExt_h */
151 /* File EOF */
152