123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401 |
- /*
- * 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.
- *
- */
- /** OMX_VideoExt.h - OpenMax IL version 1.1.2
- * The OMX_VideoExt header file contains extensions to the
- * definitions used by both the application and the component to
- * access video items.
- */
- #ifndef OMX_VideoExt_h
- #define OMX_VideoExt_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_Core.h>
- /** NALU Formats */
- typedef enum OMX_NALUFORMATSTYPE {
- OMX_NaluFormatStartCodes = 1,
- OMX_NaluFormatOneNaluPerBuffer = 2,
- OMX_NaluFormatOneByteInterleaveLength = 4,
- OMX_NaluFormatTwoByteInterleaveLength = 8,
- OMX_NaluFormatFourByteInterleaveLength = 16,
- OMX_NaluFormatCodingMax = 0x7FFFFFFF
- } OMX_NALUFORMATSTYPE;
- /** NAL Stream Format */
- typedef struct OMX_NALSTREAMFORMATTYPE{
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_NALUFORMATSTYPE eNaluFormat;
- } OMX_NALSTREAMFORMATTYPE;
- /** VP8 profiles */
- typedef enum OMX_VIDEO_VP8PROFILETYPE {
- OMX_VIDEO_VP8ProfileMain = 0x01,
- OMX_VIDEO_VP8ProfileUnknown = 0x6EFFFFFF,
- OMX_VIDEO_VP8ProfileMax = 0x7FFFFFFF
- } OMX_VIDEO_VP8PROFILETYPE;
- /** VP8 levels */
- typedef enum OMX_VIDEO_VP8LEVELTYPE {
- OMX_VIDEO_VP8Level_Version0 = 0x01,
- OMX_VIDEO_VP8Level_Version1 = 0x02,
- OMX_VIDEO_VP8Level_Version2 = 0x04,
- OMX_VIDEO_VP8Level_Version3 = 0x08,
- OMX_VIDEO_VP8LevelUnknown = 0x6EFFFFFF,
- OMX_VIDEO_VP8LevelMax = 0x7FFFFFFF
- } OMX_VIDEO_VP8LEVELTYPE;
- /** VP9 profiles */
- typedef enum OMX_VIDEO_VP9PROFILETYPE {
- OMX_VIDEO_VP9Profile0 = 0x1,
- OMX_VIDEO_VP9Profile1 = 0x2,
- OMX_VIDEO_VP9Profile2 = 0x4,
- OMX_VIDEO_VP9Profile3 = 0x8,
- // HDR profiles also support passing HDR metadata
- OMX_VIDEO_VP9Profile2HDR = 0x1000,
- OMX_VIDEO_VP9Profile3HDR = 0x2000,
- OMX_VIDEO_VP9ProfileUnknown = 0x6EFFFFFF,
- OMX_VIDEO_VP9ProfileMax = 0x7FFFFFFF
- } OMX_VIDEO_VP9PROFILETYPE;
- /** VP9 levels */
- typedef enum OMX_VIDEO_VP9LEVELTYPE {
- OMX_VIDEO_VP9Level1 = 0x1,
- OMX_VIDEO_VP9Level11 = 0x2,
- OMX_VIDEO_VP9Level2 = 0x4,
- OMX_VIDEO_VP9Level21 = 0x8,
- OMX_VIDEO_VP9Level3 = 0x10,
- OMX_VIDEO_VP9Level31 = 0x20,
- OMX_VIDEO_VP9Level4 = 0x40,
- OMX_VIDEO_VP9Level41 = 0x80,
- OMX_VIDEO_VP9Level5 = 0x100,
- OMX_VIDEO_VP9Level51 = 0x200,
- OMX_VIDEO_VP9Level52 = 0x400,
- OMX_VIDEO_VP9Level6 = 0x800,
- OMX_VIDEO_VP9Level61 = 0x1000,
- OMX_VIDEO_VP9Level62 = 0x2000,
- OMX_VIDEO_VP9LevelUnknown = 0x6EFFFFFF,
- OMX_VIDEO_VP9LevelMax = 0x7FFFFFFF
- } OMX_VIDEO_VP9LEVELTYPE;
- /** VP8 Param */
- typedef struct OMX_VIDEO_PARAM_VP8TYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_VIDEO_VP8PROFILETYPE eProfile;
- OMX_VIDEO_VP8LEVELTYPE eLevel;
- OMX_U32 nDCTPartitions;
- OMX_BOOL bErrorResilientMode;
- } OMX_VIDEO_PARAM_VP8TYPE;
- /** Structure for configuring VP8 reference frames */
- typedef struct OMX_VIDEO_VP8REFERENCEFRAMETYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_BOOL bPreviousFrameRefresh;
- OMX_BOOL bGoldenFrameRefresh;
- OMX_BOOL bAlternateFrameRefresh;
- OMX_BOOL bUsePreviousFrame;
- OMX_BOOL bUseGoldenFrame;
- OMX_BOOL bUseAlternateFrame;
- } OMX_VIDEO_VP8REFERENCEFRAMETYPE;
- /** Structure for querying VP8 reference frame type */
- typedef struct OMX_VIDEO_VP8REFERENCEFRAMEINFOTYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_BOOL bIsIntraFrame;
- OMX_BOOL bIsGoldenOrAlternateFrame;
- } OMX_VIDEO_VP8REFERENCEFRAMEINFOTYPE;
- /** Maximum number of VP8 temporal layers */
- #define OMX_VIDEO_ANDROID_MAXVP8TEMPORALLAYERS 3
- /** VP8 temporal layer patterns */
- typedef enum OMX_VIDEO_ANDROID_VPXTEMPORALLAYERPATTERNTYPE {
- OMX_VIDEO_VPXTemporalLayerPatternNone = 0,
- OMX_VIDEO_VPXTemporalLayerPatternWebRTC = 1,
- OMX_VIDEO_VPXTemporalLayerPatternMax = 0x7FFFFFFF
- } OMX_VIDEO_ANDROID_VPXTEMPORALLAYERPATTERNTYPE;
- /**
- * Android specific VP8 encoder params
- *
- * STRUCT MEMBERS:
- * nSize : Size of the structure in bytes
- * nVersion : OMX specification version information
- * nPortIndex : Port that this structure applies to
- * nKeyFrameInterval : Key frame interval in frames
- * eTemporalPattern : Type of temporal layer pattern
- * nTemporalLayerCount : Number of temporal coding layers
- * nTemporalLayerBitrateRatio : Bitrate ratio allocation between temporal
- * streams in percentage
- * nMinQuantizer : Minimum (best quality) quantizer
- * nMaxQuantizer : Maximum (worst quality) quantizer
- */
- typedef struct OMX_VIDEO_PARAM_ANDROID_VP8ENCODERTYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_U32 nKeyFrameInterval; // distance between consecutive key_frames (including one
- // of the key_frames). 0 means interval is unspecified and
- // can be freely chosen by the codec. 1 means a stream of
- // only key_frames.
- OMX_VIDEO_ANDROID_VPXTEMPORALLAYERPATTERNTYPE eTemporalPattern;
- OMX_U32 nTemporalLayerCount;
- OMX_U32 nTemporalLayerBitrateRatio[OMX_VIDEO_ANDROID_MAXVP8TEMPORALLAYERS];
- OMX_U32 nMinQuantizer;
- OMX_U32 nMaxQuantizer;
- } OMX_VIDEO_PARAM_ANDROID_VP8ENCODERTYPE;
- /** HEVC Profile enum type */
- typedef enum OMX_VIDEO_HEVCPROFILETYPE {
- OMX_VIDEO_HEVCProfileUnknown = 0x0,
- OMX_VIDEO_HEVCProfileMain = 0x1,
- OMX_VIDEO_HEVCProfileMain10 = 0x2,
- // Main10 profile with HDR SEI support.
- OMX_VIDEO_HEVCProfileMain10HDR10 = 0x1000,
- OMX_VIDEO_HEVCProfileMax = 0x7FFFFFFF
- } OMX_VIDEO_HEVCPROFILETYPE;
- /** HEVC Level enum type */
- typedef enum OMX_VIDEO_HEVCLEVELTYPE {
- OMX_VIDEO_HEVCLevelUnknown = 0x0,
- OMX_VIDEO_HEVCMainTierLevel1 = 0x1,
- OMX_VIDEO_HEVCHighTierLevel1 = 0x2,
- OMX_VIDEO_HEVCMainTierLevel2 = 0x4,
- OMX_VIDEO_HEVCHighTierLevel2 = 0x8,
- OMX_VIDEO_HEVCMainTierLevel21 = 0x10,
- OMX_VIDEO_HEVCHighTierLevel21 = 0x20,
- OMX_VIDEO_HEVCMainTierLevel3 = 0x40,
- OMX_VIDEO_HEVCHighTierLevel3 = 0x80,
- OMX_VIDEO_HEVCMainTierLevel31 = 0x100,
- OMX_VIDEO_HEVCHighTierLevel31 = 0x200,
- OMX_VIDEO_HEVCMainTierLevel4 = 0x400,
- OMX_VIDEO_HEVCHighTierLevel4 = 0x800,
- OMX_VIDEO_HEVCMainTierLevel41 = 0x1000,
- OMX_VIDEO_HEVCHighTierLevel41 = 0x2000,
- OMX_VIDEO_HEVCMainTierLevel5 = 0x4000,
- OMX_VIDEO_HEVCHighTierLevel5 = 0x8000,
- OMX_VIDEO_HEVCMainTierLevel51 = 0x10000,
- OMX_VIDEO_HEVCHighTierLevel51 = 0x20000,
- OMX_VIDEO_HEVCMainTierLevel52 = 0x40000,
- OMX_VIDEO_HEVCHighTierLevel52 = 0x80000,
- OMX_VIDEO_HEVCMainTierLevel6 = 0x100000,
- OMX_VIDEO_HEVCHighTierLevel6 = 0x200000,
- OMX_VIDEO_HEVCMainTierLevel61 = 0x400000,
- OMX_VIDEO_HEVCHighTierLevel61 = 0x800000,
- OMX_VIDEO_HEVCMainTierLevel62 = 0x1000000,
- OMX_VIDEO_HEVCHighTierLevel62 = 0x2000000,
- OMX_VIDEO_HEVCHighTiermax = 0x7FFFFFFF
- } OMX_VIDEO_HEVCLEVELTYPE;
- /** Structure for controlling HEVC video encoding */
- typedef struct OMX_VIDEO_PARAM_HEVCTYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_VIDEO_HEVCPROFILETYPE eProfile;
- OMX_VIDEO_HEVCLEVELTYPE eLevel;
- OMX_U32 nKeyFrameInterval; // distance between consecutive I-frames (including one
- // of the I frames). 0 means interval is unspecified and
- // can be freely chosen by the codec. 1 means a stream of
- // only I frames.
- } OMX_VIDEO_PARAM_HEVCTYPE;
- /** Structure to define if dependent slice segments should be used */
- typedef struct OMX_VIDEO_SLICESEGMENTSTYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_BOOL bDepedentSegments;
- OMX_BOOL bEnableLoopFilterAcrossSlices;
- } OMX_VIDEO_SLICESEGMENTSTYPE;
- /** Structure to return timestamps of rendered output frames as well as EOS
- * for tunneled components.
- */
- typedef struct OMX_VIDEO_RENDEREVENTTYPE {
- OMX_S64 nMediaTimeUs; // timestamp of rendered video frame
- OMX_S64 nSystemTimeNs; // system monotonic time at the time frame was rendered
- // Use INT64_MAX for nMediaTimeUs to signal that the EOS
- // has been reached. In this case, nSystemTimeNs MUST be
- // the system time when the last frame was rendered.
- // This MUST be done in addition to returning (and
- // following) the render information for the last frame.
- } OMX_VIDEO_RENDEREVENTTYPE;
- /** Dolby Vision Profile enum type */
- typedef enum OMX_VIDEO_DOLBYVISIONPROFILETYPE {
- OMX_VIDEO_DolbyVisionProfileUnknown = 0x0,
- OMX_VIDEO_DolbyVisionProfileDvavPer = 0x1,
- OMX_VIDEO_DolbyVisionProfileDvavPen = 0x2,
- OMX_VIDEO_DolbyVisionProfileDvheDer = 0x4,
- OMX_VIDEO_DolbyVisionProfileDvheDen = 0x8,
- OMX_VIDEO_DolbyVisionProfileDvheDtr = 0x10,
- OMX_VIDEO_DolbyVisionProfileDvheStn = 0x20,
- OMX_VIDEO_DolbyVisionProfileDvheDth = 0x40,
- OMX_VIDEO_DolbyVisionProfileDvheDtb = 0x80,
- OMX_VIDEO_DolbyVisionProfileMax = 0x7FFFFFFF
- } OMX_VIDEO_DOLBYVISIONPROFILETYPE;
- /** Dolby Vision Level enum type */
- typedef enum OMX_VIDEO_DOLBYVISIONLEVELTYPE {
- OMX_VIDEO_DolbyVisionLevelUnknown = 0x0,
- OMX_VIDEO_DolbyVisionLevelHd24 = 0x1,
- OMX_VIDEO_DolbyVisionLevelHd30 = 0x2,
- OMX_VIDEO_DolbyVisionLevelFhd24 = 0x4,
- OMX_VIDEO_DolbyVisionLevelFhd30 = 0x8,
- OMX_VIDEO_DolbyVisionLevelFhd60 = 0x10,
- OMX_VIDEO_DolbyVisionLevelUhd24 = 0x20,
- OMX_VIDEO_DolbyVisionLevelUhd30 = 0x40,
- OMX_VIDEO_DolbyVisionLevelUhd48 = 0x80,
- OMX_VIDEO_DolbyVisionLevelUhd60 = 0x100,
- OMX_VIDEO_DolbyVisionLevelmax = 0x7FFFFFFF
- } OMX_VIDEO_DOLBYVISIONLEVELTYPE;
- /**
- * Structure for configuring video compression intra refresh period
- *
- * STRUCT MEMBERS:
- * nSize : Size of the structure in bytes
- * nVersion : OMX specification version information
- * nPortIndex : Port that this structure applies to
- * nRefreshPeriod : Intra refreh period in frames. Value 0 means disable intra refresh
- */
- typedef struct OMX_VIDEO_CONFIG_ANDROID_INTRAREFRESHTYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_U32 nRefreshPeriod;
- } OMX_VIDEO_CONFIG_ANDROID_INTRAREFRESHTYPE;
- /** Maximum number of temporal layers supported by AVC/HEVC */
- #define OMX_VIDEO_ANDROID_MAXTEMPORALLAYERS 8
- /** temporal layer patterns */
- typedef enum OMX_VIDEO_ANDROID_TEMPORALLAYERINGPATTERNTYPE {
- OMX_VIDEO_AndroidTemporalLayeringPatternNone = 0,
- // pattern as defined by WebRTC
- OMX_VIDEO_AndroidTemporalLayeringPatternWebRTC = 1 << 0,
- // pattern where frames in any layer other than the base layer only depend on at most the very
- // last frame from each preceding layer (other than the base layer.)
- OMX_VIDEO_AndroidTemporalLayeringPatternAndroid = 1 << 1,
- } OMX_VIDEO_ANDROID_TEMPORALLAYERINGPATTERNTYPE;
- /**
- * Android specific param for configuration of temporal layering.
- * Android only supports temporal layering where successive layers each double the
- * previous layer's framerate.
- * NOTE: Reading this parameter at run-time SHALL return actual run-time values.
- *
- * nSize : Size of the structure in bytes
- * nVersion : OMX specification version information
- * nPortIndex : Port that this structure applies to (output port for encoders)
- * eSupportedPatterns : A bitmask of supported layering patterns
- * nLayerCountMax : Max number of temporal coding layers supported
- * by the encoder (must be at least 1, 1 meaning temporal layering
- * is NOT supported)
- * nBLayerCountMax : Max number of layers that can contain B frames
- * (0) to (nLayerCountMax - 1)
- * ePattern : Layering pattern.
- * nPLayerCountActual : Number of temporal layers to be coded with non-B frames,
- * starting from and including the base-layer.
- * (1 to nLayerCountMax - nBLayerCountActual)
- * If nPLayerCountActual is 1 and nBLayerCountActual is 0, temporal
- * layering is disabled. Otherwise, it is enabled.
- * nBLayerCountActual : Number of temporal layers to be coded with B frames,
- * starting after non-B layers.
- * (0 to nBLayerCountMax)
- * bBitrateRatiosSpecified : Flag to indicate if layer-wise bitrate
- * distribution is specified.
- * nBitrateRatios : Bitrate ratio (100 based) per layer (index 0 is base layer).
- * Honored if bBitrateRatiosSpecified is set.
- * i.e for 4 layers with desired distribution (25% 25% 25% 25%),
- * nBitrateRatio = {25, 50, 75, 100, ... }
- * Values in indices not less than 'the actual number of layers
- * minus 1' MAY be ignored and assumed to be 100.
- */
- typedef struct OMX_VIDEO_PARAM_ANDROID_TEMPORALLAYERINGTYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_VIDEO_ANDROID_TEMPORALLAYERINGPATTERNTYPE eSupportedPatterns;
- OMX_U32 nLayerCountMax;
- OMX_U32 nBLayerCountMax;
- OMX_VIDEO_ANDROID_TEMPORALLAYERINGPATTERNTYPE ePattern;
- OMX_U32 nPLayerCountActual;
- OMX_U32 nBLayerCountActual;
- OMX_BOOL bBitrateRatiosSpecified;
- OMX_U32 nBitrateRatios[OMX_VIDEO_ANDROID_MAXTEMPORALLAYERS];
- } OMX_VIDEO_PARAM_ANDROID_TEMPORALLAYERINGTYPE;
- /**
- * Android specific config for changing the temporal-layer count or
- * bitrate-distribution at run-time.
- *
- * nSize : Size of the structure in bytes
- * nVersion : OMX specification version information
- * nPortIndex : Port that this structure applies to (output port for encoders)
- * ePattern : Layering pattern.
- * nPLayerCountActual : Number of temporal layers to be coded with non-B frames.
- * (same OMX_VIDEO_PARAM_ANDROID_TEMPORALLAYERINGTYPE limits apply.)
- * nBLayerCountActual : Number of temporal layers to be coded with B frames.
- * (same OMX_VIDEO_PARAM_ANDROID_TEMPORALLAYERINGTYPE limits apply.)
- * bBitrateRatiosSpecified : Flag to indicate if layer-wise bitrate
- * distribution is specified.
- * nBitrateRatios : Bitrate ratio (100 based, Q16 values) per layer (0 is base layer).
- * Honored if bBitrateRatiosSpecified is set.
- * (same OMX_VIDEO_PARAM_ANDROID_TEMPORALLAYERINGTYPE limits apply.)
- */
- typedef struct OMX_VIDEO_CONFIG_ANDROID_TEMPORALLAYERINGTYPE {
- OMX_U32 nSize;
- OMX_VERSIONTYPE nVersion;
- OMX_U32 nPortIndex;
- OMX_VIDEO_ANDROID_TEMPORALLAYERINGPATTERNTYPE ePattern;
- OMX_U32 nPLayerCountActual;
- OMX_U32 nBLayerCountActual;
- OMX_BOOL bBitrateRatiosSpecified;
- OMX_U32 nBitrateRatios[OMX_VIDEO_ANDROID_MAXTEMPORALLAYERS];
- } OMX_VIDEO_CONFIG_ANDROID_TEMPORALLAYERINGTYPE;
- #ifdef __cplusplus
- }
- #endif /* __cplusplus */
- #endif /* OMX_VideoExt_h */
- /* File EOF */
|