1/* ------------------------------------------------------------------
2 * Copyright (C) 1998-2009 PacketVideo
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
13 * express or implied.
14 * See the License for the specific language governing permissions
15 * and limitations under the License.
16 * -------------------------------------------------------------------
17 */
18/**
19 * Copyright (c) 2008 The Khronos Group Inc.
20 *
21 * Permission is hereby granted, free of charge, to any person obtaining
22 * a copy of this software and associated documentation files (the
23 * "Software"), to deal in the Software without restriction, including
24 * without limitation the rights to use, copy, modify, merge, publish,
25 * distribute, sublicense, and/or sell copies of the Software, and to
26 * permit persons to whom the Software is furnished to do so, subject
27 * to the following conditions:
28 * The above copyright notice and this permission notice shall be included
29 * in all copies or substantial portions of the Software.
30 *
31 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
32 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
34 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
35 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
36 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
37 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
38 *
39 */
40
41/**
42 *  @file OMX_Video.h - OpenMax IL version 1.1.2
43 *  The structures is needed by Video components to exchange parameters
44 *  and configuration data with OMX components.
45 */
46#ifndef OMX_Video_h
47#define OMX_Video_h
48
49/** @defgroup video OpenMAX IL Video Domain
50 * @ingroup iv
51 * Structures for OpenMAX IL Video domain
52 * @{
53 */
54
55#ifdef __cplusplus
56extern "C" {
57#endif /* __cplusplus */
58
59
60/**
61 * Each OMX header must include all required header files to allow the
62 * header to compile without errors.  The includes below are required
63 * for this header file to compile successfully
64 */
65
66#include <OMX_IVCommon.h>
67
68
69/**
70 * Enumeration used to define the possible video compression codings.
71 * NOTE:  This essentially refers to file extensions. If the coding is
72 *        being used to specify the ENCODE type, then additional work
73 *        must be done to configure the exact flavor of the compression
74 *        to be used.  For decode cases where the user application can
75 *        not differentiate between MPEG-4 and H.264 bit streams, it is
76 *        up to the codec to handle this.
77 */
78typedef enum OMX_VIDEO_CODINGTYPE {
79    OMX_VIDEO_CodingUnused,     /**< Value when coding is N/A */
80    OMX_VIDEO_CodingAutoDetect, /**< Autodetection of coding type */
81    OMX_VIDEO_CodingMPEG2,      /**< AKA: H.262 */
82    OMX_VIDEO_CodingH263,       /**< H.263 */
83    OMX_VIDEO_CodingMPEG4,      /**< MPEG-4 */
84    OMX_VIDEO_CodingWMV,        /**< all versions of Windows Media Video */
85    OMX_VIDEO_CodingRV,         /**< all versions of Real Video */
86    OMX_VIDEO_CodingAVC,        /**< H.264/AVC */
87    OMX_VIDEO_CodingMJPEG,      /**< Motion JPEG */
88    OMX_VIDEO_CodingVP8,        /**< Google VP8, formerly known as On2 VP8 */
89    OMX_VIDEO_CodingVP9,        /**< Google VP9 */
90    OMX_VIDEO_CodingHEVC,       /**< ITU H.265/HEVC */
91    OMX_VIDEO_CodingKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
92    OMX_VIDEO_CodingVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
93    OMX_VIDEO_CodingMax = 0x7FFFFFFF
94} OMX_VIDEO_CODINGTYPE;
95
96
97/**
98 * Data structure used to define a video path.  The number of Video paths for
99 * input and output will vary by type of the Video component.
100 *
101 *    Input (aka Source) : zero Inputs, one Output,
102 *    Splitter           : one Input, 2 or more Outputs,
103 *    Processing Element : one Input, one output,
104 *    Mixer              : 2 or more inputs, one output,
105 *    Output (aka Sink)  : one Input, zero outputs.
106 *
107 * The PortDefinition structure is used to define all of the parameters
108 * necessary for the compliant component to setup an input or an output video
109 * path.  If additional vendor specific data is required, it should be
110 * transmitted to the component using the CustomCommand function.  Compliant
111 * components will prepopulate this structure with optimal values during the
112 * GetDefaultInitParams command.
113 *
114 * STRUCT MEMBERS:
115 *  cMIMEType             : MIME type of data for the port
116 *  pNativeRender         : Platform specific reference for a display if a
117 *                          sync, otherwise this field is 0
118 *  nFrameWidth           : Width of frame to be used on channel if
119 *                          uncompressed format is used.  Use 0 for unknown,
120 *                          don't care or variable
121 *  nFrameHeight          : Height of frame to be used on channel if
122 *                          uncompressed format is used. Use 0 for unknown,
123 *                          don't care or variable
124 *  nStride               : Number of bytes per span of an image
125 *                          (i.e. indicates the number of bytes to get
126 *                          from span N to span N+1, where negative stride
127 *                          indicates the image is bottom up
128 *  nSliceHeight          : Height used when encoding in slices
129 *  nBitrate              : Bit rate of frame to be used on channel if
130 *                          compressed format is used. Use 0 for unknown,
131 *                          don't care or variable
132 *  xFramerate            : Frame rate to be used on channel if uncompressed
133 *                          format is used. Use 0 for unknown, don't care or
134 *                          variable.  Units are Q16 frames per second.
135 *  bFlagErrorConcealment : Turns on error concealment if it is supported by
136 *                          the OMX component
137 *  eCompressionFormat    : Compression format used in this instance of the
138 *                          component. When OMX_VIDEO_CodingUnused is
139 *                          specified, eColorFormat is used
140 *  eColorFormat : Decompressed format used by this component
141 *  pNativeWindow : Platform specific reference for a window object if a
142 *                          display sink , otherwise this field is 0x0.
143 */
144typedef struct OMX_VIDEO_PORTDEFINITIONTYPE {
145    OMX_STRING cMIMEType;
146    OMX_NATIVE_DEVICETYPE pNativeRender;
147    OMX_U32 nFrameWidth;
148    OMX_U32 nFrameHeight;
149    OMX_S32 nStride;
150    OMX_U32 nSliceHeight;
151    OMX_U32 nBitrate;
152    OMX_U32 xFramerate;
153    OMX_BOOL bFlagErrorConcealment;
154    OMX_VIDEO_CODINGTYPE eCompressionFormat;
155    OMX_COLOR_FORMATTYPE eColorFormat;
156    OMX_NATIVE_WINDOWTYPE pNativeWindow;
157} OMX_VIDEO_PORTDEFINITIONTYPE;
158
159/**
160 * Port format parameter.  This structure is used to enumerate the various
161 * data input/output format supported by the port.
162 *
163 * STRUCT MEMBERS:
164 *  nSize              : Size of the structure in bytes
165 *  nVersion           : OMX specification version information
166 *  nPortIndex         : Indicates which port to set
167 *  nIndex             : Indicates the enumeration index for the format from
168 *                       0x0 to N-1
169 *  eCompressionFormat : Compression format used in this instance of the
170 *                       component. When OMX_VIDEO_CodingUnused is specified,
171 *                       eColorFormat is used
172 *  eColorFormat       : Decompressed format used by this component
173 *  xFrameRate         : Indicates the video frame rate in Q16 format
174 */
175typedef struct OMX_VIDEO_PARAM_PORTFORMATTYPE {
176    OMX_U32 nSize;
177    OMX_VERSIONTYPE nVersion;
178    OMX_U32 nPortIndex;
179    OMX_U32 nIndex;
180    OMX_VIDEO_CODINGTYPE eCompressionFormat;
181    OMX_COLOR_FORMATTYPE eColorFormat;
182    OMX_U32 xFramerate;
183} OMX_VIDEO_PARAM_PORTFORMATTYPE;
184
185
186/**
187 * This is a structure for configuring video compression quantization
188 * parameter values.  Codecs may support different QP values for different
189 * frame types.
190 *
191 * STRUCT MEMBERS:
192 *  nSize      : Size of the structure in bytes
193 *  nVersion   : OMX specification version info
194 *  nPortIndex : Port that this structure applies to
195 *  nQpI       : QP value to use for index frames
196 *  nQpP       : QP value to use for P frames
197 *  nQpB       : QP values to use for bidirectional frames
198 */
199typedef struct OMX_VIDEO_PARAM_QUANTIZATIONTYPE {
200    OMX_U32 nSize;
201    OMX_VERSIONTYPE nVersion;
202    OMX_U32 nPortIndex;
203    OMX_U32 nQpI;
204    OMX_U32 nQpP;
205    OMX_U32 nQpB;
206} OMX_VIDEO_PARAM_QUANTIZATIONTYPE;
207
208
209/**
210 * Structure for configuration of video fast update parameters.
211 *
212 * STRUCT MEMBERS:
213 *  nSize      : Size of the structure in bytes
214 *  nVersion   : OMX specification version info
215 *  nPortIndex : Port that this structure applies to
216 *  bEnableVFU : Enable/Disable video fast update
217 *  nFirstGOB  : Specifies the number of the first macroblock row
218 *  nFirstMB   : specifies the first MB relative to the specified first GOB
219 *  nNumMBs    : Specifies the number of MBs to be refreshed from nFirstGOB
220 *               and nFirstMB
221 */
222typedef struct OMX_VIDEO_PARAM_VIDEOFASTUPDATETYPE {
223    OMX_U32 nSize;
224    OMX_VERSIONTYPE nVersion;
225    OMX_U32 nPortIndex;
226    OMX_BOOL bEnableVFU;
227    OMX_U32 nFirstGOB;
228    OMX_U32 nFirstMB;
229    OMX_U32 nNumMBs;
230} OMX_VIDEO_PARAM_VIDEOFASTUPDATETYPE;
231
232
233/**
234 * Enumeration of possible bitrate control types
235 */
236typedef enum OMX_VIDEO_CONTROLRATETYPE {
237    OMX_Video_ControlRateDisable,
238    OMX_Video_ControlRateVariable,
239    OMX_Video_ControlRateConstant,
240    OMX_Video_ControlRateVariableSkipFrames,
241    OMX_Video_ControlRateConstantSkipFrames,
242    OMX_Video_ControlRateKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
243    OMX_Video_ControlRateVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
244    OMX_Video_ControlRateMax = 0x7FFFFFFF
245} OMX_VIDEO_CONTROLRATETYPE;
246
247
248/**
249 * Structure for configuring bitrate mode of a codec.
250 *
251 * STRUCT MEMBERS:
252 *  nSize          : Size of the struct in bytes
253 *  nVersion       : OMX spec version info
254 *  nPortIndex     : Port that this struct applies to
255 *  eControlRate   : Control rate type enum
256 *  nTargetBitrate : Target bitrate to encode with
257 */
258typedef struct OMX_VIDEO_PARAM_BITRATETYPE {
259    OMX_U32 nSize;
260    OMX_VERSIONTYPE nVersion;
261    OMX_U32 nPortIndex;
262    OMX_VIDEO_CONTROLRATETYPE eControlRate;
263    OMX_U32 nTargetBitrate;
264} OMX_VIDEO_PARAM_BITRATETYPE;
265
266
267/**
268 * Enumeration of possible motion vector (MV) types
269 */
270typedef enum OMX_VIDEO_MOTIONVECTORTYPE {
271    OMX_Video_MotionVectorPixel,
272    OMX_Video_MotionVectorHalfPel,
273    OMX_Video_MotionVectorQuarterPel,
274    OMX_Video_MotionVectorEighthPel,
275    OMX_Video_MotionVectorKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
276    OMX_Video_MotionVectorVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
277    OMX_Video_MotionVectorMax = 0x7FFFFFFF
278} OMX_VIDEO_MOTIONVECTORTYPE;
279
280
281/**
282 * Structure for configuring the number of motion vectors used as well
283 * as their accuracy.
284 *
285 * STRUCT MEMBERS:
286 *  nSize            : Size of the struct in bytes
287 *  nVersion         : OMX spec version info
288 *  nPortIndex       : port that this structure applies to
289 *  eAccuracy        : Enumerated MV accuracy
290 *  bUnrestrictedMVs : Allow unrestricted MVs
291 *  bFourMV          : Allow use of 4 MVs
292 *  sXSearchRange    : Search range in horizontal direction for MVs
293 *  sYSearchRange    : Search range in vertical direction for MVs
294 */
295typedef struct OMX_VIDEO_PARAM_MOTIONVECTORTYPE {
296    OMX_U32 nSize;
297    OMX_VERSIONTYPE nVersion;
298    OMX_U32 nPortIndex;
299    OMX_VIDEO_MOTIONVECTORTYPE eAccuracy;
300    OMX_BOOL bUnrestrictedMVs;
301    OMX_BOOL bFourMV;
302    OMX_S32 sXSearchRange;
303    OMX_S32 sYSearchRange;
304} OMX_VIDEO_PARAM_MOTIONVECTORTYPE;
305
306
307/**
308 * Enumeration of possible methods to use for Intra Refresh
309 */
310typedef enum OMX_VIDEO_INTRAREFRESHTYPE {
311    OMX_VIDEO_IntraRefreshCyclic,
312    OMX_VIDEO_IntraRefreshAdaptive,
313    OMX_VIDEO_IntraRefreshBoth,
314    OMX_VIDEO_IntraRefreshKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
315    OMX_VIDEO_IntraRefreshVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
316    OMX_VIDEO_IntraRefreshMax = 0x7FFFFFFF
317} OMX_VIDEO_INTRAREFRESHTYPE;
318
319
320/**
321 * Structure for configuring intra refresh mode
322 *
323 * STRUCT MEMBERS:
324 *  nSize        : Size of the structure in bytes
325 *  nVersion     : OMX specification version information
326 *  nPortIndex   : Port that this structure applies to
327 *  eRefreshMode : Cyclic, Adaptive, or Both
328 *  nAirMBs      : Number of intra macroblocks to refresh in a frame when
329 *                 AIR is enabled
330 *  nAirRef      : Number of times a motion marked macroblock has to be
331 *                 intra coded
332 *  nCirMBs      : Number of consecutive macroblocks to be coded as "intra"
333 *                 when CIR is enabled
334 */
335typedef struct OMX_VIDEO_PARAM_INTRAREFRESHTYPE {
336    OMX_U32 nSize;
337    OMX_VERSIONTYPE nVersion;
338    OMX_U32 nPortIndex;
339    OMX_VIDEO_INTRAREFRESHTYPE eRefreshMode;
340    OMX_U32 nAirMBs;
341    OMX_U32 nAirRef;
342    OMX_U32 nCirMBs;
343} OMX_VIDEO_PARAM_INTRAREFRESHTYPE;
344
345
346/**
347 * Structure for enabling various error correction methods for video
348 * compression.
349 *
350 * STRUCT MEMBERS:
351 *  nSize                   : Size of the structure in bytes
352 *  nVersion                : OMX specification version information
353 *  nPortIndex              : Port that this structure applies to
354 *  bEnableHEC              : Enable/disable header extension codes (HEC)
355 *  bEnableResync           : Enable/disable resynchronization markers
356 *  nResynchMarkerSpacing   : Resynch markers interval (in bits) to be
357 *                            applied in the stream
358 *  bEnableDataPartitioning : Enable/disable data partitioning
359 *  bEnableRVLC             : Enable/disable reversible variable length
360 *                            coding
361 */
362typedef struct OMX_VIDEO_PARAM_ERRORCORRECTIONTYPE {
363    OMX_U32 nSize;
364    OMX_VERSIONTYPE nVersion;
365    OMX_U32 nPortIndex;
366    OMX_BOOL bEnableHEC;
367    OMX_BOOL bEnableResync;
368    OMX_U32  nResynchMarkerSpacing;
369    OMX_BOOL bEnableDataPartitioning;
370    OMX_BOOL bEnableRVLC;
371} OMX_VIDEO_PARAM_ERRORCORRECTIONTYPE;
372
373
374/**
375 * Configuration of variable block-size motion compensation (VBSMC)
376 *
377 * STRUCT MEMBERS:
378 *  nSize      : Size of the structure in bytes
379 *  nVersion   : OMX specification version information
380 *  nPortIndex : Port that this structure applies to
381 *  b16x16     : Enable inter block search 16x16
382 *  b16x8      : Enable inter block search 16x8
383 *  b8x16      : Enable inter block search 8x16
384 *  b8x8       : Enable inter block search 8x8
385 *  b8x4       : Enable inter block search 8x4
386 *  b4x8       : Enable inter block search 4x8
387 *  b4x4       : Enable inter block search 4x4
388 */
389typedef struct OMX_VIDEO_PARAM_VBSMCTYPE {
390    OMX_U32 nSize;
391    OMX_VERSIONTYPE nVersion;
392    OMX_U32 nPortIndex;
393    OMX_BOOL b16x16;
394    OMX_BOOL b16x8;
395    OMX_BOOL b8x16;
396    OMX_BOOL b8x8;
397    OMX_BOOL b8x4;
398    OMX_BOOL b4x8;
399    OMX_BOOL b4x4;
400} OMX_VIDEO_PARAM_VBSMCTYPE;
401
402
403/**
404 * H.263 profile types, each profile indicates support for various
405 * performance bounds and different annexes.
406 *
407 * ENUMS:
408 *  Baseline           : Baseline Profile: H.263 (V1), no optional modes
409 *  H320 Coding        : H.320 Coding Efficiency Backward Compatibility
410 *                       Profile: H.263+ (V2), includes annexes I, J, L.4
411 *                       and T
412 *  BackwardCompatible : Backward Compatibility Profile: H.263 (V1),
413 *                       includes annex F
414 *  ISWV2              : Interactive Streaming Wireless Profile: H.263+
415 *                       (V2), includes annexes I, J, K and T
416 *  ISWV3              : Interactive Streaming Wireless Profile: H.263++
417 *                       (V3), includes profile 3 and annexes V and W.6.3.8
418 *  HighCompression    : Conversational High Compression Profile: H.263++
419 *                       (V3), includes profiles 1 & 2 and annexes D and U
420 *  Internet           : Conversational Internet Profile: H.263++ (V3),
421 *                       includes profile 5 and annex K
422 *  Interlace          : Conversational Interlace Profile: H.263++ (V3),
423 *                       includes profile 5 and annex W.6.3.11
424 *  HighLatency        : High Latency Profile: H.263++ (V3), includes
425 *                       profile 6 and annexes O.1 and P.5
426 */
427typedef enum OMX_VIDEO_H263PROFILETYPE {
428    OMX_VIDEO_H263ProfileBaseline            = 0x01,
429    OMX_VIDEO_H263ProfileH320Coding          = 0x02,
430    OMX_VIDEO_H263ProfileBackwardCompatible  = 0x04,
431    OMX_VIDEO_H263ProfileISWV2               = 0x08,
432    OMX_VIDEO_H263ProfileISWV3               = 0x10,
433    OMX_VIDEO_H263ProfileHighCompression     = 0x20,
434    OMX_VIDEO_H263ProfileInternet            = 0x40,
435    OMX_VIDEO_H263ProfileInterlace           = 0x80,
436    OMX_VIDEO_H263ProfileHighLatency         = 0x100,
437    OMX_VIDEO_H263ProfileKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
438    OMX_VIDEO_H263ProfileVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
439    OMX_VIDEO_H263ProfileMax                 = 0x7FFFFFFF
440} OMX_VIDEO_H263PROFILETYPE;
441
442
443/**
444 * H.263 level types, each level indicates support for various frame sizes,
445 * bit rates, decoder frame rates.
446 */
447typedef enum OMX_VIDEO_H263LEVELTYPE {
448    OMX_VIDEO_H263Level10  = 0x01,
449    OMX_VIDEO_H263Level20  = 0x02,
450    OMX_VIDEO_H263Level30  = 0x04,
451    OMX_VIDEO_H263Level40  = 0x08,
452    OMX_VIDEO_H263Level45  = 0x10,
453    OMX_VIDEO_H263Level50  = 0x20,
454    OMX_VIDEO_H263Level60  = 0x40,
455    OMX_VIDEO_H263Level70  = 0x80,
456    OMX_VIDEO_H263LevelKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
457    OMX_VIDEO_H263LevelVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
458    OMX_VIDEO_H263LevelMax = 0x7FFFFFFF
459} OMX_VIDEO_H263LEVELTYPE;
460
461
462/**
463 * Specifies the picture type. These values should be OR'd to signal all
464 * pictures types which are allowed.
465 *
466 * ENUMS:
467 *  Generic Picture Types:          I, P and B
468 *  H.263 Specific Picture Types:   SI and SP
469 *  H.264 Specific Picture Types:   EI and EP
470 *  MPEG-4 Specific Picture Types:  S
471 */
472typedef enum OMX_VIDEO_PICTURETYPE {
473    OMX_VIDEO_PictureTypeI   = 0x01,
474    OMX_VIDEO_PictureTypeP   = 0x02,
475    OMX_VIDEO_PictureTypeB   = 0x04,
476    OMX_VIDEO_PictureTypeSI  = 0x08,
477    OMX_VIDEO_PictureTypeSP  = 0x10,
478    OMX_VIDEO_PictureTypeEI  = 0x11,
479    OMX_VIDEO_PictureTypeEP  = 0x12,
480    OMX_VIDEO_PictureTypeS   = 0x14,
481    OMX_VIDEO_PictureTypeKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
482    OMX_VIDEO_PictureTypeVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
483    OMX_VIDEO_PictureTypeMax = 0x7FFFFFFF
484} OMX_VIDEO_PICTURETYPE;
485
486
487/**
488 * H.263 Params
489 *
490 * STRUCT MEMBERS:
491 *  nSize                    : Size of the structure in bytes
492 *  nVersion                 : OMX specification version information
493 *  nPortIndex               : Port that this structure applies to
494 *  nPFrames                 : Number of P frames between each I frame
495 *  nBFrames                 : Number of B frames between each I frame
496 *  eProfile                 : H.263 profile(s) to use
497 *  eLevel                   : H.263 level(s) to use
498 *  bPLUSPTYPEAllowed        : Indicating that it is allowed to use PLUSPTYPE
499 *                             (specified in the 1998 version of H.263) to
500 *                             indicate custom picture sizes or clock
501 *                             frequencies
502 *  nAllowedPictureTypes     : Specifies the picture types allowed in the
503 *                             bitstream
504 *  bForceRoundingTypeToZero : value of the RTYPE bit (bit 6 of MPPTYPE) is
505 *                             not constrained. It is recommended to change
506 *                             the value of the RTYPE bit for each reference
507 *                             picture in error-free communication
508 *  nPictureHeaderRepetition : Specifies the frequency of picture header
509 *                             repetition
510 *  nGOBHeaderInterval       : Specifies the interval of non-empty GOB
511 *                             headers in units of GOBs
512 */
513typedef struct OMX_VIDEO_PARAM_H263TYPE {
514    OMX_U32 nSize;
515    OMX_VERSIONTYPE nVersion;
516    OMX_U32 nPortIndex;
517    OMX_U32 nPFrames;
518    OMX_U32 nBFrames;
519    OMX_VIDEO_H263PROFILETYPE eProfile;
520    OMX_VIDEO_H263LEVELTYPE eLevel;
521    OMX_BOOL bPLUSPTYPEAllowed;
522    OMX_U32 nAllowedPictureTypes;
523    OMX_BOOL bForceRoundingTypeToZero;
524    OMX_U32 nPictureHeaderRepetition;
525    OMX_U32 nGOBHeaderInterval;
526} OMX_VIDEO_PARAM_H263TYPE;
527
528
529/**
530 * MPEG-2 profile types, each profile indicates support for various
531 * performance bounds and different annexes.
532 */
533typedef enum OMX_VIDEO_MPEG2PROFILETYPE {
534    OMX_VIDEO_MPEG2ProfileSimple = 0,  /**< Simple Profile */
535    OMX_VIDEO_MPEG2ProfileMain,        /**< Main Profile */
536    OMX_VIDEO_MPEG2Profile422,         /**< 4:2:2 Profile */
537    OMX_VIDEO_MPEG2ProfileSNR,         /**< SNR Profile */
538    OMX_VIDEO_MPEG2ProfileSpatial,     /**< Spatial Profile */
539    OMX_VIDEO_MPEG2ProfileHigh,        /**< High Profile */
540    OMX_VIDEO_MPEG2ProfileKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
541    OMX_VIDEO_MPEG2ProfileVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
542    OMX_VIDEO_MPEG2ProfileMax = 0x7FFFFFFF
543} OMX_VIDEO_MPEG2PROFILETYPE;
544
545
546/**
547 * MPEG-2 level types, each level indicates support for various frame
548 * sizes, bit rates, decoder frame rates.  No need
549 */
550typedef enum OMX_VIDEO_MPEG2LEVELTYPE {
551    OMX_VIDEO_MPEG2LevelLL = 0,  /**< Low Level */
552    OMX_VIDEO_MPEG2LevelML,      /**< Main Level */
553    OMX_VIDEO_MPEG2LevelH14,     /**< High 1440 */
554    OMX_VIDEO_MPEG2LevelHL,      /**< High Level */
555    OMX_VIDEO_MPEG2LevelKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
556    OMX_VIDEO_MPEG2LevelVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
557    OMX_VIDEO_MPEG2LevelMax = 0x7FFFFFFF
558} OMX_VIDEO_MPEG2LEVELTYPE;
559
560
561/**
562 * MPEG-2 params
563 *
564 * STRUCT MEMBERS:
565 *  nSize      : Size of the structure in bytes
566 *  nVersion   : OMX specification version information
567 *  nPortIndex : Port that this structure applies to
568 *  nPFrames   : Number of P frames between each I frame
569 *  nBFrames   : Number of B frames between each I frame
570 *  eProfile   : MPEG-2 profile(s) to use
571 *  eLevel     : MPEG-2 levels(s) to use
572 */
573typedef struct OMX_VIDEO_PARAM_MPEG2TYPE {
574    OMX_U32 nSize;
575    OMX_VERSIONTYPE nVersion;
576    OMX_U32 nPortIndex;
577    OMX_U32 nPFrames;
578    OMX_U32 nBFrames;
579    OMX_VIDEO_MPEG2PROFILETYPE eProfile;
580    OMX_VIDEO_MPEG2LEVELTYPE eLevel;
581} OMX_VIDEO_PARAM_MPEG2TYPE;
582
583
584/**
585 * MPEG-4 profile types, each profile indicates support for various
586 * performance bounds and different annexes.
587 *
588 * ENUMS:
589 *  - Simple Profile, Levels 1-3
590 *  - Simple Scalable Profile, Levels 1-2
591 *  - Core Profile, Levels 1-2
592 *  - Main Profile, Levels 2-4
593 *  - N-bit Profile, Level 2
594 *  - Scalable Texture Profile, Level 1
595 *  - Simple Face Animation Profile, Levels 1-2
596 *  - Simple Face and Body Animation (FBA) Profile, Levels 1-2
597 *  - Basic Animated Texture Profile, Levels 1-2
598 *  - Hybrid Profile, Levels 1-2
599 *  - Advanced Real Time Simple Profiles, Levels 1-4
600 *  - Core Scalable Profile, Levels 1-3
601 *  - Advanced Coding Efficiency Profile, Levels 1-4
602 *  - Advanced Core Profile, Levels 1-2
603 *  - Advanced Scalable Texture, Levels 2-3
604 */
605typedef enum OMX_VIDEO_MPEG4PROFILETYPE {
606    OMX_VIDEO_MPEG4ProfileSimple           = 0x01,
607    OMX_VIDEO_MPEG4ProfileSimpleScalable   = 0x02,
608    OMX_VIDEO_MPEG4ProfileCore             = 0x04,
609    OMX_VIDEO_MPEG4ProfileMain             = 0x08,
610    OMX_VIDEO_MPEG4ProfileNbit             = 0x10,
611    OMX_VIDEO_MPEG4ProfileScalableTexture  = 0x20,
612    OMX_VIDEO_MPEG4ProfileSimpleFace       = 0x40,
613    OMX_VIDEO_MPEG4ProfileSimpleFBA        = 0x80,
614    OMX_VIDEO_MPEG4ProfileBasicAnimated    = 0x100,
615    OMX_VIDEO_MPEG4ProfileHybrid           = 0x200,
616    OMX_VIDEO_MPEG4ProfileAdvancedRealTime = 0x400,
617    OMX_VIDEO_MPEG4ProfileCoreScalable     = 0x800,
618    OMX_VIDEO_MPEG4ProfileAdvancedCoding   = 0x1000,
619    OMX_VIDEO_MPEG4ProfileAdvancedCore     = 0x2000,
620    OMX_VIDEO_MPEG4ProfileAdvancedScalable = 0x4000,
621    OMX_VIDEO_MPEG4ProfileAdvancedSimple   = 0x8000,
622    OMX_VIDEO_MPEG4ProfileKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
623    OMX_VIDEO_MPEG4ProfileVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
624    OMX_VIDEO_MPEG4ProfileMax              = 0x7FFFFFFF
625} OMX_VIDEO_MPEG4PROFILETYPE;
626
627
628/**
629 * MPEG-4 level types, each level indicates support for various frame
630 * sizes, bit rates, decoder frame rates.  No need
631 */
632typedef enum OMX_VIDEO_MPEG4LEVELTYPE {
633    OMX_VIDEO_MPEG4Level0  = 0x01,   /**< Level 0 */
634    OMX_VIDEO_MPEG4Level0b = 0x02,   /**< Level 0b */
635    OMX_VIDEO_MPEG4Level1  = 0x04,   /**< Level 1 */
636    OMX_VIDEO_MPEG4Level2  = 0x08,   /**< Level 2 */
637    OMX_VIDEO_MPEG4Level3  = 0x10,   /**< Level 3 */
638    OMX_VIDEO_MPEG4Level4  = 0x20,   /**< Level 4 */
639    OMX_VIDEO_MPEG4Level4a = 0x40,   /**< Level 4a */
640    OMX_VIDEO_MPEG4Level5  = 0x80,   /**< Level 5 */
641    OMX_VIDEO_MPEG4LevelKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
642    OMX_VIDEO_MPEG4LevelVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
643    OMX_VIDEO_MPEG4LevelMax = 0x7FFFFFFF
644} OMX_VIDEO_MPEG4LEVELTYPE;
645
646
647/**
648 * MPEG-4 configuration.  This structure handles configuration options
649 * which are specific to MPEG4 algorithms
650 *
651 * STRUCT MEMBERS:
652 *  nSize                : Size of the structure in bytes
653 *  nVersion             : OMX specification version information
654 *  nPortIndex           : Port that this structure applies to
655 *  nSliceHeaderSpacing  : Number of macroblocks between slice header (H263+
656 *                         Annex K). Put zero if not used
657 *  bSVH                 : Enable Short Video Header mode
658 *  bGov                 : Flag to enable GOV
659 *  nPFrames             : Number of P frames between each I frame (also called
660 *                         GOV period)
661 *  nBFrames             : Number of B frames between each I frame
662 *  nIDCVLCThreshold     : Value of intra DC VLC threshold
663 *  bACPred              : Flag to use ac prediction
664 *  nMaxPacketSize       : Maximum size of packet in bytes.
665 *  nTimeIncRes          : Used to pass VOP time increment resolution for MPEG4.
666 *                         Interpreted as described in MPEG4 standard.
667 *  eProfile             : MPEG-4 profile(s) to use.
668 *  eLevel               : MPEG-4 level(s) to use.
669 *  nAllowedPictureTypes : Specifies the picture types allowed in the bitstream
670 *  nHeaderExtension     : Specifies the number of consecutive video packet
671 *                         headers within a VOP
672 *  bReversibleVLC       : Specifies whether reversible variable length coding
673 *                         is in use
674 */
675typedef struct OMX_VIDEO_PARAM_MPEG4TYPE {
676    OMX_U32 nSize;
677    OMX_VERSIONTYPE nVersion;
678    OMX_U32 nPortIndex;
679    OMX_U32 nSliceHeaderSpacing;
680    OMX_BOOL bSVH;
681    OMX_BOOL bGov;
682    OMX_U32 nPFrames;
683    OMX_U32 nBFrames;
684    OMX_U32 nIDCVLCThreshold;
685    OMX_BOOL bACPred;
686    OMX_U32 nMaxPacketSize;
687    OMX_U32 nTimeIncRes;
688    OMX_VIDEO_MPEG4PROFILETYPE eProfile;
689    OMX_VIDEO_MPEG4LEVELTYPE eLevel;
690    OMX_U32 nAllowedPictureTypes;
691    OMX_U32 nHeaderExtension;
692    OMX_BOOL bReversibleVLC;
693} OMX_VIDEO_PARAM_MPEG4TYPE;
694
695
696/**
697 * WMV Versions
698 */
699typedef enum OMX_VIDEO_WMVFORMATTYPE {
700    OMX_VIDEO_WMVFormatUnused = 0x01,   /**< Format unused or unknown */
701    OMX_VIDEO_WMVFormat7      = 0x02,   /**< Windows Media Video format 7 */
702    OMX_VIDEO_WMVFormat8      = 0x04,   /**< Windows Media Video format 8 */
703    OMX_VIDEO_WMVFormat9      = 0x08,   /**< Windows Media Video format 9 */
704    OMX_VIDEO_WMFFormatKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
705    OMX_VIDEO_WMFFormatVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
706    OMX_VIDEO_WMVFormatMax    = 0x7FFFFFFF
707} OMX_VIDEO_WMVFORMATTYPE;
708
709
710/**
711 * WMV Params
712 *
713 * STRUCT MEMBERS:
714 *  nSize      : Size of the structure in bytes
715 *  nVersion   : OMX specification version information
716 *  nPortIndex : Port that this structure applies to
717 *  eFormat    : Version of WMV stream / data
718 */
719typedef struct OMX_VIDEO_PARAM_WMVTYPE {
720    OMX_U32 nSize;
721    OMX_VERSIONTYPE nVersion;
722    OMX_U32 nPortIndex;
723    OMX_VIDEO_WMVFORMATTYPE eFormat;
724} OMX_VIDEO_PARAM_WMVTYPE;
725
726
727/**
728 * Real Video Version
729 */
730typedef enum OMX_VIDEO_RVFORMATTYPE {
731    OMX_VIDEO_RVFormatUnused = 0, /**< Format unused or unknown */
732    OMX_VIDEO_RVFormat8,          /**< Real Video format 8 */
733    OMX_VIDEO_RVFormat9,          /**< Real Video format 9 */
734    OMX_VIDEO_RVFormatG2,         /**< Real Video Format G2 */
735    OMX_VIDEO_RVFormatKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
736    OMX_VIDEO_RVFormatVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
737    OMX_VIDEO_RVFormatMax = 0x7FFFFFFF
738} OMX_VIDEO_RVFORMATTYPE;
739
740
741/**
742 * Real Video Params
743 *
744 * STUCT MEMBERS:
745 *  nSize              : Size of the structure in bytes
746 *  nVersion           : OMX specification version information
747 *  nPortIndex         : Port that this structure applies to
748 *  eFormat            : Version of RV stream / data
749 *  nBitsPerPixel      : Bits per pixel coded in the frame
750 *  nPaddedWidth       : Padded width in pixel of a video frame
751 *  nPaddedHeight      : Padded Height in pixels of a video frame
752 *  nFrameRate         : Rate of video in frames per second
753 *  nBitstreamFlags    : Flags which internal information about the bitstream
754 *  nBitstreamVersion  : Bitstream version
755 *  nMaxEncodeFrameSize: Max encoded frame size
756 *  bEnablePostFilter  : Turn on/off post filter
757 *  bEnableTemporalInterpolation : Turn on/off temporal interpolation
758 *  bEnableLatencyMode : When enabled, the decoder does not display a decoded
759 *                       frame until it has detected that no enhancement layer
760 *                       frames or dependent B frames will be coming. This
761 *                       detection usually occurs when a subsequent non-B
762 *                       frame is encountered
763 */
764typedef struct OMX_VIDEO_PARAM_RVTYPE {
765    OMX_U32 nSize;
766    OMX_VERSIONTYPE nVersion;
767    OMX_U32 nPortIndex;
768    OMX_VIDEO_RVFORMATTYPE eFormat;
769    OMX_U16 nBitsPerPixel;
770    OMX_U16 nPaddedWidth;
771    OMX_U16 nPaddedHeight;
772    OMX_U32 nFrameRate;
773    OMX_U32 nBitstreamFlags;
774    OMX_U32 nBitstreamVersion;
775    OMX_U32 nMaxEncodeFrameSize;
776    OMX_BOOL bEnablePostFilter;
777    OMX_BOOL bEnableTemporalInterpolation;
778    OMX_BOOL bEnableLatencyMode;
779} OMX_VIDEO_PARAM_RVTYPE;
780
781
782/**
783 * AVC profile types, each profile indicates support for various
784 * performance bounds and different annexes.
785 */
786typedef enum OMX_VIDEO_AVCPROFILETYPE {
787    OMX_VIDEO_AVCProfileBaseline = 0x01,   /**< Baseline profile */
788    OMX_VIDEO_AVCProfileMain     = 0x02,   /**< Main profile */
789    OMX_VIDEO_AVCProfileExtended = 0x04,   /**< Extended profile */
790    OMX_VIDEO_AVCProfileHigh     = 0x08,   /**< High profile */
791    OMX_VIDEO_AVCProfileHigh10   = 0x10,   /**< High 10 profile */
792    OMX_VIDEO_AVCProfileHigh422  = 0x20,   /**< High 4:2:2 profile */
793    OMX_VIDEO_AVCProfileHigh444  = 0x40,   /**< High 4:4:4 profile */
794    OMX_VIDEO_AVCProfileKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
795    OMX_VIDEO_AVCProfileVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
796    OMX_VIDEO_AVCProfileMax      = 0x7FFFFFFF
797} OMX_VIDEO_AVCPROFILETYPE;
798
799
800/**
801 * AVC level types, each level indicates support for various frame sizes,
802 * bit rates, decoder frame rates.  No need
803 */
804typedef enum OMX_VIDEO_AVCLEVELTYPE {
805    OMX_VIDEO_AVCLevel1   = 0x01,     /**< Level 1 */
806    OMX_VIDEO_AVCLevel1b  = 0x02,     /**< Level 1b */
807    OMX_VIDEO_AVCLevel11  = 0x04,     /**< Level 1.1 */
808    OMX_VIDEO_AVCLevel12  = 0x08,     /**< Level 1.2 */
809    OMX_VIDEO_AVCLevel13  = 0x10,     /**< Level 1.3 */
810    OMX_VIDEO_AVCLevel2   = 0x20,     /**< Level 2 */
811    OMX_VIDEO_AVCLevel21  = 0x40,     /**< Level 2.1 */
812    OMX_VIDEO_AVCLevel22  = 0x80,     /**< Level 2.2 */
813    OMX_VIDEO_AVCLevel3   = 0x100,    /**< Level 3 */
814    OMX_VIDEO_AVCLevel31  = 0x200,    /**< Level 3.1 */
815    OMX_VIDEO_AVCLevel32  = 0x400,    /**< Level 3.2 */
816    OMX_VIDEO_AVCLevel4   = 0x800,    /**< Level 4 */
817    OMX_VIDEO_AVCLevel41  = 0x1000,   /**< Level 4.1 */
818    OMX_VIDEO_AVCLevel42  = 0x2000,   /**< Level 4.2 */
819    OMX_VIDEO_AVCLevel5   = 0x4000,   /**< Level 5 */
820    OMX_VIDEO_AVCLevel51  = 0x8000,   /**< Level 5.1 */
821    OMX_VIDEO_AVCLevel52  = 0x10000,  /**< Level 5.2 */
822    OMX_VIDEO_AVCLevelKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
823    OMX_VIDEO_AVCLevelVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
824    OMX_VIDEO_AVCLevelMax = 0x7FFFFFFF
825} OMX_VIDEO_AVCLEVELTYPE;
826
827
828/**
829 * AVC loop filter modes
830 *
831 * OMX_VIDEO_AVCLoopFilterEnable               : Enable
832 * OMX_VIDEO_AVCLoopFilterDisable              : Disable
833 * OMX_VIDEO_AVCLoopFilterDisableSliceBoundary : Disabled on slice boundaries
834 */
835typedef enum OMX_VIDEO_AVCLOOPFILTERTYPE {
836    OMX_VIDEO_AVCLoopFilterEnable = 0,
837    OMX_VIDEO_AVCLoopFilterDisable,
838    OMX_VIDEO_AVCLoopFilterDisableSliceBoundary,
839    OMX_VIDEO_AVCLoopFilterKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
840    OMX_VIDEO_AVCLoopFilterVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
841    OMX_VIDEO_AVCLoopFilterMax = 0x7FFFFFFF
842} OMX_VIDEO_AVCLOOPFILTERTYPE;
843
844
845/**
846 * AVC params
847 *
848 * STRUCT MEMBERS:
849 *  nSize                     : Size of the structure in bytes
850 *  nVersion                  : OMX specification version information
851 *  nPortIndex                : Port that this structure applies to
852 *  nSliceHeaderSpacing       : Number of macroblocks between slice header, put
853 *                              zero if not used
854 *  nPFrames                  : Number of P frames between each I frame
855 *  nBFrames                  : Number of B frames between each I frame
856 *  bUseHadamard              : Enable/disable Hadamard transform
857 *  nRefFrames                : Max number of reference frames to use for inter
858 *                              motion search (1-16)
859 *  nRefIdxTrailing           : Pic param set ref frame index (index into ref
860 *                              frame buffer of trailing frames list), B frame
861 *                              support
862 *  nRefIdxForward            : Pic param set ref frame index (index into ref
863 *                              frame buffer of forward frames list), B frame
864 *                              support
865 *  bEnableUEP                : Enable/disable unequal error protection. This
866 *                              is only valid of data partitioning is enabled.
867 *  bEnableFMO                : Enable/disable flexible macroblock ordering
868 *  bEnableASO                : Enable/disable arbitrary slice ordering
869 *  bEnableRS                 : Enable/disable sending of redundant slices
870 *  eProfile                  : AVC profile(s) to use
871 *  eLevel                    : AVC level(s) to use
872 *  nAllowedPictureTypes      : Specifies the picture types allowed in the
873 *                              bitstream
874 *  bFrameMBsOnly             : specifies that every coded picture of the
875 *                              coded video sequence is a coded frame
876 *                              containing only frame macroblocks
877 *  bMBAFF                    : Enable/disable switching between frame and
878 *                              field macroblocks within a picture
879 *  bEntropyCodingCABAC       : Entropy decoding method to be applied for the
880 *                              syntax elements for which two descriptors appear
881 *                              in the syntax tables
882 *  bWeightedPPrediction      : Enable/disable weighted prediction shall not
883 *                              be applied to P and SP slices
884 *  nWeightedBipredicitonMode : Default weighted prediction is applied to B
885 *                              slices
886 *  bconstIpred               : Enable/disable intra prediction
887 *  bDirect8x8Inference       : Specifies the method used in the derivation
888 *                              process for luma motion vectors for B_Skip,
889 *                              B_Direct_16x16 and B_Direct_8x8 as specified
890 *                              in subclause 8.4.1.2 of the AVC spec
891 *  bDirectSpatialTemporal    : Flag indicating spatial or temporal direct
892 *                              mode used in B slice coding (related to
893 *                              bDirect8x8Inference) . Spatial direct mode is
894 *                              more common and should be the default.
895 *  nCabacInitIdx             : Index used to init CABAC contexts
896 *  eLoopFilterMode           : Enable/disable loop filter
897 */
898typedef struct OMX_VIDEO_PARAM_AVCTYPE {
899    OMX_U32 nSize;
900    OMX_VERSIONTYPE nVersion;
901    OMX_U32 nPortIndex;
902    OMX_U32 nSliceHeaderSpacing;
903    OMX_U32 nPFrames;
904    OMX_U32 nBFrames;
905    OMX_BOOL bUseHadamard;
906    OMX_U32 nRefFrames;
907    OMX_U32 nRefIdx10ActiveMinus1;
908    OMX_U32 nRefIdx11ActiveMinus1;
909    OMX_BOOL bEnableUEP;
910    OMX_BOOL bEnableFMO;
911    OMX_BOOL bEnableASO;
912    OMX_BOOL bEnableRS;
913    OMX_VIDEO_AVCPROFILETYPE eProfile;
914    OMX_VIDEO_AVCLEVELTYPE eLevel;
915    OMX_U32 nAllowedPictureTypes;
916    OMX_BOOL bFrameMBsOnly;
917    OMX_BOOL bMBAFF;
918    OMX_BOOL bEntropyCodingCABAC;
919    OMX_BOOL bWeightedPPrediction;
920    OMX_U32 nWeightedBipredicitonMode;
921    OMX_BOOL bconstIpred ;
922    OMX_BOOL bDirect8x8Inference;
923    OMX_BOOL bDirectSpatialTemporal;
924    OMX_U32 nCabacInitIdc;
925    OMX_VIDEO_AVCLOOPFILTERTYPE eLoopFilterMode;
926} OMX_VIDEO_PARAM_AVCTYPE;
927
928typedef struct OMX_VIDEO_PARAM_PROFILELEVELTYPE {
929   OMX_U32 nSize;
930   OMX_VERSIONTYPE nVersion;
931   OMX_U32 nPortIndex;
932   OMX_U32 eProfile;      /**< type is OMX_VIDEO_AVCPROFILETYPE, OMX_VIDEO_H263PROFILETYPE,
933                                 or OMX_VIDEO_MPEG4PROFILETYPE depending on context */
934   OMX_U32 eLevel;        /**< type is OMX_VIDEO_AVCLEVELTYPE, OMX_VIDEO_H263LEVELTYPE,
935                                 or OMX_VIDEO_MPEG4PROFILETYPE depending on context */
936   OMX_U32 nProfileIndex; /**< Used to query for individual profile support information,
937                               This parameter is valid only for
938                               OMX_IndexParamVideoProfileLevelQuerySupported index,
939                               For all other indices this parameter is to be ignored. */
940} OMX_VIDEO_PARAM_PROFILELEVELTYPE;
941
942/**
943 * Structure for dynamically configuring bitrate mode of a codec.
944 *
945 * STRUCT MEMBERS:
946 *  nSize          : Size of the struct in bytes
947 *  nVersion       : OMX spec version info
948 *  nPortIndex     : Port that this struct applies to
949 *  nEncodeBitrate : Target average bitrate to be generated in bps
950 */
951typedef struct OMX_VIDEO_CONFIG_BITRATETYPE {
952    OMX_U32 nSize;
953    OMX_VERSIONTYPE nVersion;
954    OMX_U32 nPortIndex;
955    OMX_U32 nEncodeBitrate;
956} OMX_VIDEO_CONFIG_BITRATETYPE;
957
958/**
959 * Defines Encoder Frame Rate setting
960 *
961 * STRUCT MEMBERS:
962 *  nSize            : Size of the structure in bytes
963 *  nVersion         : OMX specification version information
964 *  nPortIndex       : Port that this structure applies to
965 *  xEncodeFramerate : Encoding framerate represented in Q16 format
966 */
967typedef struct OMX_CONFIG_FRAMERATETYPE {
968    OMX_U32 nSize;
969    OMX_VERSIONTYPE nVersion;
970    OMX_U32 nPortIndex;
971    OMX_U32 xEncodeFramerate; /* Q16 format */
972} OMX_CONFIG_FRAMERATETYPE;
973
974typedef struct OMX_CONFIG_INTRAREFRESHVOPTYPE {
975    OMX_U32 nSize;
976    OMX_VERSIONTYPE nVersion;
977    OMX_U32 nPortIndex;
978    OMX_BOOL IntraRefreshVOP;
979} OMX_CONFIG_INTRAREFRESHVOPTYPE;
980
981typedef struct OMX_CONFIG_MACROBLOCKERRORMAPTYPE {
982    OMX_U32 nSize;
983    OMX_VERSIONTYPE nVersion;
984    OMX_U32 nPortIndex;
985    OMX_U32 nErrMapSize;           /* Size of the Error Map in bytes */
986    OMX_U8  ErrMap[1];             /* Error map hint */
987} OMX_CONFIG_MACROBLOCKERRORMAPTYPE;
988
989typedef struct OMX_CONFIG_MBERRORREPORTINGTYPE {
990    OMX_U32 nSize;
991    OMX_VERSIONTYPE nVersion;
992    OMX_U32 nPortIndex;
993    OMX_BOOL bEnabled;
994} OMX_CONFIG_MBERRORREPORTINGTYPE;
995
996typedef struct OMX_PARAM_MACROBLOCKSTYPE {
997    OMX_U32 nSize;
998    OMX_VERSIONTYPE nVersion;
999    OMX_U32 nPortIndex;
1000    OMX_U32 nMacroblocks;
1001} OMX_PARAM_MACROBLOCKSTYPE;
1002
1003/**
1004 * AVC Slice Mode modes
1005 *
1006 * OMX_VIDEO_SLICEMODE_AVCDefault   : Normal frame encoding, one slice per frame
1007 * OMX_VIDEO_SLICEMODE_AVCMBSlice   : NAL mode, number of MBs per frame
1008 * OMX_VIDEO_SLICEMODE_AVCByteSlice : NAL mode, number of bytes per frame
1009 */
1010typedef enum OMX_VIDEO_AVCSLICEMODETYPE {
1011    OMX_VIDEO_SLICEMODE_AVCDefault = 0,
1012    OMX_VIDEO_SLICEMODE_AVCMBSlice,
1013    OMX_VIDEO_SLICEMODE_AVCByteSlice,
1014    OMX_VIDEO_SLICEMODE_AVCKhronosExtensions = 0x6F000000, /**< Reserved region for introducing Khronos Standard Extensions */
1015    OMX_VIDEO_SLICEMODE_AVCVendorStartUnused = 0x7F000000, /**< Reserved region for introducing Vendor Extensions */
1016    OMX_VIDEO_SLICEMODE_AVCLevelMax = 0x7FFFFFFF
1017} OMX_VIDEO_AVCSLICEMODETYPE;
1018
1019/**
1020 * AVC FMO Slice Mode Params
1021 *
1022 * STRUCT MEMBERS:
1023 *  nSize      : Size of the structure in bytes
1024 *  nVersion   : OMX specification version information
1025 *  nPortIndex : Port that this structure applies to
1026 *  nNumSliceGroups : Specifies the number of slice groups
1027 *  nSliceGroupMapType : Specifies the type of slice groups
1028 *  eSliceMode : Specifies the type of slice
1029 */
1030typedef struct OMX_VIDEO_PARAM_AVCSLICEFMO {
1031    OMX_U32 nSize;
1032    OMX_VERSIONTYPE nVersion;
1033    OMX_U32 nPortIndex;
1034    OMX_U8 nNumSliceGroups;
1035    OMX_U8 nSliceGroupMapType;
1036    OMX_VIDEO_AVCSLICEMODETYPE eSliceMode;
1037} OMX_VIDEO_PARAM_AVCSLICEFMO;
1038
1039/**
1040 * AVC IDR Period Configs
1041 *
1042 * STRUCT MEMBERS:
1043 *  nSize      : Size of the structure in bytes
1044 *  nVersion   : OMX specification version information
1045 *  nPortIndex : Port that this structure applies to
1046 *  nIDRPeriod : Specifies periodicity of IDR frames
1047 *  nPFrames : Specifies internal of coding Intra frames
1048 */
1049typedef struct OMX_VIDEO_CONFIG_AVCINTRAPERIOD {
1050    OMX_U32 nSize;
1051    OMX_VERSIONTYPE nVersion;
1052    OMX_U32 nPortIndex;
1053    OMX_U32 nIDRPeriod;
1054    OMX_U32 nPFrames;
1055} OMX_VIDEO_CONFIG_AVCINTRAPERIOD;
1056
1057/**
1058 * AVC NAL Size Configs
1059 *
1060 * STRUCT MEMBERS:
1061 *  nSize      : Size of the structure in bytes
1062 *  nVersion   : OMX specification version information
1063 *  nPortIndex : Port that this structure applies to
1064 *  nNaluBytes : Specifies the NAL unit size
1065 */
1066typedef struct OMX_VIDEO_CONFIG_NALSIZE {
1067    OMX_U32 nSize;
1068    OMX_VERSIONTYPE nVersion;
1069    OMX_U32 nPortIndex;
1070    OMX_U32 nNaluBytes;
1071} OMX_VIDEO_CONFIG_NALSIZE;
1072
1073/** @} */
1074
1075#ifdef __cplusplus
1076}
1077#endif /* __cplusplus */
1078
1079#endif
1080/* File EOF */
1081
1082