/* * 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..10. 0 runs the slowest, and 10 runs the fastest; * quality improves as speed decreases (since more compression * possibilities are explored). * * NOTE: 10 is 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, // 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: LAST_FRAME (0), LAST2_FRAME(1), LAST3_FRAME(2), // GOLDEN_FRAME(3), BWDREF_FRAME(4), ALTREF2_FRAME(5), ALTREF_FRAME(6). int reference[7]; /**< Reference flag for each of the 7 references. */ /*! Buffer slot index for each of 7 references. */ 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]; /**