| /* |
| * Copyright (c) 2016, Alliance for Open Media. All rights reserved |
| * |
| * This source code is subject to the terms of the BSD 2 Clause License and |
| * the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License |
| * was not distributed with this source code in the LICENSE file, you can |
| * obtain it at www.aomedia.org/license/software. If the Alliance for Open |
| * Media Patent License 1.0 was not distributed with this source code in the |
| * PATENTS file, you can obtain it at www.aomedia.org/license/patent. |
| */ |
| #ifndef AOM_AOM_AOMCX_H_ |
| #define AOM_AOM_AOMCX_H_ |
| |
| /*!\defgroup aom_encoder AOMedia AOM/AV1 Encoder |
| * \ingroup aom |
| * |
| * @{ |
| */ |
| #include "aom/aom.h" |
| #include "aom/aom_encoder.h" |
| #include "aom/aom_external_partition.h" |
| |
| /*!\file |
| * \brief Provides definitions for using AOM or AV1 encoder algorithm within the |
| * aom Codec Interface. |
| * |
| * Several interfaces are excluded with CONFIG_REALTIME_ONLY build: |
| * Global motion |
| * Warped motion |
| * OBMC |
| * TPL model |
| * Loop restoration |
| * |
| * The following features are also disabled with CONFIG_REALTIME_ONLY: |
| * AV1E_SET_QUANT_B_ADAPT |
| * CNN |
| * 4X rectangular blocks |
| * 4X rectangular transform in intra prediction |
| */ |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /*!\name Algorithm interface for AV1 |
| * |
| * This interface provides the capability to encode raw AV1 streams. |
| *@{ |
| */ |
| |
| /*!\brief A single instance of the AV1 encoder. |
| *\deprecated This access mechanism is provided for backwards compatibility; |
| * prefer aom_codec_av1_cx(). |
| */ |
| extern aom_codec_iface_t aom_codec_av1_cx_algo; |
| |
| /*!\brief The interface to the AV1 encoder. |
| */ |
| extern aom_codec_iface_t *aom_codec_av1_cx(void); |
| /*!@} - end algorithm interface member group */ |
| |
| /* |
| * Algorithm Flags |
| */ |
| |
| /*!\brief Don't reference the last frame |
| * |
| * When this flag is set, the encoder will not use the last frame as a |
| * predictor. When not set, the encoder will choose whether to use the |
| * last frame or not automatically. |
| */ |
| #define AOM_EFLAG_NO_REF_LAST (1 << 16) |
| /*!\brief Don't reference the last2 frame |
| * |
| * When this flag is set, the encoder will not use the last2 frame as a |
| * predictor. When not set, the encoder will choose whether to use the |
| * last2 frame or not automatically. |
| */ |
| #define AOM_EFLAG_NO_REF_LAST2 (1 << 17) |
| /*!\brief Don't reference the last3 frame |
| * |
| * When this flag is set, the encoder will not use the last3 frame as a |
| * predictor. When not set, the encoder will choose whether to use the |
| * last3 frame or not automatically. |
| */ |
| #define AOM_EFLAG_NO_REF_LAST3 (1 << 18) |
| /*!\brief Don't reference the golden frame |
| * |
| * When this flag is set, the encoder will not use the golden frame as a |
| * predictor. When not set, the encoder will choose whether to use the |
| * golden frame or not automatically. |
| */ |
| #define AOM_EFLAG_NO_REF_GF (1 << 19) |
| |
| /*!\brief Don't reference the alternate reference frame |
| * |
| * When this flag is set, the encoder will not use the alt ref frame as a |
| * predictor. When not set, the encoder will choose whether to use the |
| * alt ref frame or not automatically. |
| */ |
| #define AOM_EFLAG_NO_REF_ARF (1 << 20) |
| /*!\brief Don't reference the bwd reference frame |
| * |
| * When this flag is set, the encoder will not use the bwd ref frame as a |
| * predictor. When not set, the encoder will choose whether to use the |
| * bwd ref frame or not automatically. |
| */ |
| #define AOM_EFLAG_NO_REF_BWD (1 << 21) |
| /*!\brief Don't reference the alt2 reference frame |
| * |
| * When this flag is set, the encoder will not use the alt2 ref frame as a |
| * predictor. When not set, the encoder will choose whether to use the |
| * alt2 ref frame or not automatically. |
| */ |
| #define AOM_EFLAG_NO_REF_ARF2 (1 << 22) |
| |
| /*!\brief Don't update the last frame |
| * |
| * When this flag is set, the encoder will not update the last frame with |
| * the contents of the current frame. |
| */ |
| #define AOM_EFLAG_NO_UPD_LAST (1 << 23) |
| |
| /*!\brief Don't update the golden frame |
| * |
| * When this flag is set, the encoder will not update the golden frame with |
| * the contents of the current frame. |
| */ |
| #define AOM_EFLAG_NO_UPD_GF (1 << 24) |
| |
| /*!\brief Don't update the alternate reference frame |
| * |
| * When this flag is set, the encoder will not update the alt ref frame with |
| * the contents of the current frame. |
| */ |
| #define AOM_EFLAG_NO_UPD_ARF (1 << 25) |
| /*!\brief Disable entropy update |
| * |
| * When this flag is set, the encoder will not update its internal entropy |
| * model based on the entropy of this frame. |
| */ |
| #define AOM_EFLAG_NO_UPD_ENTROPY (1 << 26) |
| /*!\brief Disable ref frame mvs |
| * |
| * When this flag is set, the encoder will not allow frames to |
| * be encoded using mfmv. |
| */ |
| #define AOM_EFLAG_NO_REF_FRAME_MVS (1 << 27) |
| /*!\brief Enable error resilient frame |
| * |
| * When this flag is set, the encoder will code frames as error |
| * resilient. |
| */ |
| #define AOM_EFLAG_ERROR_RESILIENT (1 << 28) |
| /*!\brief Enable s frame mode |
| * |
| * When this flag is set, the encoder will code frames as an |
| * s frame. |
| */ |
| #define AOM_EFLAG_SET_S_FRAME (1 << 29) |
| /*!\brief Force primary_ref_frame to PRIMARY_REF_NONE |
| * |
| * When this flag is set, the encoder will set a frame's primary_ref_frame |
| * to PRIMARY_REF_NONE |
| */ |
| #define AOM_EFLAG_SET_PRIMARY_REF_NONE (1 << 30) |
| |
| /*!\brief AVx encoder control functions |
| * |
| * This set of macros define the control functions available for AVx |
| * encoder interface. |
| * The range of encode control ID is 7-229(max). |
| * |
| * \sa #aom_codec_control(aom_codec_ctx_t *ctx, int ctrl_id, ...) |
| */ |
| enum aome_enc_control_id { |
| /*!\brief Codec control function to set which reference frame encoder can use, |
| * int parameter. |
| */ |
| AOME_USE_REFERENCE = 7, |
| |
| /*!\brief Codec control function to pass an ROI map to encoder, aom_roi_map_t* |
| * parameter. |
| */ |
| AOME_SET_ROI_MAP = 8, |
| |
| /*!\brief Codec control function to pass an Active map to encoder, |
| * aom_active_map_t* parameter. |
| */ |
| AOME_SET_ACTIVEMAP = 9, |
| |
| /* NOTE: enum 10 unused */ |
| |
| /*!\brief Codec control function to set encoder scaling mode for the next |
| * frame to be coded, aom_scaling_mode_t* parameter. |
| */ |
| AOME_SET_SCALEMODE = 11, |
| |
| /*!\brief Codec control function to set encoder spatial layer id, int |
| * parameter. |
| */ |
| AOME_SET_SPATIAL_LAYER_ID = 12, |
| |
| /*!\brief Codec control function to set encoder internal speed settings, |
| * int parameter |
| * |
| * Changes in this value influences the complexity of algorithms used in |
| * encoding process, values greater than 0 will increase encoder speed at |
| * the expense of quality. |
| * |
| * Valid range: 0..11. 0 runs the slowest, and 11 runs the fastest; |
| * quality improves as speed decreases (since more compression |
| * possibilities are explored). |
| * |
| * NOTE: 10 and 11 are only allowed in AOM_USAGE_REALTIME. In |
| * AOM_USAGE_GOOD_QUALITY and AOM_USAGE_ALL_INTRA, 9 is the highest allowed |
| * value. However, AOM_USAGE_GOOD_QUALITY treats 7..9 the same as 6. Also, |
| * AOM_USAGE_REALTIME treats 0..4 the same as 5. |
| */ |
| AOME_SET_CPUUSED = 13, |
| |
| /*!\brief Codec control function to enable automatic set and use alf frames, |
| * unsigned int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AOME_SET_ENABLEAUTOALTREF = 14, |
| |
| /* NOTE: enum 15 unused */ |
| |
| /*!\brief Codec control function to set the sharpness parameter, |
| * unsigned int parameter. |
| * |
| * This parameter controls the level at which rate-distortion optimization of |
| * transform coefficients favours sharpness in the block. |
| * |
| * Valid range: 0..7. The default is 0. Values 1-7 will avoid eob and skip |
| * block optimization and will change rdmult in favour of block sharpness. |
| */ |
| AOME_SET_SHARPNESS = AOME_SET_ENABLEAUTOALTREF + 2, // 16 |
| |
| /*!\brief Codec control function to set the threshold for MBs treated static, |
| * unsigned int parameter |
| */ |
| AOME_SET_STATIC_THRESHOLD = 17, |
| |
| /* NOTE: enum 18 unused */ |
| |
| /*!\brief Codec control function to get last quantizer chosen by the encoder, |
| * int* parameter |
| * |
| * Return value uses internal quantizer scale defined by the codec. |
| */ |
| AOME_GET_LAST_QUANTIZER = AOME_SET_STATIC_THRESHOLD + 2, // 19 |
| |
| /*!\brief Codec control function to get last quantizer chosen by the encoder, |
| * int* parameter |
| * |
| * Return value uses the 0..63 scale as used by the rc_*_quantizer config |
| * parameters. |
| */ |
| AOME_GET_LAST_QUANTIZER_64 = 20, |
| |
| /*!\brief Codec control function to set the max no of frames to create arf, |
| * unsigned int parameter |
| */ |
| AOME_SET_ARNR_MAXFRAMES = 21, |
| |
| /*!\brief Codec control function to set the filter strength for the arf, |
| * unsigned int parameter |
| */ |
| AOME_SET_ARNR_STRENGTH = 22, |
| |
| /* NOTE: enum 23 unused */ |
| |
| /*!\brief Codec control function to set visual tuning, aom_tune_metric (int) |
| * parameter |
| * |
| * The default is AOM_TUNE_PSNR. |
| */ |
| AOME_SET_TUNING = AOME_SET_ARNR_STRENGTH + 2, // 24 |
| |
| /*!\brief Codec control function to set constrained / constant quality level, |
| * unsigned int parameter |
| * |
| * Valid range: 0..63 |
| * |
| * \attention For this value to be used aom_codec_enc_cfg_t::rc_end_usage |
| * must be set to #AOM_CQ or #AOM_Q. |
| */ |
| AOME_SET_CQ_LEVEL = 25, |
| |
| /*!\brief Codec control function to set max data rate for intra frames, |
| * unsigned int parameter |
| * |
| * This value controls additional clamping on the maximum size of a |
| * keyframe. It is expressed as a percentage of the average |
| * per-frame bitrate, with the special (and default) value 0 meaning |
| * unlimited, or no additional clamping beyond the codec's built-in |
| * algorithm. |
| * |
| * For example, to allocate no more than 4.5 frames worth of bitrate |
| * to a keyframe, set this to 450. |
| */ |
| AOME_SET_MAX_INTRA_BITRATE_PCT = 26, |
| |
| /*!\brief Codec control function to set number of spatial layers, int |
| * parameter |
| */ |
| AOME_SET_NUMBER_SPATIAL_LAYERS = 27, |
| |
| /*!\brief Codec control function to set max data rate for inter frames, |
| * unsigned int parameter |
| * |
| * This value controls additional clamping on the maximum size of an |
| * inter frame. It is expressed as a percentage of the average |
| * per-frame bitrate, with the special (and default) value 0 meaning |
| * unlimited, or no additional clamping beyond the codec's built-in |
| * algorithm. |
| * |
| * For example, to allow no more than 4.5 frames worth of bitrate |
| * to an inter frame, set this to 450. |
| */ |
| AV1E_SET_MAX_INTER_BITRATE_PCT = AOME_SET_MAX_INTRA_BITRATE_PCT + 2, // 28 |
| |
| /*!\brief Boost percentage for Golden Frame in CBR mode, unsigned int |
| * parameter |
| * |
| * This value controls the amount of boost given to Golden Frame in |
| * CBR mode. It is expressed as a percentage of the average |
| * per-frame bitrate, with the special (and default) value 0 meaning |
| * the feature is off, i.e., no golden frame boost in CBR mode and |
| * average bitrate target is used. |
| * |
| * For example, to allow 100% more bits, i.e, 2X, in a golden frame |
| * than average frame, set this to 100. |
| */ |
| AV1E_SET_GF_CBR_BOOST_PCT = 29, |
| |
| /* NOTE: enum 30 unused */ |
| |
| /*!\brief Codec control function to set lossless encoding mode, unsigned int |
| * parameter |
| * |
| * AV1 can operate in lossless encoding mode, in which the bitstream |
| * produced will be able to decode and reconstruct a perfect copy of |
| * input source. |
| * |
| * - 0 = normal coding mode, may be lossy (default) |
| * - 1 = lossless coding mode |
| */ |
| AV1E_SET_LOSSLESS = AV1E_SET_GF_CBR_BOOST_PCT + 2, // 31 |
| |
| /*!\brief Codec control function to enable the row based multi-threading |
| * of the encoder, unsigned int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ROW_MT = 32, |
| |
| /*!\brief Codec control function to set number of tile columns. unsigned int |
| * parameter |
| * |
| * In encoding and decoding, AV1 allows an input image frame be partitioned |
| * into separate vertical tile columns, which can be encoded or decoded |
| * independently. This enables easy implementation of parallel encoding and |
| * decoding. The parameter for this control describes the number of tile |
| * columns (in log2 units), which has a valid range of [0, 6]: |
| * \verbatim |
| 0 = 1 tile column |
| 1 = 2 tile columns |
| 2 = 4 tile columns |
| ..... |
| n = 2**n tile columns |
| \endverbatim |
| * By default, the value is 0, i.e. one single column tile for entire image. |
| */ |
| AV1E_SET_TILE_COLUMNS = 33, |
| |
| /*!\brief Codec control function to set number of tile rows, unsigned int |
| * parameter |
| * |
| * In encoding and decoding, AV1 allows an input image frame be partitioned |
| * into separate horizontal tile rows, which can be encoded or decoded |
| * independently. The parameter for this control describes the number of tile |
| * rows (in log2 units), which has a valid range of [0, 6]: |
| * \verbatim |
| 0 = 1 tile row |
| 1 = 2 tile rows |
| 2 = 4 tile rows |
| ..... |
| n = 2**n tile rows |
| \endverbatim |
| * By default, the value is 0, i.e. one single row tile for entire image. |
| */ |
| AV1E_SET_TILE_ROWS = 34, |
| |
| /*!\brief Codec control function to enable RDO modulated by frame temporal |
| * dependency, unsigned int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| * |
| * \note Excluded from CONFIG_REALTIME_ONLY build. |
| */ |
| AV1E_SET_ENABLE_TPL_MODEL = 35, |
| |
| /*!\brief Codec control function to enable temporal filtering on key frame, |
| * unsigned int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable without overlay (default) |
| * - 2 = enable with overlay |
| */ |
| AV1E_SET_ENABLE_KEYFRAME_FILTERING = 36, |
| |
| /*!\brief Codec control function to enable frame parallel decoding feature, |
| * unsigned int parameter |
| * |
| * AV1 has a bitstream feature to reduce decoding dependency between frames |
| * by turning off backward update of probability context used in encoding |
| * and decoding. This allows staged parallel processing of more than one |
| * video frames in the decoder. This control function provides a means to |
| * turn this feature on or off for bitstreams produced by encoder. |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AV1E_SET_FRAME_PARALLEL_DECODING = 37, |
| |
| /*!\brief Codec control function to enable error_resilient_mode, int parameter |
| * |
| * AV1 has a bitstream feature to guarantee parsability of a frame |
| * by turning on the error_resilient_decoding mode, even though the |
| * reference buffers are unreliable or not received. |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AV1E_SET_ERROR_RESILIENT_MODE = 38, |
| |
| /*!\brief Codec control function to enable s_frame_mode, int parameter |
| * |
| * AV1 has a bitstream feature to designate certain frames as S-frames, |
| * from where we can switch to a different stream, |
| * even though the reference buffers may not be exactly identical. |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AV1E_SET_S_FRAME_MODE = 39, |
| |
| /*!\brief Codec control function to set adaptive quantization mode, unsigned |
| * int parameter |
| * |
| * AV1 has a segment based feature that allows encoder to adaptively change |
| * quantization parameter for each segment within a frame to improve the |
| * subjective quality. This control makes encoder operate in one of the |
| * several AQ modes supported. |
| * |
| * - 0 = disable (default) |
| * - 1 = variance |
| * - 2 = complexity |
| * - 3 = cyclic refresh |
| */ |
| AV1E_SET_AQ_MODE = 40, |
| |
| /*!\brief Codec control function to enable/disable periodic Q boost, unsigned |
| * int parameter |
| * |
| * One AV1 encoder speed feature is to enable quality boost by lowering |
| * frame level Q periodically. This control function provides a means to |
| * turn on/off this feature. |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AV1E_SET_FRAME_PERIODIC_BOOST = 41, |
| |
| /*!\brief Codec control function to set noise sensitivity, unsigned int |
| * parameter |
| * |
| * - 0 = disable (default) |
| * - 1 = enable (Y only) |
| */ |
| AV1E_SET_NOISE_SENSITIVITY = 42, |
| |
| /*!\brief Codec control function to set content type, aom_tune_content |
| * parameter |
| * |
| * - AOM_CONTENT_DEFAULT = Regular video content (default) |
| * - AOM_CONTENT_SCREEN = Screen capture content |
| * - AOM_CONTENT_FILM = Film content |
| */ |
| AV1E_SET_TUNE_CONTENT = 43, |
| |
| /*!\brief Codec control function to set CDF update mode, unsigned int |
| * parameter |
| * |
| * - 0: no update |
| * - 1: update on every frame (default) |
| * - 2: selectively update |
| */ |
| AV1E_SET_CDF_UPDATE_MODE = 44, |
| |
| /*!\brief Codec control function to set color space info, int parameter |
| * |
| * - 0 = For future use |
| * - 1 = BT.709 |
| * - 2 = Unspecified (default) |
| * - 3 = For future use |
| * - 4 = BT.470 System M (historical) |
| * - 5 = BT.470 System B, G (historical) |
| * - 6 = BT.601 |
| * - 7 = SMPTE 240 |
| * - 8 = Generic film (color filters using illuminant C) |
| * - 9 = BT.2020, BT.2100 |
| * - 10 = SMPTE 428 (CIE 1921 XYZ) |
| * - 11 = SMPTE RP 431-2 |
| * - 12 = SMPTE EG 432-1 |
| * - 13..21 = For future use |
| * - 22 = EBU Tech. 3213-E |
| * - 23 = For future use |
| */ |
| AV1E_SET_COLOR_PRIMARIES = 45, |
| |
| /*!\brief Codec control function to set transfer function info, int parameter |
| * |
| * - 0 = For future use |
| * - 1 = BT.709 |
| * - 2 = Unspecified (default) |
| * - 3 = For future use |
| * - 4 = BT.470 System M (historical) |
| * - 5 = BT.470 System B, G (historical) |
| * - 6 = BT.601 |
| * - 7 = SMPTE 240 M |
| * - 8 = Linear |
| * - 9 = Logarithmic (100 : 1 range) |
| * - 10 = Logarithmic (100 * Sqrt(10) : 1 range) |
| * - 11 = IEC 61966-2-4 |
| * - 12 = BT.1361 |
| * - 13 = sRGB or sYCC |
| * - 14 = BT.2020 10-bit systems |
| * - 15 = BT.2020 12-bit systems |
| * - 16 = SMPTE ST 2084, ITU BT.2100 PQ |
| * - 17 = SMPTE ST 428 |
| * - 18 = BT.2100 HLG, ARIB STD-B67 |
| * - 19 = For future use |
| */ |
| AV1E_SET_TRANSFER_CHARACTERISTICS = 46, |
| |
| /*!\brief Codec control function to set transfer function info, int parameter |
| * |
| * - 0 = Identity matrix |
| * - 1 = BT.709 |
| * - 2 = Unspecified (default) |
| * - 3 = For future use |
| * - 4 = US FCC 73.628 |
| * - 5 = BT.470 System B, G (historical) |
| * - 6 = BT.601 |
| * - 7 = SMPTE 240 M |
| * - 8 = YCgCo |
| * - 9 = BT.2020 non-constant luminance, BT.2100 YCbCr |
| * - 10 = BT.2020 constant luminance |
| * - 11 = SMPTE ST 2085 YDzDx |
| * - 12 = Chromaticity-derived non-constant luminance |
| * - 13 = Chromaticity-derived constant luminance |
| * - 14 = BT.2100 ICtCp |
| * - 15 = For future use |
| */ |
| AV1E_SET_MATRIX_COEFFICIENTS = 47, |
| |
| /*!\brief Codec control function to set chroma 4:2:0 sample position info, |
| * aom_chroma_sample_position_t parameter |
| * |
| * AOM_CSP_UNKNOWN is default |
| */ |
| AV1E_SET_CHROMA_SAMPLE_POSITION = 48, |
| |
| /*!\brief Codec control function to set minimum interval between GF/ARF |
| * frames, unsigned int parameter |
| * |
| * By default the value is set as 4. |
| */ |
| AV1E_SET_MIN_GF_INTERVAL = 49, |
| |
| /*!\brief Codec control function to set minimum interval between GF/ARF |
| * frames, unsigned int parameter |
| * |
| * By default the value is set as 16. |
| */ |
| AV1E_SET_MAX_GF_INTERVAL = 50, |
| |
| /*!\brief Codec control function to get an active map back from the encoder, |
| aom_active_map_t* parameter |
| */ |
| AV1E_GET_ACTIVEMAP = 51, |
| |
| /*!\brief Codec control function to set color range bit, int parameter |
| * |
| * - 0 = Limited range, 16..235 or HBD equivalent (default) |
| * - 1 = Full range, 0..255 or HBD equivalent |
| */ |
| AV1E_SET_COLOR_RANGE = 52, |
| |
| /*!\brief Codec control function to set intended rendering image size, |
| * int32_t[2] parameter |
| * |
| * By default, this is identical to the image size in pixels. |
| */ |
| AV1E_SET_RENDER_SIZE = 53, |
| |
| /*!\brief Control to set target sequence level index for a certain operating |
| * point (OP), int parameter |
| * Possible values are in the form of "ABxy". |
| * - AB: OP index. |
| * - xy: Target level index for the OP. Possible values are: |
| * + 0~27: corresponding to level 2.0 ~ 8.3. Note: |
| * > Levels 2.2 (2), 2.3 (3), 3.2 (6), 3.3 (7), 4.2 (10) & 4.3 (11) are |
| * undefined. |
| * > Levels 7.x and 8.x (20~27) are in draft status, available under the |
| * config flag CONFIG_CWG_C013. |
| * + 31: maximum parameters level, no level-based constraints. |
| * + 32: keep level stats only for level monitoring. |
| * |
| * E.g.: |
| * - "0" means target level index 0 (2.0) for the 0th OP; |
| * - "109" means target level index 9 (4.1) for the 1st OP; |
| * - "1019" means target level index 19 (6.3) for the 10th OP. |
| * |
| * If the target level is not specified for an OP, the maximum parameters |
| * level of 31 is used as default. |
| */ |
| AV1E_SET_TARGET_SEQ_LEVEL_IDX = 54, |
| |
| /*!\brief Codec control function to get sequence level index for each |
| * operating point. int* parameter. There can be at most 32 operating points. |
| * The results will be written into a provided integer array of sufficient |
| * size. |
| */ |
| AV1E_GET_SEQ_LEVEL_IDX = 55, |
| |
| /*!\brief Codec control function to set intended superblock size, unsigned int |
| * parameter |
| * |
| * By default, the superblock size is determined separately for each |
| * frame by the encoder. |
| */ |
| AV1E_SET_SUPERBLOCK_SIZE = 56, |
| |
| /*!\brief Codec control function to enable automatic set and use of |
| * bwd-pred frames, unsigned int parameter |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AOME_SET_ENABLEAUTOBWDREF = 57, |
| |
| /*!\brief Codec control function to encode with CDEF, unsigned int parameter |
| * |
| * CDEF is the constrained directional enhancement filter which is an |
| * in-loop filter aiming to remove coding artifacts |
| * |
| * - 0 = disable |
| * - 1 = enable for all frames (default) |
| * - 2 = disable for non-reference frames |
| */ |
| AV1E_SET_ENABLE_CDEF = 58, |
| |
| /*!\brief Codec control function to encode with Loop Restoration Filter, |
| * unsigned int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| * |
| * \note Excluded from CONFIG_REALTIME_ONLY build. |
| */ |
| AV1E_SET_ENABLE_RESTORATION = 59, |
| |
| /*!\brief Codec control function to force video mode, unsigned int parameter |
| * |
| * - 0 = do not force video mode (default) |
| * - 1 = force video mode even for a single frame |
| */ |
| AV1E_SET_FORCE_VIDEO_MODE = 60, |
| |
| /*!\brief Codec control function to predict with OBMC mode, unsigned int |
| * parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| * |
| * \note Excluded from CONFIG_REALTIME_ONLY build. |
| */ |
| AV1E_SET_ENABLE_OBMC = 61, |
| |
| /*!\brief Codec control function to encode without trellis quantization, |
| * unsigned int parameter |
| * |
| * - 0 = apply trellis quantization (default) |
| * - 1 = do not apply trellis quantization |
| * - 2 = disable trellis quantization in rd search |
| * - 3 = disable trellis quantization in estimate yrd |
| */ |
| AV1E_SET_DISABLE_TRELLIS_QUANT = 62, |
| |
| /*!\brief Codec control function to encode with quantisation matrices, |
| * unsigned int parameter |
| * |
| * AOM can operate with default quantisation matrices dependent on |
| * quantisation level and block type. |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AV1E_SET_ENABLE_QM = 63, |
| |
| /*!\brief Codec control function to set the min quant matrix flatness, |
| * unsigned int parameter |
| * |
| * AOM can operate with different ranges of quantisation matrices. |
| * As quantisation levels increase, the matrices get flatter. This |
| * control sets the minimum level of flatness from which the matrices |
| * are determined. |
| * |
| * By default, the encoder sets this minimum at half the available |
| * range. |
| */ |
| AV1E_SET_QM_MIN = 64, |
| |
| /*!\brief Codec control function to set the max quant matrix flatness, |
| * unsigned int parameter |
| * |
| * AOM can operate with different ranges of quantisation matrices. |
| * As quantisation levels increase, the matrices get flatter. This |
| * control sets the maximum level of flatness possible. |
| * |
| * By default, the encoder sets this maximum at the top of the |
| * available range. |
| */ |
| AV1E_SET_QM_MAX = 65, |
| |
| /*!\brief Codec control function to set the min quant matrix flatness, |
| * unsigned int parameter |
| * |
| * AOM can operate with different ranges of quantisation matrices. |
| * As quantisation levels increase, the matrices get flatter. This |
| * control sets the flatness for luma (Y). |
| * |
| * By default, the encoder sets this minimum at half the available |
| * range. |
| */ |
| AV1E_SET_QM_Y = 66, |
| |
| /*!\brief Codec control function to set the min quant matrix flatness, |
| * unsigned int parameter |
| * |
| * AOM can operate with different ranges of quantisation matrices. |
| * As quantisation levels increase, the matrices get flatter. This |
| * control sets the flatness for chroma (U). |
| * |
| * By default, the encoder sets this minimum at half the available |
| * range. |
| */ |
| AV1E_SET_QM_U = 67, |
| |
| /*!\brief Codec control function to set the min quant matrix flatness, |
| * unsigned int parameter |
| * |
| * AOM can operate with different ranges of quantisation matrices. |
| * As quantisation levels increase, the matrices get flatter. This |
| * control sets the flatness for chrome (V). |
| * |
| * By default, the encoder sets this minimum at half the available |
| * range. |
| */ |
| AV1E_SET_QM_V = 68, |
| |
| /* NOTE: enum 69 unused */ |
| |
| /*!\brief Codec control function to set a maximum number of tile groups, |
| * unsigned int parameter |
| * |
| * This will set the maximum number of tile groups. This will be |
| * overridden if an MTU size is set. The default value is 1. |
| */ |
| AV1E_SET_NUM_TG = 70, |
| |
| /*!\brief Codec control function to set an MTU size for a tile group, unsigned |
| * int parameter |
| * |
| * This will set the maximum number of bytes in a tile group. This can be |
| * exceeded only if a single tile is larger than this amount. |
| * |
| * By default, the value is 0, in which case a fixed number of tile groups |
| * is used. |
| */ |
| AV1E_SET_MTU = 71, |
| |
| /* NOTE: enum 72 unused */ |
| |
| /*!\brief Codec control function to enable/disable rectangular partitions, int |
| * parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_RECT_PARTITIONS = 73, |
| |
| /*!\brief Codec control function to enable/disable AB partitions, int |
| * parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_AB_PARTITIONS = 74, |
| |
| /*!\brief Codec control function to enable/disable 1:4 and 4:1 partitions, int |
| * parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_1TO4_PARTITIONS = 75, |
| |
| /*!\brief Codec control function to set min partition size, int parameter |
| * |
| * min_partition_size is applied to both width and height of the partition. |
| * i.e, both width and height of a partition can not be smaller than |
| * the min_partition_size, except the partition at the picture boundary. |
| * |
| * Valid values: [4, 8, 16, 32, 64, 128]. The default value is 4 for |
| * 4x4. |
| */ |
| AV1E_SET_MIN_PARTITION_SIZE = 76, |
| |
| /*!\brief Codec control function to set max partition size, int parameter |
| * |
| * max_partition_size is applied to both width and height of the partition. |
| * i.e, both width and height of a partition can not be larger than |
| * the max_partition_size. |
| * |
| * Valid values:[4, 8, 16, 32, 64, 128] The default value is 128 for |
| * 128x128. |
| */ |
| AV1E_SET_MAX_PARTITION_SIZE = 77, |
| |
| /*!\brief Codec control function to turn on / off intra edge filter |
| * at sequence level, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_INTRA_EDGE_FILTER = 78, |
| |
| /*!\brief Codec control function to turn on / off frame order hint (int |
| * parameter). Affects: joint compound mode, motion field motion vector, |
| * ref frame sign bias |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_ORDER_HINT = 79, |
| |
| /*!\brief Codec control function to turn on / off 64-length transforms, int |
| * parameter |
| * |
| * This will enable or disable usage of length 64 transforms in any |
| * direction. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_TX64 = 80, |
| |
| /*!\brief Codec control function to turn on / off flip and identity |
| * transforms, int parameter |
| * |
| * This will enable or disable usage of flip and identity transform |
| * types in any direction. If enabled, this includes: |
| * - FLIPADST_DCT |
| * - DCT_FLIPADST |
| * - FLIPADST_FLIPADST |
| * - ADST_FLIPADST |
| * - FLIPADST_ADST |
| * - IDTX |
| * - V_DCT |
| * - H_DCT |
| * - V_ADST |
| * - H_ADST |
| * - V_FLIPADST |
| * - H_FLIPADST |
| * |
| * Valid values: |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_FLIP_IDTX = 81, |
| |
| /*!\brief Codec control function to turn on / off rectangular transforms, int |
| * parameter |
| * |
| * This will enable or disable usage of rectangular transforms. NOTE: |
| * Rectangular transforms only enabled when corresponding rectangular |
| * partitions are. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_RECT_TX = 82, |
| |
| /*!\brief Codec control function to turn on / off dist-wtd compound mode |
| * at sequence level, int parameter |
| * |
| * This will enable or disable distance-weighted compound mode. |
| * \attention If AV1E_SET_ENABLE_ORDER_HINT is 0, then this flag is forced |
| * to 0. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_DIST_WTD_COMP = 83, |
| |
| /*!\brief Codec control function to turn on / off ref frame mvs (mfmv) usage |
| * at sequence level, int parameter |
| * |
| * \attention If AV1E_SET_ENABLE_ORDER_HINT is 0, then this flag is forced |
| * to 0. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_REF_FRAME_MVS = 84, |
| |
| /*!\brief Codec control function to set temporal mv prediction |
| * enabling/disabling at frame level, int parameter |
| * |
| * \attention If AV1E_SET_ENABLE_REF_FRAME_MVS is 0, then this flag is |
| * forced to 0. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ALLOW_REF_FRAME_MVS = 85, |
| |
| /*!\brief Codec control function to turn on / off dual interpolation filter |
| * for a sequence, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable |
| */ |
| AV1E_SET_ENABLE_DUAL_FILTER = 86, |
| |
| /*!\brief Codec control function to turn on / off delta quantization in chroma |
| * planes for a sequence, int parameter |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AV1E_SET_ENABLE_CHROMA_DELTAQ = 87, |
| |
| /*!\brief Codec control function to turn on / off masked compound usage |
| * (wedge and diff-wtd compound modes) for a sequence, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_MASKED_COMP = 88, |
| |
| /*!\brief Codec control function to turn on / off one sided compound usage |
| * for a sequence, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_ONESIDED_COMP = 89, |
| |
| /*!\brief Codec control function to turn on / off interintra compound |
| * for a sequence, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_INTERINTRA_COMP = 90, |
| |
| /*!\brief Codec control function to turn on / off smooth inter-intra |
| * mode for a sequence, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_SMOOTH_INTERINTRA = 91, |
| |
| /*!\brief Codec control function to turn on / off difference weighted |
| * compound, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_DIFF_WTD_COMP = 92, |
| |
| /*!\brief Codec control function to turn on / off interinter wedge |
| * compound, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_INTERINTER_WEDGE = 93, |
| |
| /*!\brief Codec control function to turn on / off interintra wedge |
| * compound, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_INTERINTRA_WEDGE = 94, |
| |
| /*!\brief Codec control function to turn on / off global motion usage |
| * for a sequence, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| * |
| * \note Excluded from CONFIG_REALTIME_ONLY build. |
| */ |
| AV1E_SET_ENABLE_GLOBAL_MOTION = 95, |
| |
| /*!\brief Codec control function to turn on / off warped motion usage |
| * at sequence level, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| * |
| * \note Excluded from CONFIG_REALTIME_ONLY build. |
| */ |
| AV1E_SET_ENABLE_WARPED_MOTION = 96, |
| |
| /*!\brief Codec control function to turn on / off warped motion usage |
| * at frame level, int parameter |
| * |
| * \attention If AV1E_SET_ENABLE_WARPED_MOTION is 0, then this flag is |
| * forced to 0. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| * |
| * \note Excluded from CONFIG_REALTIME_ONLY build. |
| */ |
| AV1E_SET_ALLOW_WARPED_MOTION = 97, |
| |
| /*!\brief Codec control function to turn on / off filter intra usage at |
| * sequence level, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_FILTER_INTRA = 98, |
| |
| /*!\brief Codec control function to turn on / off smooth intra modes usage, |
| * int parameter |
| * |
| * This will enable or disable usage of smooth, smooth_h and smooth_v intra |
| * modes. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_SMOOTH_INTRA = 99, |
| |
| /*!\brief Codec control function to turn on / off Paeth intra mode usage, int |
| * parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_PAETH_INTRA = 100, |
| |
| /*!\brief Codec control function to turn on / off CFL uv intra mode usage, int |
| * parameter |
| * |
| * This will enable or disable usage of chroma-from-luma intra mode. |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_CFL_INTRA = 101, |
| |
| /*!\brief Codec control function to turn on / off frame superresolution, int |
| * parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_SUPERRES = 102, |
| |
| /*!\brief Codec control function to turn on / off overlay frames for |
| * filtered ALTREF frames, int parameter |
| * |
| * This will enable or disable coding of overlay frames for filtered ALTREF |
| * frames. When set to 0, overlay frames are not used but show existing frame |
| * is used to display the filtered ALTREF frame as is. As a result the decoded |
| * frame rate remains the same as the display frame rate. The default is 1. |
| */ |
| AV1E_SET_ENABLE_OVERLAY = 103, |
| |
| /*!\brief Codec control function to turn on/off palette mode, int parameter */ |
| AV1E_SET_ENABLE_PALETTE = 104, |
| |
| /*!\brief Codec control function to turn on/off intra block copy mode, int |
| parameter */ |
| AV1E_SET_ENABLE_INTRABC = 105, |
| |
| /*!\brief Codec control function to turn on/off intra angle delta, int |
| parameter */ |
| AV1E_SET_ENABLE_ANGLE_DELTA = 106, |
| |
| /*!\brief Codec control function to set the delta q mode, unsigned int |
| * parameter |
| * |
| * AV1 supports a delta q mode feature, that allows modulating q per |
| * superblock. |
| * |
| * - 0 = deltaq signaling off |
| * - 1 = use modulation to maximize objective quality (default) |
| * - 2 = use modulation for local test |
| * - 3 = use modulation for key frame perceptual quality optimization |
| * - 4 = use modulation for user rating based perceptual quality optimization |
| */ |
| AV1E_SET_DELTAQ_MODE = 107, |
| |
| /*!\brief Codec control function to turn on/off loopfilter modulation |
| * when delta q modulation is enabled, unsigned int parameter. |
| * |
| * \attention AV1 only supports loopfilter modulation when delta q |
| * modulation is enabled as well. |
| */ |
| AV1E_SET_DELTALF_MODE = 108, |
| |
| /*!\brief Codec control function to set the single tile decoding mode, |
| * unsigned int parameter |
| * |
| * \attention Only applicable if large scale tiling is on. |
| * |
| * - 0 = single tile decoding is off |
| * - 1 = single tile decoding is on (default) |
| */ |
| AV1E_SET_SINGLE_TILE_DECODING = 109, |
| |
| /*!\brief Codec control function to enable the extreme motion vector unit |
| * test, unsigned int parameter |
| * |
| * - 0 = off |
| * - 1 = MAX_EXTREME_MV |
| * - 2 = MIN_EXTREME_MV |
| * |
| * \note This is only used in motion vector unit test. |
| */ |
| AV1E_ENABLE_MOTION_VECTOR_UNIT_TEST = 110, |
| |
| /*!\brief Codec control function to signal picture timing info in the |
| * bitstream, aom_timing_info_type_t parameter. Default is |
| * AOM_TIMING_UNSPECIFIED. |
| */ |
| AV1E_SET_TIMING_INFO_TYPE = 111, |
| |
| /*!\brief Codec control function to add film grain parameters (one of several |
| * preset types) info in the bitstream, int parameter |
| * |
| Valid range: 0..16, 0 is unknown, 1..16 are test vectors |
| */ |
| AV1E_SET_FILM_GRAIN_TEST_VECTOR = 112, |
| |
| /*!\brief Codec control function to set the path to the film grain parameters, |
| * const char* parameter |
| */ |
| AV1E_SET_FILM_GRAIN_TABLE = 113, |
| |
| /*!\brief Sets the noise level, int parameter */ |
| AV1E_SET_DENOISE_NOISE_LEVEL = 114, |
| |
| /*!\brief Sets the denoisers block size, unsigned int parameter */ |
| AV1E_SET_DENOISE_BLOCK_SIZE = 115, |
| |
| /*!\brief Sets the chroma subsampling x value, unsigned int parameter */ |
| AV1E_SET_CHROMA_SUBSAMPLING_X = 116, |
| |
| /*!\brief Sets the chroma subsampling y value, unsigned int parameter */ |
| AV1E_SET_CHROMA_SUBSAMPLING_Y = 117, |
| |
| /*!\brief Control to use a reduced tx type set, int parameter */ |
| AV1E_SET_REDUCED_TX_TYPE_SET = 118, |
| |
| /*!\brief Control to use dct only for intra modes, int parameter */ |
| AV1E_SET_INTRA_DCT_ONLY = 119, |
| |
| /*!\brief Control to use dct only for inter modes, int parameter */ |
| AV1E_SET_INTER_DCT_ONLY = 120, |
| |
| /*!\brief Control to use default tx type only for intra modes, int parameter |
| */ |
| AV1E_SET_INTRA_DEFAULT_TX_ONLY = 121, |
| |
| /*!\brief Control to use adaptive quantize_b, int parameter */ |
| AV1E_SET_QUANT_B_ADAPT = 122, |
| |
| /*!\brief Control to select maximum height for the GF group pyramid structure, |
| * unsigned int parameter |
| * |
| * Valid range: 0..5 |
| */ |
| AV1E_SET_GF_MAX_PYRAMID_HEIGHT = 123, |
| |
| /*!\brief Control to select maximum reference frames allowed per frame, int |
| * parameter |
| * |
| * Valid range: 3..7 |
| */ |
| AV1E_SET_MAX_REFERENCE_FRAMES = 124, |
| |
| /*!\brief Control to use reduced set of single and compound references, int |
| parameter */ |
| AV1E_SET_REDUCED_REFERENCE_SET = 125, |
| |
| /*!\brief Control to set frequency of the cost updates for coefficients, |
| * unsigned int parameter |
| * |
| * - 0 = update at SB level (default) |
| * - 1 = update at SB row level in tile |
| * - 2 = update at tile level |
| * - 3 = turn off |
| */ |
| AV1E_SET_COEFF_COST_UPD_FREQ = 126, |
| |
| /*!\brief Control to set frequency of the cost updates for mode, unsigned int |
| * parameter |
| * |
| * - 0 = update at SB level (default) |
| * - 1 = update at SB row level in tile |
| * - 2 = update at tile level |
| * - 3 = turn off |
| */ |
| AV1E_SET_MODE_COST_UPD_FREQ = 127, |
| |
| /*!\brief Control to set frequency of the cost updates for motion vectors, |
| * unsigned int parameter |
| * |
| * - 0 = update at SB level (default) |
| * - 1 = update at SB row level in tile |
| * - 2 = update at tile level |
| * - 3 = turn off |
| */ |
| AV1E_SET_MV_COST_UPD_FREQ = 128, |
| |
| /*!\brief Control to set bit mask that specifies which tier each of the 32 |
| * possible operating points conforms to, unsigned int parameter |
| * |
| * - 0 = main tier (default) |
| * - 1 = high tier |
| */ |
| AV1E_SET_TIER_MASK = 129, |
| |
| /*!\brief Control to set minimum compression ratio, unsigned int parameter |
| * Take integer values. If non-zero, encoder will try to keep the compression |
| * ratio of each frame to be higher than the given value divided by 100. |
| * E.g. 850 means minimum compression ratio of 8.5. |
| */ |
| AV1E_SET_MIN_CR = 130, |
| |
| /* NOTE: enums 145-149 unused */ |
| |
| /*!\brief Codec control function to set the layer id, aom_svc_layer_id_t* |
| * parameter |
| */ |
| AV1E_SET_SVC_LAYER_ID = 131, |
| |
| /*!\brief Codec control function to set SVC parameters, aom_svc_params_t* |
| * parameter |
| */ |
| AV1E_SET_SVC_PARAMS = 132, |
| |
| /*!\brief Codec control function to set reference frame config: |
| * the ref_idx and the refresh flags for each buffer slot. |
| * aom_svc_ref_frame_config_t* parameter |
| */ |
| AV1E_SET_SVC_REF_FRAME_CONFIG = 133, |
| |
| /*!\brief Codec control function to set the path to the VMAF model used when |
| * tuning the encoder for VMAF, const char* parameter |
| */ |
| AV1E_SET_VMAF_MODEL_PATH = 134, |
| |
| /*!\brief Codec control function to enable EXT_TILE_DEBUG in AV1 encoder, |
| * unsigned int parameter |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| * |
| * \note This is only used in lightfield example test. |
| */ |
| AV1E_ENABLE_EXT_TILE_DEBUG = 135, |
| |
| /*!\brief Codec control function to enable the superblock multipass unit test |
| * in AV1 to ensure that the encoder does not leak state between different |
| * passes. unsigned int parameter. |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| * |
| * \note This is only used in sb_multipass unit test. |
| */ |
| AV1E_ENABLE_SB_MULTIPASS_UNIT_TEST = 136, |
| |
| /*!\brief Control to select minimum height for the GF group pyramid structure, |
| * unsigned int parameter |
| * |
| * Valid values: 0..5 |
| */ |
| AV1E_SET_GF_MIN_PYRAMID_HEIGHT = 137, |
| |
| /*!\brief Control to set average complexity of the corpus in the case of |
| * single pass vbr based on LAP, unsigned int parameter |
| */ |
| AV1E_SET_VBR_CORPUS_COMPLEXITY_LAP = 138, |
| |
| /*!\brief Control to get baseline gf interval |
| */ |
| AV1E_GET_BASELINE_GF_INTERVAL = 139, |
| |
| /*\brief Control to set encoding the denoised frame from denoise-noise-level |
| * |
| * - 0 = disabled/encode the original frame |
| * - 1 = enabled/encode the denoised frame (default) |
| */ |
| AV1E_SET_ENABLE_DNL_DENOISING = 140, |
| |
| /*!\brief Codec control function to turn on / off D45 to D203 intra mode |
| * usage, int parameter |
| * |
| * This will enable or disable usage of D45 to D203 intra modes, which are a |
| * subset of directional modes. This control has no effect if directional |
| * modes are disabled (AV1E_SET_ENABLE_DIRECTIONAL_INTRA set to 0). |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_DIAGONAL_INTRA = 141, |
| |
| /*!\brief Control to set frequency of the cost updates for intrabc motion |
| * vectors, unsigned int parameter |
| * |
| * - 0 = update at SB level (default) |
| * - 1 = update at SB row level in tile |
| * - 2 = update at tile level |
| * - 3 = turn off |
| */ |
| AV1E_SET_DV_COST_UPD_FREQ = 142, |
| |
| /*!\brief Codec control to set the path for partition stats read and write. |
| * const char * parameter. |
| */ |
| AV1E_SET_PARTITION_INFO_PATH = 143, |
| |
| /*!\brief Codec control to use an external partition model |
| * A set of callback functions is passed through this control |
| * to let the encoder encode with given partitions. |
| */ |
| AV1E_SET_EXTERNAL_PARTITION = 144, |
| |
| /*!\brief Codec control function to turn on / off directional intra mode |
| * usage, int parameter |
| * |
| * - 0 = disable |
| * - 1 = enable (default) |
| */ |
| AV1E_SET_ENABLE_DIRECTIONAL_INTRA = 145, |
| |
| /*!\brief Control to turn on / off transform size search. |
| * Note: it can not work with non RD pick mode in real-time encoding, |
| * where the max transform size is only 16x16. |
| * It will be ignored if non RD pick mode is set. |
| * |
| * - 0 = disable, transforms always have the largest possible size |
| * - 1 = enable, search for the best transform size for each block (default) |
| */ |
| AV1E_SET_ENABLE_TX_SIZE_SEARCH = 146, |
| |
| /*!\brief Codec control function to set reference frame compound prediction. |
| * aom_svc_ref_frame_comp_pred_t* parameter |
| */ |
| AV1E_SET_SVC_REF_FRAME_COMP_PRED = 147, |
| |
| /*!\brief Set --deltaq-mode strength. |
| * |
| * Valid range: [0, 1000] |
| */ |
| AV1E_SET_DELTAQ_STRENGTH = 148, |
| |
| /*!\brief Codec control to control loop filter |
| * |
| * - 0 = Loop filter is disabled for all frames |
| * - 1 = Loop filter is enabled for all frames |
| * - 2 = Loop filter is disabled for non-reference frames |
| * - 3 = Loop filter is disabled for the frames with low motion |
| */ |
| AV1E_SET_LOOPFILTER_CONTROL = 149, |
| |
| /*!\brief Codec control function to get the loopfilter chosen by the encoder, |
| * int* parameter |
| */ |
| AOME_GET_LOOPFILTER_LEVEL = 150, |
| |
| /*!\brief Codec control to automatically turn off several intra coding tools, |
| * unsigned int parameter |
| * - 0 = do not use the feature |
| * - 1 = enable the automatic decision to turn off several intra tools |
| */ |
| AV1E_SET_AUTO_INTRA_TOOLS_OFF = 151, |
| |
| /*!\brief Codec control function to set flag for rate control used by external |
| * encoders. |
| * - 1 = Enable rate control for external encoders. This will disable content |
| * dependency in rate control and cyclic refresh. |
| * - 0 = Default. Disable rate control for external encoders. |
| */ |
| AV1E_SET_RTC_EXTERNAL_RC = 152, |
| |
| /*!\brief Codec control function to enable frame parallel multi-threading |
| * of the encoder, unsigned int parameter |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| */ |
| AV1E_SET_FP_MT = 153, |
| |
| /*!\brief Codec control to enable actual frame parallel encode or |
| * simulation of frame parallel encode in FPMT unit test, unsigned int |
| * parameter |
| * |
| * - 0 = simulate frame parallel encode |
| * - 1 = actual frame parallel encode (default) |
| * |
| * \note This is only used in FPMT unit test. |
| */ |
| AV1E_SET_FP_MT_UNIT_TEST = 154, |
| |
| /*!\brief Codec control function to get the target sequence level index for |
| * each operating point. int* parameter. There can be at most 32 operating |
| * points. The results will be written into a provided integer array of |
| * sufficient size. If a target level is not set, the result will be 31. |
| * Please refer to https://aomediacodec.github.io/av1-spec/#levels for more |
| * details on level definitions and indices. |
| */ |
| AV1E_GET_TARGET_SEQ_LEVEL_IDX = 155, |
| |
| /*!\brief Codec control function to get the number of operating points. int* |
| * parameter. |
| */ |
| AV1E_GET_NUM_OPERATING_POINTS = 156, |
| |
| /*!\brief Codec control function to skip the application of post-processing |
| * filters on reconstructed frame, unsigned int parameter |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| * |
| * \attention For this value to be used aom_codec_enc_cfg_t::g_usage |
| * must be set to AOM_USAGE_ALL_INTRA. |
| */ |
| AV1E_SET_SKIP_POSTPROC_FILTERING = 157, |
| |
| /*!\brief Codec control function to enable the superblock level |
| * qp sweep in AV1 to ensure that end-to-end test runs well, |
| * unsigned int parameter. |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| * |
| * \note This is only used in sb_qp_sweep unit test. |
| */ |
| AV1E_ENABLE_SB_QP_SWEEP = 158, |
| |
| /*!\brief Codec control to set quantizer for the next frame, int parameter. |
| * |
| * - Valid range [0, 63] |
| * |
| * This will turn off cyclic refresh. Only applicable to 1-pass. |
| */ |
| AV1E_SET_QUANTIZER_ONE_PASS = 159, |
| |
| /*!\brief Codec control to enable the rate distribution guided delta |
| * quantization in all intra mode, unsigned int parameter |
| * |
| * - 0 = disable (default) |
| * - 1 = enable |
| * |
| * \attention This feature requires --deltaq-mode=3, also an input file |
| * which contains rate distribution for each 16x16 block, |
| * passed in by --rate-distribution-info=rate_distribution.txt. |
| */ |
| AV1E_ENABLE_RATE_GUIDE_DELTAQ = 160, |
| |
| /*!\brief Codec control to set the input file for rate distribution used |
| * in all intra mode, const char * parameter |
| * The input should be the name of a text file, which |
| * contains (rows x cols) float values separated by space. |
| * Each float value represent the number of bits for each 16x16 block. |
| * rows = (frame_height + 15) / 16 |
| * cols = (frame_width + 15) / 16 |
| * |
| * \attention This feature requires --enable-rate-guide-deltaq=1. |
| */ |
| AV1E_SET_RATE_DISTRIBUTION_INFO = 161, |
| |
| /*!\brief Codec control to get the CDEF strength for Y / luma plane, |
| * int * parameter. |
| * Returns an integer array of CDEF_MAX_STRENGTHS elements. |
| */ |
| AV1E_GET_LUMA_CDEF_STRENGTH = 162, |
| |
| /*!\brief Codec control to set the target bitrate in kilobits per second, |
| * unsigned int parameter. For 1 pass CBR mode, single layer encoding. |
| * This controls replaces the call aom_codec_enc_config_set(&codec, &cfg) |
| * when only target bitrate is changed, and so is much cheaper as it |
| * bypasses a lot of unneeded code checks. |
| */ |
| AV1E_SET_BITRATE_ONE_PASS_CBR = 163, |
| |
| /*!\brief Codec control to set the maxium number of consecutive frame drops |
| * allowed for the frame_dropper in 1 pass CBR mode. Value of zero has no |
| * effect. |
| */ |
| AV1E_SET_MAX_CONSEC_FRAME_DROP_CBR = 164, |
| |
| // Any new encoder control IDs should be added above. |
| // Maximum allowed encoder control ID is 229. |
| // No encoder control ID should be added below. |
| }; |
| |
| /*!\brief aom 1-D scaling mode |
| * |
| * This set of constants define 1-D aom scaling modes |
| */ |
| typedef enum aom_scaling_mode_1d { |
| AOME_NORMAL = 0, |
| AOME_FOURFIVE = 1, |
| AOME_THREEFIVE = 2, |
| AOME_THREEFOUR = 3, |
| AOME_ONEFOUR = 4, |
| AOME_ONEEIGHT = 5, |
| AOME_ONETWO = 6, |
| AOME_TWOTHREE = 7, |
| AOME_ONETHREE = 8 |
| } AOM_SCALING_MODE; |
| |
| /*!\brief Max number of segments |
| * |
| * This is the limit of number of segments allowed within a frame. |
| * |
| * Currently same as "MAX_SEGMENTS" in AV1, the maximum that AV1 supports. |
| * |
| */ |
| #define AOM_MAX_SEGMENTS 8 |
| |
| /*!\brief aom region of interest map |
| * |
| * These defines the data structures for the region of interest map |
| * |
| * TODO(yaowu): create a unit test for ROI map related APIs |
| * |
| */ |
| typedef struct aom_roi_map { |
| /*! An id between 0 and 7 for each 8x8 region within a frame. */ |
| unsigned char *roi_map; |
| unsigned int rows; /**< Number of rows. */ |
| unsigned int cols; /**< Number of columns. */ |
| int delta_q[AOM_MAX_SEGMENTS]; /**< Quantizer deltas. */ |
| int delta_lf[AOM_MAX_SEGMENTS]; /**< Loop filter deltas. */ |
| /*! Static breakout threshold for each segment. */ |
| unsigned int static_threshold[AOM_MAX_SEGMENTS]; |
| } aom_roi_map_t; |
| |
| /*!\brief aom active region map |
| * |
| * These defines the data structures for active region map |
| * |
| */ |
| |
| typedef struct aom_active_map { |
| /*!\brief specify an on (1) or off (0) each 16x16 region within a frame */ |
| unsigned char *active_map; |
| unsigned int rows; /**< number of rows */ |
| unsigned int cols; /**< number of cols */ |
| } aom_active_map_t; |
| |
| /*!\brief aom image scaling mode |
| * |
| * This defines the data structure for image scaling mode |
| * |
| */ |
| typedef struct aom_scaling_mode { |
| AOM_SCALING_MODE h_scaling_mode; /**< horizontal scaling mode */ |
| AOM_SCALING_MODE v_scaling_mode; /**< vertical scaling mode */ |
| } aom_scaling_mode_t; |
| |
| /*!brief AV1 encoder content type */ |
| typedef enum { |
| AOM_CONTENT_DEFAULT, |
| AOM_CONTENT_SCREEN, |
| AOM_CONTENT_FILM, |
| AOM_CONTENT_INVALID |
| } aom_tune_content; |
| |
| /*!brief AV1 encoder timing info type signaling */ |
| typedef enum { |
| AOM_TIMING_UNSPECIFIED, |
| AOM_TIMING_EQUAL, |
| AOM_TIMING_DEC_MODEL |
| } aom_timing_info_type_t; |
| |
| /*!\brief Model tuning parameters |
| * |
| * Changes the encoder to tune for certain types of input material. |
| * |
| */ |
| typedef enum { |
| AOM_TUNE_PSNR = 0, |
| AOM_TUNE_SSIM = 1, |
| /* NOTE: enums 2 and 3 unused */ |
| AOM_TUNE_VMAF_WITH_PREPROCESSING = 4, |
| AOM_TUNE_VMAF_WITHOUT_PREPROCESSING = 5, |
| AOM_TUNE_VMAF_MAX_GAIN = 6, |
| AOM_TUNE_VMAF_NEG_MAX_GAIN = 7, |
| AOM_TUNE_BUTTERAUGLI = 8, |
| AOM_TUNE_VMAF_SALIENCY_MAP = 9, |
| } aom_tune_metric; |
| |
| /*!\brief Distortion metric to use for RD optimization. |
| * |
| * Changes the encoder to use a different distortion metric for RD search. Note |
| * that this value operates on a "lower level" compared to aom_tune_metric - it |
| * affects the distortion metric inside a block, while aom_tune_metric only |
| * affects RD across blocks. |
| * |
| */ |
| typedef enum { |
| // Use PSNR for in-block rate-distortion optimization. |
| AOM_DIST_METRIC_PSNR, |
| // Use quantization matrix-weighted PSNR for in-block rate-distortion |
| // optimization. If --enable-qm=1 is not specified, this falls back to |
| // behaving in the same way as AOM_DIST_METRIC_PSNR. |
| AOM_DIST_METRIC_QM_PSNR, |
| } aom_dist_metric; |
| |
| #define AOM_MAX_LAYERS 32 /**< Max number of layers */ |
| #define AOM_MAX_SS_LAYERS 4 /**< Max number of spatial layers */ |
| #define AOM_MAX_TS_LAYERS 8 /**< Max number of temporal layers */ |
| |
| /*!brief Struct for spatial and temporal layer ID */ |
| typedef struct aom_svc_layer_id { |
| int spatial_layer_id; /**< Spatial layer ID */ |
| int temporal_layer_id; /**< Temporal layer ID */ |
| } aom_svc_layer_id_t; |
| |
| /*!brief Parameter type for SVC |
| * |
| * In the arrays of size AOM_MAX_LAYERS, the index for spatial layer `sl` and |
| * temporal layer `tl` is sl * number_temporal_layers + tl. |
| * |
| */ |
| typedef struct aom_svc_params { |
| int number_spatial_layers; /**< Number of spatial layers */ |
| int number_temporal_layers; /**< Number of temporal layers */ |
| int max_quantizers[AOM_MAX_LAYERS]; /**< Max Q for each layer */ |
| int min_quantizers[AOM_MAX_LAYERS]; /**< Min Q for each layer */ |
| int scaling_factor_num[AOM_MAX_SS_LAYERS]; /**< Scaling factor-numerator */ |
| int scaling_factor_den[AOM_MAX_SS_LAYERS]; /**< Scaling factor-denominator */ |
| /*! Target bitrate for each layer, in kilobits per second */ |
| int layer_target_bitrate[AOM_MAX_LAYERS]; |
| /*! Frame rate factor for each temporal layer */ |
| int framerate_factor[AOM_MAX_TS_LAYERS]; |
| } aom_svc_params_t; |
| |
| /*!brief Parameters for setting ref frame config */ |
| typedef struct aom_svc_ref_frame_config { |
| // 7 references: The index 0 - 6 refers to the references: |
| // last(0), last2(1), last3(2), golden(3), bwdref(4), altref2(5), altref(6). |
| int reference[7]; /**< Reference flag for each of the 7 references. */ |
| /*! Buffer slot index for each of 7 references indexed above. */ |
| int ref_idx[7]; |
| int refresh[8]; /**< Refresh flag for each of the 8 slots. */ |
| } aom_svc_ref_frame_config_t; |
| |
| /*!brief Parameters for setting ref frame compound prediction */ |
| typedef struct aom_svc_ref_frame_comp_pred { |
| // Use compound prediction for the ref_frame pairs GOLDEN_LAST (0), |
| // LAST2_LAST (1), and ALTREF_LAST (2). |
| int use_comp_pred[3]; /**<Compound reference flag. */ |
| } aom_svc_ref_frame_comp_pred_t; |
| |
| /*!\cond */ |
| /*!\brief Encoder control function parameter type |
| * |
| * Defines the data types that AOME/AV1E control functions take. |
| * |
| * \note Additional common controls are defined in aom.h. |
| * |
| * \note For each control ID "X", a macro-define of |
| * AOM_CTRL_X is provided. It is used at compile time to determine |
| * if the control ID is supported by the libaom library available, |
| * when the libaom version cannot be controlled. |
| */ |
| AOM_CTRL_USE_TYPE(AOME_USE_REFERENCE, int) |
| #define AOM_CTRL_AOME_USE_REFERENCE |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_ROI_MAP, aom_roi_map_t *) |
| #define AOM_CTRL_AOME_SET_ROI_MAP |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_ACTIVEMAP, aom_active_map_t *) |
| #define AOM_CTRL_AOME_SET_ACTIVEMAP |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_SCALEMODE, aom_scaling_mode_t *) |
| #define AOM_CTRL_AOME_SET_SCALEMODE |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_SPATIAL_LAYER_ID, int) |
| #define AOM_CTRL_AOME_SET_SPATIAL_LAYER_ID |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_CPUUSED, int) |
| #define AOM_CTRL_AOME_SET_CPUUSED |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_ENABLEAUTOALTREF, unsigned int) |
| #define AOM_CTRL_AOME_SET_ENABLEAUTOALTREF |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_SHARPNESS, unsigned int) |
| #define AOM_CTRL_AOME_SET_SHARPNESS |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_STATIC_THRESHOLD, unsigned int) |
| #define AOM_CTRL_AOME_SET_STATIC_THRESHOLD |
| |
| AOM_CTRL_USE_TYPE(AOME_GET_LAST_QUANTIZER, int *) |
| #define AOM_CTRL_AOME_GET_LAST_QUANTIZER |
| |
| AOM_CTRL_USE_TYPE(AOME_GET_LAST_QUANTIZER_64, int *) |
| #define AOM_CTRL_AOME_GET_LAST_QUANTIZER_64 |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_ARNR_MAXFRAMES, unsigned int) |
| #define AOM_CTRL_AOME_SET_ARNR_MAXFRAMES |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_ARNR_STRENGTH, unsigned int) |
| #define AOM_CTRL_AOME_SET_ARNR_STRENGTH |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_TUNING, int) /* aom_tune_metric */ |
| #define AOM_CTRL_AOME_SET_TUNING |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_CQ_LEVEL, unsigned int) |
| #define AOM_CTRL_AOME_SET_CQ_LEVEL |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_MAX_INTRA_BITRATE_PCT, unsigned int) |
| #define AOM_CTRL_AOME_SET_MAX_INTRA_BITRATE_PCT |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_NUMBER_SPATIAL_LAYERS, int) |
| #define AOM_CTRL_AOME_SET_NUMBER_SPATIAL_LAYERS |
| // TODO(aomedia:3231): Deprecated. Remove it. |
| #define AOME_CTRL_AOME_SET_NUMBER_SPATIAL_LAYERS |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_MAX_INTER_BITRATE_PCT, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MAX_INTER_BITRATE_PCT |
| // TODO(aomedia:3231): Deprecated. Remove it. |
| #define AOM_CTRL_AOME_SET_MAX_INTER_BITRATE_PCT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_GF_CBR_BOOST_PCT, unsigned int) |
| #define AOM_CTRL_AV1E_SET_GF_CBR_BOOST_PCT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_LOSSLESS, unsigned int) |
| #define AOM_CTRL_AV1E_SET_LOSSLESS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ROW_MT, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ROW_MT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_TILE_COLUMNS, unsigned int) |
| #define AOM_CTRL_AV1E_SET_TILE_COLUMNS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_TILE_ROWS, unsigned int) |
| #define AOM_CTRL_AV1E_SET_TILE_ROWS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_TPL_MODEL, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_TPL_MODEL |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_KEYFRAME_FILTERING, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_KEYFRAME_FILTERING |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_FRAME_PARALLEL_DECODING, unsigned int) |
| #define AOM_CTRL_AV1E_SET_FRAME_PARALLEL_DECODING |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ERROR_RESILIENT_MODE, int) |
| #define AOM_CTRL_AV1E_SET_ERROR_RESILIENT_MODE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_S_FRAME_MODE, int) |
| #define AOM_CTRL_AV1E_SET_S_FRAME_MODE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_AQ_MODE, unsigned int) |
| #define AOM_CTRL_AV1E_SET_AQ_MODE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_FRAME_PERIODIC_BOOST, unsigned int) |
| #define AOM_CTRL_AV1E_SET_FRAME_PERIODIC_BOOST |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_NOISE_SENSITIVITY, unsigned int) |
| #define AOM_CTRL_AV1E_SET_NOISE_SENSITIVITY |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_TUNE_CONTENT, int) /* aom_tune_content */ |
| #define AOM_CTRL_AV1E_SET_TUNE_CONTENT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_CDF_UPDATE_MODE, unsigned int) |
| #define AOM_CTRL_AV1E_SET_CDF_UPDATE_MODE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_COLOR_PRIMARIES, int) |
| #define AOM_CTRL_AV1E_SET_COLOR_PRIMARIES |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_TRANSFER_CHARACTERISTICS, int) |
| #define AOM_CTRL_AV1E_SET_TRANSFER_CHARACTERISTICS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MATRIX_COEFFICIENTS, int) |
| #define AOM_CTRL_AV1E_SET_MATRIX_COEFFICIENTS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_CHROMA_SAMPLE_POSITION, int) |
| #define AOM_CTRL_AV1E_SET_CHROMA_SAMPLE_POSITION |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MIN_GF_INTERVAL, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MIN_GF_INTERVAL |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MAX_GF_INTERVAL, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MAX_GF_INTERVAL |
| |
| AOM_CTRL_USE_TYPE(AV1E_GET_ACTIVEMAP, aom_active_map_t *) |
| #define AOM_CTRL_AV1E_GET_ACTIVEMAP |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_COLOR_RANGE, int) |
| #define AOM_CTRL_AV1E_SET_COLOR_RANGE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_RENDER_SIZE, int *) |
| #define AOM_CTRL_AV1E_SET_RENDER_SIZE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_TARGET_SEQ_LEVEL_IDX, int) |
| #define AOM_CTRL_AV1E_SET_TARGET_SEQ_LEVEL_IDX |
| |
| AOM_CTRL_USE_TYPE(AV1E_GET_SEQ_LEVEL_IDX, int *) |
| #define AOM_CTRL_AV1E_GET_SEQ_LEVEL_IDX |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_SUPERBLOCK_SIZE, unsigned int) |
| #define AOM_CTRL_AV1E_SET_SUPERBLOCK_SIZE |
| |
| AOM_CTRL_USE_TYPE(AOME_SET_ENABLEAUTOBWDREF, unsigned int) |
| #define AOM_CTRL_AOME_SET_ENABLEAUTOBWDREF |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_CDEF, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_CDEF |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_RESTORATION, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_RESTORATION |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_FORCE_VIDEO_MODE, unsigned int) |
| #define AOM_CTRL_AV1E_SET_FORCE_VIDEO_MODE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_OBMC, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_OBMC |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_DISABLE_TRELLIS_QUANT, unsigned int) |
| #define AOM_CTRL_AV1E_SET_DISABLE_TRELLIS_QUANT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_QM, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_QM |
| |
| // TODO(aomedia:3231): Remove these two lines. |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_DIST_8X8, unsigned int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_DIST_8X8 |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_QM_MIN, unsigned int) |
| #define AOM_CTRL_AV1E_SET_QM_MIN |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_QM_MAX, unsigned int) |
| #define AOM_CTRL_AV1E_SET_QM_MAX |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_QM_Y, unsigned int) |
| #define AOM_CTRL_AV1E_SET_QM_Y |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_QM_U, unsigned int) |
| #define AOM_CTRL_AV1E_SET_QM_U |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_QM_V, unsigned int) |
| #define AOM_CTRL_AV1E_SET_QM_V |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_NUM_TG, unsigned int) |
| #define AOM_CTRL_AV1E_SET_NUM_TG |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MTU, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MTU |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_RECT_PARTITIONS, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_RECT_PARTITIONS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_AB_PARTITIONS, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_AB_PARTITIONS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_1TO4_PARTITIONS, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_1TO4_PARTITIONS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MIN_PARTITION_SIZE, int) |
| #define AOM_CTRL_AV1E_SET_MIN_PARTITION_SIZE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MAX_PARTITION_SIZE, int) |
| #define AOM_CTRL_AV1E_SET_MAX_PARTITION_SIZE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_INTRA_EDGE_FILTER, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_INTRA_EDGE_FILTER |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_ORDER_HINT, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_ORDER_HINT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_TX64, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_TX64 |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_FLIP_IDTX, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_FLIP_IDTX |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_RECT_TX, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_RECT_TX |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_DIST_WTD_COMP, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_DIST_WTD_COMP |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_REF_FRAME_MVS, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_REF_FRAME_MVS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ALLOW_REF_FRAME_MVS, int) |
| #define AOM_CTRL_AV1E_SET_ALLOW_REF_FRAME_MVS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_DUAL_FILTER, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_DUAL_FILTER |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_CHROMA_DELTAQ, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_CHROMA_DELTAQ |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_MASKED_COMP, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_MASKED_COMP |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_ONESIDED_COMP, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_ONESIDED_COMP |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_INTERINTRA_COMP, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_INTERINTRA_COMP |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_SMOOTH_INTERINTRA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_SMOOTH_INTERINTRA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_DIFF_WTD_COMP, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_DIFF_WTD_COMP |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_INTERINTER_WEDGE, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_INTERINTER_WEDGE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_INTERINTRA_WEDGE, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_INTERINTRA_WEDGE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_GLOBAL_MOTION, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_GLOBAL_MOTION |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_WARPED_MOTION, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_WARPED_MOTION |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ALLOW_WARPED_MOTION, int) |
| #define AOM_CTRL_AV1E_SET_ALLOW_WARPED_MOTION |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_FILTER_INTRA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_FILTER_INTRA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_SMOOTH_INTRA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_SMOOTH_INTRA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_PAETH_INTRA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_PAETH_INTRA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_CFL_INTRA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_CFL_INTRA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_SUPERRES, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_SUPERRES |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_OVERLAY, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_OVERLAY |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_PALETTE, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_PALETTE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_INTRABC, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_INTRABC |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_ANGLE_DELTA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_ANGLE_DELTA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_DELTAQ_MODE, unsigned int) |
| #define AOM_CTRL_AV1E_SET_DELTAQ_MODE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_DELTALF_MODE, unsigned int) |
| #define AOM_CTRL_AV1E_SET_DELTALF_MODE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_SINGLE_TILE_DECODING, unsigned int) |
| #define AOM_CTRL_AV1E_SET_SINGLE_TILE_DECODING |
| |
| AOM_CTRL_USE_TYPE(AV1E_ENABLE_MOTION_VECTOR_UNIT_TEST, unsigned int) |
| #define AOM_CTRL_AV1E_ENABLE_MOTION_VECTOR_UNIT_TEST |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_TIMING_INFO_TYPE, int) /* aom_timing_info_type_t */ |
| #define AOM_CTRL_AV1E_SET_TIMING_INFO_TYPE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_FILM_GRAIN_TEST_VECTOR, int) |
| #define AOM_CTRL_AV1E_SET_FILM_GRAIN_TEST_VECTOR |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_FILM_GRAIN_TABLE, const char *) |
| #define AOM_CTRL_AV1E_SET_FILM_GRAIN_TABLE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_DENOISE_NOISE_LEVEL, int) |
| #define AOM_CTRL_AV1E_SET_DENOISE_NOISE_LEVEL |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_DENOISE_BLOCK_SIZE, unsigned int) |
| #define AOM_CTRL_AV1E_SET_DENOISE_BLOCK_SIZE |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_CHROMA_SUBSAMPLING_X, unsigned int) |
| #define AOM_CTRL_AV1E_SET_CHROMA_SUBSAMPLING_X |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_CHROMA_SUBSAMPLING_Y, unsigned int) |
| #define AOM_CTRL_AV1E_SET_CHROMA_SUBSAMPLING_Y |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_REDUCED_TX_TYPE_SET, int) |
| #define AOM_CTRL_AV1E_SET_REDUCED_TX_TYPE_SET |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_INTRA_DCT_ONLY, int) |
| #define AOM_CTRL_AV1E_SET_INTRA_DCT_ONLY |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_INTER_DCT_ONLY, int) |
| #define AOM_CTRL_AV1E_SET_INTER_DCT_ONLY |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_INTRA_DEFAULT_TX_ONLY, int) |
| #define AOM_CTRL_AV1E_SET_INTRA_DEFAULT_TX_ONLY |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_QUANT_B_ADAPT, int) |
| #define AOM_CTRL_AV1E_SET_QUANT_B_ADAPT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_GF_MAX_PYRAMID_HEIGHT, unsigned int) |
| #define AOM_CTRL_AV1E_SET_GF_MAX_PYRAMID_HEIGHT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MAX_REFERENCE_FRAMES, int) |
| #define AOM_CTRL_AV1E_SET_MAX_REFERENCE_FRAMES |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_REDUCED_REFERENCE_SET, int) |
| #define AOM_CTRL_AV1E_SET_REDUCED_REFERENCE_SET |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_COEFF_COST_UPD_FREQ, unsigned int) |
| #define AOM_CTRL_AV1E_SET_COEFF_COST_UPD_FREQ |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MODE_COST_UPD_FREQ, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MODE_COST_UPD_FREQ |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MV_COST_UPD_FREQ, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MV_COST_UPD_FREQ |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_TIER_MASK, unsigned int) |
| #define AOM_CTRL_AV1E_SET_TIER_MASK |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MIN_CR, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MIN_CR |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_SVC_LAYER_ID, aom_svc_layer_id_t *) |
| #define AOM_CTRL_AV1E_SET_SVC_LAYER_ID |
| // TODO(aomedia:3231): Deprecated. Remove it. |
| #define AOME_CTRL_AV1E_SET_SVC_LAYER_ID |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_SVC_PARAMS, aom_svc_params_t *) |
| #define AOM_CTRL_AV1E_SET_SVC_PARAMS |
| // TODO(aomedia:3231): Deprecated. Remove it. |
| #define AOME_CTRL_AV1E_SET_SVC_PARAMS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_SVC_REF_FRAME_CONFIG, aom_svc_ref_frame_config_t *) |
| #define AOM_CTRL_AV1E_SET_SVC_REF_FRAME_CONFIG |
| // TODO(aomedia:3231): Deprecated. Remove it. |
| #define AOME_CTRL_AV1E_SET_SVC_REF_FRAME_CONFIG |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_VMAF_MODEL_PATH, const char *) |
| #define AOM_CTRL_AV1E_SET_VMAF_MODEL_PATH |
| |
| AOM_CTRL_USE_TYPE(AV1E_ENABLE_EXT_TILE_DEBUG, unsigned int) |
| #define AOM_CTRL_AV1E_ENABLE_EXT_TILE_DEBUG |
| |
| AOM_CTRL_USE_TYPE(AV1E_ENABLE_SB_MULTIPASS_UNIT_TEST, unsigned int) |
| #define AOM_CTRL_AV1E_ENABLE_SB_MULTIPASS_UNIT_TEST |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_GF_MIN_PYRAMID_HEIGHT, unsigned int) |
| #define AOM_CTRL_AV1E_SET_GF_MIN_PYRAMID_HEIGHT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_VBR_CORPUS_COMPLEXITY_LAP, unsigned int) |
| #define AOM_CTRL_AV1E_SET_VBR_CORPUS_COMPLEXITY_LAP |
| |
| AOM_CTRL_USE_TYPE(AV1E_GET_BASELINE_GF_INTERVAL, int *) |
| #define AOM_CTRL_AV1E_GET_BASELINE_GF_INTERVAL |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_DNL_DENOISING, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_DNL_DENOISING |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_DIAGONAL_INTRA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_DIAGONAL_INTRA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_DV_COST_UPD_FREQ, unsigned int) |
| #define AOM_CTRL_AV1E_SET_DV_COST_UPD_FREQ |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_PARTITION_INFO_PATH, const char *) |
| #define AOM_CTRL_AV1E_SET_PARTITION_INFO_PATH |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_EXTERNAL_PARTITION, aom_ext_part_funcs_t *) |
| #define AOM_CTRL_AV1E_SET_EXTERNAL_PARTITION |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_DIRECTIONAL_INTRA, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_DIRECTIONAL_INTRA |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_TX_SIZE_SEARCH, int) |
| #define AOM_CTRL_AV1E_SET_ENABLE_TX_SIZE_SEARCH |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_SVC_REF_FRAME_COMP_PRED, |
| aom_svc_ref_frame_comp_pred_t *) |
| #define AOM_CTRL_AV1E_SET_SVC_REF_FRAME_COMP_PRED |
| // TODO(aomedia:3231): Deprecated. Remove it. |
| #define AOME_CTRL_AV1E_SET_SVC_REF_FRAME_COMP_PRED |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_DELTAQ_STRENGTH, unsigned int) |
| #define AOM_CTRL_AV1E_SET_DELTAQ_STRENGTH |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_LOOPFILTER_CONTROL, int) |
| #define AOM_CTRL_AV1E_SET_LOOPFILTER_CONTROL |
| |
| AOM_CTRL_USE_TYPE(AOME_GET_LOOPFILTER_LEVEL, int *) |
| #define AOM_CTRL_AOME_GET_LOOPFILTER_LEVEL |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_AUTO_INTRA_TOOLS_OFF, unsigned int) |
| #define AOM_CTRL_AV1E_SET_AUTO_INTRA_TOOLS_OFF |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_RTC_EXTERNAL_RC, int) |
| #define AOM_CTRL_AV1E_SET_RTC_EXTERNAL_RC |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_FP_MT, unsigned int) |
| #define AOM_CTRL_AV1E_SET_FP_MT |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_FP_MT_UNIT_TEST, unsigned int) |
| #define AOM_CTRL_AV1E_SET_FP_MT_UNIT_TEST |
| |
| AOM_CTRL_USE_TYPE(AV1E_GET_TARGET_SEQ_LEVEL_IDX, int *) |
| #define AOM_CTRL_AV1E_GET_TARGET_SEQ_LEVEL_IDX |
| |
| AOM_CTRL_USE_TYPE(AV1E_GET_NUM_OPERATING_POINTS, int *) |
| #define AOM_CTRL_AV1E_GET_NUM_OPERATING_POINTS |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_SKIP_POSTPROC_FILTERING, unsigned int) |
| #define AOM_CTRL_AV1E_SET_SKIP_POSTPROC_FILTERING |
| |
| AOM_CTRL_USE_TYPE(AV1E_ENABLE_SB_QP_SWEEP, unsigned int) |
| #define AOM_CTRL_AV1E_ENABLE_SB_QP_SWEEP |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_QUANTIZER_ONE_PASS, int) |
| #define AOM_CTRL_AV1E_SET_QUANTIZER_ONE_PASS |
| |
| AOM_CTRL_USE_TYPE(AV1E_ENABLE_RATE_GUIDE_DELTAQ, unsigned int) |
| #define AOM_CTRL_AV1E_ENABLE_RATE_GUIDE_DELTAQ |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_RATE_DISTRIBUTION_INFO, const char *) |
| #define AOM_CTRL_AV1E_SET_RATE_DISTRIBUTION_INFO |
| |
| AOM_CTRL_USE_TYPE(AV1E_GET_LUMA_CDEF_STRENGTH, int *) |
| #define AOM_CTRL_AV1E_GET_LUMA_CDEF_STRENGTH |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_BITRATE_ONE_PASS_CBR, unsigned int) |
| #define AOM_CTRL_AV1E_SET_BITRATE_ONE_PASS_CBR |
| |
| AOM_CTRL_USE_TYPE(AV1E_SET_MAX_CONSEC_FRAME_DROP_CBR, unsigned int) |
| #define AOM_CTRL_AV1E_SET_MAX_CONSEC_FRAME_DROP_CBR |
| |
| /*!\endcond */ |
| /*! @} - end defgroup aom_encoder */ |
| #ifdef __cplusplus |
| } // extern "C" |
| #endif |
| |
| #endif // AOM_AOM_AOMCX_H_ |