233 lines
12 KiB
C
233 lines
12 KiB
C
|
/*
|
||
|
|
* Copyright (c) 2010 The Khronos Group Inc.
|
||
|
|
*
|
||
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
||
|
|
* a copy of this software and associated documentation files (the
|
||
|
|
* "Software"), to deal in the Software without restriction, including
|
||
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
||
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
||
|
|
* permit persons to whom the Software is furnished to do so, subject
|
||
|
|
* to the following conditions:
|
||
|
|
* The above copyright notice and this permission notice shall be included
|
||
|
|
* in all copies or substantial portions of the Software.
|
||
|
|
*
|
||
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
||
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||
|
|
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||
|
|
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||
|
|
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
||
|
|
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
/** @file OMX_IndexExt.h - OpenMax IL version 1.1.2
|
||
|
|
* The OMX_IndexExt header file contains extensions to the definitions
|
||
|
|
* for both applications and components .
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef OMX_IndexExt_h
|
||
|
|
#define OMX_IndexExt_h
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif /* __cplusplus */
|
||
|
|
|
||
|
|
/* Each OMX header shall include all required header files to allow the
|
||
|
|
* header to compile without errors. The includes below are required
|
||
|
|
* for this header file to compile successfully
|
||
|
|
*/
|
||
|
|
#include <OMX_Index.h>
|
||
|
|
|
||
|
|
|
||
|
|
/** Khronos standard extension indices.
|
||
|
|
|
||
|
|
This enum lists the current Khronos extension indices to OpenMAX IL.
|
||
|
|
*/
|
||
|
|
typedef enum OMX_INDEXEXTTYPE {
|
||
|
|
|
||
|
|
/* Component parameters and configurations */
|
||
|
|
OMX_IndexExtComponentStartUnused = OMX_IndexKhronosExtensions + 0x00100000,
|
||
|
|
OMX_IndexConfigCallbackRequest, /**< reference: OMX_CONFIG_CALLBACKREQUESTTYPE */
|
||
|
|
OMX_IndexConfigCommitMode, /**< reference: OMX_CONFIG_COMMITMODETYPE */
|
||
|
|
OMX_IndexConfigCommit, /**< reference: OMX_CONFIG_COMMITTYPE */
|
||
|
|
OMX_IndexConfigAndroidVendorExtension, /**< reference: OMX_CONFIG_VENDOR_EXTENSIONTYPE */
|
||
|
|
|
||
|
|
/* Port parameters and configurations */
|
||
|
|
OMX_IndexExtPortStartUnused = OMX_IndexKhronosExtensions + 0x00200000,
|
||
|
|
|
||
|
|
/* Audio parameters and configurations */
|
||
|
|
OMX_IndexExtAudioStartUnused = OMX_IndexKhronosExtensions + 0x00400000,
|
||
|
|
OMX_IndexParamAudioAndroidAc3, /**< reference: OMX_AUDIO_PARAM_ANDROID_AC3TYPE */
|
||
|
|
OMX_IndexParamAudioAndroidOpus, /**< reference: OMX_AUDIO_PARAM_ANDROID_OPUSTYPE */
|
||
|
|
OMX_IndexParamAudioAndroidAacPresentation, /**< reference: OMX_AUDIO_PARAM_ANDROID_AACPRESENTATIONTYPE */
|
||
|
|
OMX_IndexParamAudioAndroidEac3, /**< reference: OMX_AUDIO_PARAM_ANDROID_EAC3TYPE */
|
||
|
|
OMX_IndexParamAudioProfileQuerySupported, /**< reference: OMX_AUDIO_PARAM_ANDROID_PROFILETYPE */
|
||
|
|
OMX_IndexParamAudioAndroidAacDrcPresentation, /**< reference: OMX_AUDIO_PARAM_ANDROID_AACDRCPRESENTATIONTYPE */
|
||
|
|
OMX_IndexParamAudioAndroidAc4, /**< reference: OMX_AUDIO_PARAM_ANDROID_AC4TYPE */
|
||
|
|
OMX_IndexConfigAudioPresentation, /**< reference: OMX_AUDIO_CONFIG_ANDROID_AUDIOPRESENTATION */
|
||
|
|
OMX_IndexExtAudioEndUnused,
|
||
|
|
|
||
|
|
/* Image parameters and configurations */
|
||
|
|
OMX_IndexExtImageStartUnused = OMX_IndexKhronosExtensions + 0x00500000,
|
||
|
|
|
||
|
|
/* Video parameters and configurations */
|
||
|
|
OMX_IndexExtVideoStartUnused = OMX_IndexKhronosExtensions + 0x00600000,
|
||
|
|
OMX_IndexParamNalStreamFormatSupported, /**< reference: OMX_NALSTREAMFORMATTYPE */
|
||
|
|
OMX_IndexParamNalStreamFormat, /**< reference: OMX_NALSTREAMFORMATTYPE */
|
||
|
|
OMX_IndexParamNalStreamFormatSelect, /**< reference: OMX_NALSTREAMFORMATTYPE */
|
||
|
|
OMX_IndexParamVideoVp8, /**< reference: OMX_VIDEO_PARAM_VP8TYPE */
|
||
|
|
OMX_IndexConfigVideoVp8ReferenceFrame, /**< reference: OMX_VIDEO_VP8REFERENCEFRAMETYPE */
|
||
|
|
OMX_IndexConfigVideoVp8ReferenceFrameType, /**< reference: OMX_VIDEO_VP8REFERENCEFRAMEINFOTYPE */
|
||
|
|
OMX_IndexParamVideoAndroidVp8Encoder, /**< reference: OMX_VIDEO_PARAM_ANDROID_VP8ENCODERTYPE */
|
||
|
|
OMX_IndexParamVideoHevc, /**< reference: OMX_VIDEO_PARAM_HEVCTYPE */
|
||
|
|
OMX_IndexParamSliceSegments, /**< reference: OMX_VIDEO_SLICESEGMENTSTYPE */
|
||
|
|
OMX_IndexConfigAndroidIntraRefresh, /**< reference: OMX_VIDEO_CONFIG_ANDROID_INTRAREFRESHTYPE */
|
||
|
|
OMX_IndexParamAndroidVideoTemporalLayering, /**< reference: OMX_VIDEO_PARAM_ANDROID_TEMPORALLAYERINGTYPE */
|
||
|
|
OMX_IndexConfigAndroidVideoTemporalLayering, /**< reference: OMX_VIDEO_CONFIG_ANDROID_TEMPORALLAYERINGTYPE */
|
||
|
|
OMX_IndexParamMaxFrameDurationForBitrateControl,/**< reference: OMX_PARAM_U32TYPE */
|
||
|
|
OMX_IndexParamVideoVp9, /**< reference: OMX_VIDEO_PARAM_VP9TYPE */
|
||
|
|
OMX_IndexParamVideoAndroidVp9Encoder, /**< reference: OMX_VIDEO_PARAM_ANDROID_VP9ENCODERTYPE */
|
||
|
|
OMX_IndexParamVideoAndroidImageGrid, /**< reference: OMX_VIDEO_PARAM_ANDROID_IMAGEGRIDTYPE */
|
||
|
|
OMX_IndexParamVideoAndroidRequiresSwRenderer, /**< reference: OMX_PARAM_U32TYPE */
|
||
|
|
OMX_IndexExtVideoEndUnused,
|
||
|
|
|
||
|
|
/* Image & Video common configurations */
|
||
|
|
OMX_IndexExtCommonStartUnused = OMX_IndexKhronosExtensions + 0x00700000,
|
||
|
|
|
||
|
|
/* Other configurations */
|
||
|
|
OMX_IndexExtOtherStartUnused = OMX_IndexKhronosExtensions + 0x00800000,
|
||
|
|
OMX_IndexConfigAutoFramerateConversion, /**< reference: OMX_CONFIG_BOOLEANTYPE */
|
||
|
|
OMX_IndexConfigPriority, /**< reference: OMX_PARAM_U32TYPE */
|
||
|
|
OMX_IndexConfigOperatingRate, /**< reference: OMX_PARAM_U32TYPE in Q16 format for video and in Hz for audio */
|
||
|
|
OMX_IndexParamConsumerUsageBits, /**< reference: OMX_PARAM_U32TYPE */
|
||
|
|
OMX_IndexConfigLatency, /**< reference: OMX_PARAM_U32TYPE */
|
||
|
|
OMX_IndexConfigLowLatency, /**< reference: OMX_CONFIG_BOOLEANTYPE */
|
||
|
|
OMX_IndexConfigAndroidTunnelPeek, /**< reference: OMX_CONFIG_BOOLEANTYPE */
|
||
|
|
OMX_IndexConfigAndroidTunnelPeekLegacyMode, /**< reference: OMX_CONFIG_BOOLEANTYPE */
|
||
|
|
OMX_IndexExtOtherEndUnused,
|
||
|
|
|
||
|
|
/* Time configurations */
|
||
|
|
OMX_IndexExtTimeStartUnused = OMX_IndexKhronosExtensions + 0x00900000,
|
||
|
|
|
||
|
|
OMX_IndexExtMax = 0x7FFFFFFF
|
||
|
|
} OMX_INDEXEXTTYPE;
|
||
|
|
|
||
|
|
#define OMX_MAX_STRINGVALUE_SIZE OMX_MAX_STRINGNAME_SIZE
|
||
|
|
#define OMX_MAX_ANDROID_VENDOR_PARAMCOUNT 32
|
||
|
|
|
||
|
|
typedef enum OMX_ANDROID_VENDOR_VALUETYPE {
|
||
|
|
OMX_AndroidVendorValueInt32 = 0, /*<< int32_t value */
|
||
|
|
OMX_AndroidVendorValueInt64, /*<< int64_t value */
|
||
|
|
OMX_AndroidVendorValueString, /*<< string value */
|
||
|
|
OMX_AndroidVendorValueEndUnused,
|
||
|
|
} OMX_ANDROID_VENDOR_VALUETYPE;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Structure describing a single value of an Android vendor extension.
|
||
|
|
*
|
||
|
|
* STRUCTURE MEMBERS:
|
||
|
|
* cKey : parameter value name.
|
||
|
|
* eValueType : parameter value type
|
||
|
|
* bSet : if false, the parameter is not set (for OMX_GetConfig) or is unset (OMX_SetConfig)
|
||
|
|
* if true, the parameter is set to the corresponding value below
|
||
|
|
* nInt64 : int64 value
|
||
|
|
* cString : string value
|
||
|
|
*/
|
||
|
|
typedef struct OMX_CONFIG_ANDROID_VENDOR_PARAMTYPE {
|
||
|
|
OMX_U8 cKey[OMX_MAX_STRINGNAME_SIZE];
|
||
|
|
OMX_ANDROID_VENDOR_VALUETYPE eValueType;
|
||
|
|
OMX_BOOL bSet;
|
||
|
|
union {
|
||
|
|
OMX_S32 nInt32;
|
||
|
|
OMX_S64 nInt64;
|
||
|
|
OMX_U8 cString[OMX_MAX_STRINGVALUE_SIZE];
|
||
|
|
};
|
||
|
|
} OMX_CONFIG_ANDROID_VENDOR_PARAMTYPE;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* OMX_CONFIG_ANDROID_VENDOR_EXTENSIONTYPE is the structure for an Android vendor extension
|
||
|
|
* supported by the component. This structure enumerates the various extension parameters and their
|
||
|
|
* values.
|
||
|
|
*
|
||
|
|
* Android vendor extensions have a name and one or more parameter values - each with a string key -
|
||
|
|
* that are set together. The values are exposed to Android applications via a string key that is
|
||
|
|
* the concatenation of 'vendor', the extension name and the parameter key, each separated by dot
|
||
|
|
* (.), with any trailing '.value' suffix(es) removed (though optionally allowed).
|
||
|
|
*
|
||
|
|
* Extension names and parameter keys are subject to the following rules:
|
||
|
|
* - Each SHALL contain a set of lowercase alphanumeric (underscore allowed) tags separated by
|
||
|
|
* dot (.) or dash (-).
|
||
|
|
* - The first character of the first tag, and any tag following a dot SHALL not start with a
|
||
|
|
* digit.
|
||
|
|
* - Tags 'value', 'vendor', 'omx' and 'android' (even if trailed and/or followed by any number
|
||
|
|
* of underscores) are prohibited in the extension name.
|
||
|
|
* - Tags 'vendor', 'omx' and 'android' (even if trailed and/or followed by any number
|
||
|
|
* of underscores) are prohibited in parameter keys.
|
||
|
|
* - The tag 'value' (even if trailed and/or followed by any number
|
||
|
|
* of underscores) is prohibited in parameter keys with the following exception:
|
||
|
|
* the parameter key may be exactly 'value'
|
||
|
|
* - The parameter key for extensions with a single parameter value SHALL be 'value'
|
||
|
|
* - No two extensions SHALL have the same name
|
||
|
|
* - No extension's name SHALL start with another extension's NAME followed by a dot (.)
|
||
|
|
* - No two parameters of an extension SHALL have the same key
|
||
|
|
*
|
||
|
|
* This config can be used with both OMX_GetConfig and OMX_SetConfig. In the OMX_GetConfig
|
||
|
|
* case, the caller specifies nIndex and nParamSizeUsed. The component fills in cName,
|
||
|
|
* eDir and nParamCount. Additionally, if nParamSizeUsed is not less than nParamCount, the
|
||
|
|
* component fills out the parameter values (nParam) with the current values for each parameter
|
||
|
|
* of the vendor extension.
|
||
|
|
*
|
||
|
|
* The value of nIndex goes from 0 to N-1, where N is the number of Android vendor extensions
|
||
|
|
* supported by the component. The component does not need to report N as the caller can determine
|
||
|
|
* N by enumerating all extensions supported by the component. The component may not support any
|
||
|
|
* extensions. If there are no more extensions, OMX_GetParameter returns OMX_ErrorNoMore. The
|
||
|
|
* component supplies extensions in the order it wants clients to set them.
|
||
|
|
*
|
||
|
|
* The component SHALL return OMX_ErrorNone for all cases where nIndex is less than N (specifically
|
||
|
|
* even in the case of where nParamCount is greater than nParamSizeUsed).
|
||
|
|
*
|
||
|
|
* In the OMX_SetConfig case the field nIndex is ignored. If the component supports an Android
|
||
|
|
* vendor extension with the name in cName, it SHALL configure the parameter values for that
|
||
|
|
* extension according to the parameters in nParam. nParamCount is the number of valid parameters
|
||
|
|
* in the nParam array, and nParamSizeUsed is the size of the nParam array. (nParamSizeUsed
|
||
|
|
* SHALL be at least nParamCount) Parameters that are part of a vendor extension but are not
|
||
|
|
* in the nParam array are assumed to be unset (this is different from not changed).
|
||
|
|
* All parameter values SHALL have distinct keys in nParam (the component can assume that this
|
||
|
|
* is the case. Otherwise, the actual value for the parameters that are multiply defined can
|
||
|
|
* be any of the set values.)
|
||
|
|
*
|
||
|
|
* Return values in case of OMX_SetConfig:
|
||
|
|
* OMX_ErrorUnsupportedIndex: the component does not support the extension specified by cName
|
||
|
|
* OMX_ErrorUnsupportedSetting: the component does not support some or any of the parameters
|
||
|
|
* (names) specified in nParam
|
||
|
|
* OMX_ErrorBadParameter: the parameter is invalid (e.g. nParamCount is greater than
|
||
|
|
* nParamSizeUsed, or some parameter value has invalid type)
|
||
|
|
*
|
||
|
|
* STRUCTURE MEMBERS:
|
||
|
|
* nSize : size of the structure in bytes
|
||
|
|
* nVersion : OMX specification version information
|
||
|
|
* cName : name of vendor extension
|
||
|
|
* nParamCount : the number of parameter values that are part of this vendor extension
|
||
|
|
* nParamSizeUsed : the size of nParam
|
||
|
|
* (must be at least 1 and at most OMX_MAX_ANDROID_VENDOR_PARAMCOUNT)
|
||
|
|
* param : the parameter values
|
||
|
|
*/
|
||
|
|
typedef struct OMX_CONFIG_ANDROID_VENDOR_EXTENSIONTYPE {
|
||
|
|
OMX_U32 nSize;
|
||
|
|
OMX_VERSIONTYPE nVersion;
|
||
|
|
OMX_U32 nIndex;
|
||
|
|
OMX_U8 cName[OMX_MAX_STRINGNAME_SIZE];
|
||
|
|
OMX_DIRTYPE eDir;
|
||
|
|
OMX_U32 nParamCount;
|
||
|
|
OMX_U32 nParamSizeUsed;
|
||
|
|
OMX_CONFIG_ANDROID_VENDOR_PARAMTYPE param[1];
|
||
|
|
} OMX_CONFIG_ANDROID_VENDOR_EXTENSIONTYPE;
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif /* __cplusplus */
|
||
|
|
|
||
|
|
#endif /* OMX_IndexExt_h */
|
||
|
|
/* File EOF */
|