blob: 42408acba1e82f6adce3b29bf680465807e0e776 [file] [log] [blame]
John Koleszar0ea50ce2010-05-18 11:58:33 -04001/*
Yaowu Xu9c01aa12016-09-01 14:32:49 -07002 * Copyright (c) 2016, Alliance for Open Media. All rights reserved
John Koleszar0ea50ce2010-05-18 11:58:33 -04003 *
Yaowu Xu9c01aa12016-09-01 14:32:49 -07004 * This source code is subject to the terms of the BSD 2 Clause License and
5 * the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License
6 * was not distributed with this source code in the LICENSE file, you can
7 * obtain it at www.aomedia.org/license/software. If the Alliance for Open
8 * Media Patent License 1.0 was not distributed with this source code in the
9 * PATENTS file, you can obtain it at www.aomedia.org/license/patent.
John Koleszar0ea50ce2010-05-18 11:58:33 -040010 */
Yaowu Xuf883b422016-08-30 14:01:10 -070011#ifndef AOM_AOMCX_H_
12#define AOM_AOMCX_H_
John Koleszar0ea50ce2010-05-18 11:58:33 -040013
Yaowu Xu9c01aa12016-09-01 14:32:49 -070014/*!\defgroup aom_encoder AOMedia AOM/AV1 Encoder
15 * \ingroup aom
John Koleszar0ea50ce2010-05-18 11:58:33 -040016 *
17 * @{
18 */
Yaowu Xuf883b422016-08-30 14:01:10 -070019#include "./aom.h"
20#include "./aom_encoder.h"
John Koleszar0ea50ce2010-05-18 11:58:33 -040021
James Zernf42d52e2011-02-16 17:54:49 -080022/*!\file
Yaowu Xu9c01aa12016-09-01 14:32:49 -070023 * \brief Provides definitions for using AOM or AV1 encoder algorithm within the
Yaowu Xuf883b422016-08-30 14:01:10 -070024 * aom Codec Interface.
John Koleszar0ea50ce2010-05-18 11:58:33 -040025 */
Dmitry Kovaleve288c602013-09-29 18:00:15 -070026
27#ifdef __cplusplus
28extern "C" {
29#endif
John Koleszar0ea50ce2010-05-18 11:58:33 -040030
Yaowu Xuf883b422016-08-30 14:01:10 -070031/*!\name Algorithm interface for AV1
Jingning Han3ee6db62015-08-05 19:00:31 -070032 *
Yaowu Xuf883b422016-08-30 14:01:10 -070033 * This interface provides the capability to encode raw AV1 streams.
Jingning Han3ee6db62015-08-05 19:00:31 -070034 * @{
35 */
Yaowu Xuf883b422016-08-30 14:01:10 -070036extern aom_codec_iface_t aom_codec_av1_cx_algo;
37extern aom_codec_iface_t *aom_codec_av1_cx(void);
Jingning Han3ee6db62015-08-05 19:00:31 -070038/*!@} - end algorithm interface member group*/
John Koleszar0952acb2010-06-01 11:14:25 -040039
John Koleszar0ea50ce2010-05-18 11:58:33 -040040/*
41 * Algorithm Flags
42 */
43
44/*!\brief Don't reference the last frame
45 *
46 * When this flag is set, the encoder will not use the last frame as a
47 * predictor. When not set, the encoder will choose whether to use the
48 * last frame or not automatically.
49 */
Yaowu Xuf883b422016-08-30 14:01:10 -070050#define AOM_EFLAG_NO_REF_LAST (1 << 16)
John Koleszar0ea50ce2010-05-18 11:58:33 -040051
52/*!\brief Don't reference the golden frame
53 *
54 * When this flag is set, the encoder will not use the golden frame as a
55 * predictor. When not set, the encoder will choose whether to use the
56 * golden frame or not automatically.
57 */
Yaowu Xuf883b422016-08-30 14:01:10 -070058#define AOM_EFLAG_NO_REF_GF (1 << 17)
John Koleszar0ea50ce2010-05-18 11:58:33 -040059
60/*!\brief Don't reference the alternate reference frame
61 *
62 * When this flag is set, the encoder will not use the alt ref frame as a
63 * predictor. When not set, the encoder will choose whether to use the
64 * alt ref frame or not automatically.
65 */
Yaowu Xuf883b422016-08-30 14:01:10 -070066#define AOM_EFLAG_NO_REF_ARF (1 << 21)
John Koleszar0ea50ce2010-05-18 11:58:33 -040067
68/*!\brief Don't update the last frame
69 *
70 * When this flag is set, the encoder will not update the last frame with
71 * the contents of the current frame.
72 */
Yaowu Xuf883b422016-08-30 14:01:10 -070073#define AOM_EFLAG_NO_UPD_LAST (1 << 18)
John Koleszar0ea50ce2010-05-18 11:58:33 -040074
75/*!\brief Don't update the golden frame
76 *
77 * When this flag is set, the encoder will not update the golden frame with
78 * the contents of the current frame.
79 */
Yaowu Xuf883b422016-08-30 14:01:10 -070080#define AOM_EFLAG_NO_UPD_GF (1 << 22)
John Koleszar0ea50ce2010-05-18 11:58:33 -040081
82/*!\brief Don't update the alternate reference frame
83 *
84 * When this flag is set, the encoder will not update the alt ref frame with
85 * the contents of the current frame.
86 */
Yaowu Xuf883b422016-08-30 14:01:10 -070087#define AOM_EFLAG_NO_UPD_ARF (1 << 23)
John Koleszar0ea50ce2010-05-18 11:58:33 -040088
89/*!\brief Force golden frame update
90 *
91 * When this flag is set, the encoder copy the contents of the current frame
92 * to the golden frame buffer.
93 */
Yaowu Xuf883b422016-08-30 14:01:10 -070094#define AOM_EFLAG_FORCE_GF (1 << 19)
John Koleszar0ea50ce2010-05-18 11:58:33 -040095
96/*!\brief Force alternate reference frame update
97 *
98 * When this flag is set, the encoder copy the contents of the current frame
99 * to the alternate reference frame buffer.
100 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700101#define AOM_EFLAG_FORCE_ARF (1 << 24)
John Koleszar0ea50ce2010-05-18 11:58:33 -0400102
103/*!\brief Disable entropy update
104 *
105 * When this flag is set, the encoder will not update its internal entropy
106 * model based on the entropy of this frame.
107 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700108#define AOM_EFLAG_NO_UPD_ENTROPY (1 << 20)
John Koleszar0ea50ce2010-05-18 11:58:33 -0400109
Yaowu Xuf883b422016-08-30 14:01:10 -0700110/*!\brief AVx encoder control functions
John Koleszar0ea50ce2010-05-18 11:58:33 -0400111 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700112 * This set of macros define the control functions available for AVx
James Zern8e17e822011-02-24 14:12:57 -0800113 * encoder interface.
114 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700115 * \sa #aom_codec_control
John Koleszar0ea50ce2010-05-18 11:58:33 -0400116 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700117enum aome_enc_control_id {
Yunqing Wangbdcc1402016-03-25 09:05:25 -0700118 /*!\brief Codec control function to set which reference frame encoder can use.
Yunqing Wangbdcc1402016-03-25 09:05:25 -0700119 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700120 AOME_USE_REFERENCE = 7,
Yunqing Wangbdcc1402016-03-25 09:05:25 -0700121
Yaowu Xu268f1062015-03-13 09:42:57 -0700122 /*!\brief Codec control function to pass an ROI map to encoder.
Yaowu Xu268f1062015-03-13 09:42:57 -0700123 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700124 AOME_SET_ROI_MAP = 8,
Yaowu Xu268f1062015-03-13 09:42:57 -0700125
126 /*!\brief Codec control function to pass an Active map to encoder.
Yaowu Xu268f1062015-03-13 09:42:57 -0700127 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700128 AOME_SET_ACTIVEMAP,
Yaowu Xu268f1062015-03-13 09:42:57 -0700129
130 /*!\brief Codec control function to set encoder scaling mode.
Yaowu Xu268f1062015-03-13 09:42:57 -0700131 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700132 AOME_SET_SCALEMODE = 11,
Yaowu Xu268f1062015-03-13 09:42:57 -0700133
134 /*!\brief Codec control function to set encoder internal speed settings.
John Koleszarc6b90392012-07-13 15:21:29 -0700135 *
136 * Changes in this value influences, among others, the encoder's selection
137 * of motion estimation methods. Values greater than 0 will increase encoder
138 * speed at the expense of quality.
John Koleszarc6b90392012-07-13 15:21:29 -0700139 *
Alex Converse561d0af2017-03-23 12:58:04 -0700140 * \note Valid range: 0..8
John Koleszarc6b90392012-07-13 15:21:29 -0700141 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700142 AOME_SET_CPUUSED = 13,
Yaowu Xu268f1062015-03-13 09:42:57 -0700143
144 /*!\brief Codec control function to enable automatic set and use alf frames.
Yaowu Xu268f1062015-03-13 09:42:57 -0700145 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700146 AOME_SET_ENABLEAUTOALTREF,
Yaowu Xu268f1062015-03-13 09:42:57 -0700147
Yaowu Xu268f1062015-03-13 09:42:57 -0700148 /*!\brief Codec control function to set sharpness.
Yaowu Xu268f1062015-03-13 09:42:57 -0700149 */
Alex Converse0f4bcda2016-12-12 15:43:35 -0800150 AOME_SET_SHARPNESS = AOME_SET_ENABLEAUTOALTREF + 2,
Yaowu Xu268f1062015-03-13 09:42:57 -0700151
152 /*!\brief Codec control function to set the threshold for MBs treated static.
Yaowu Xu268f1062015-03-13 09:42:57 -0700153 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700154 AOME_SET_STATIC_THRESHOLD,
Yaowu Xu268f1062015-03-13 09:42:57 -0700155
Yaowu Xu268f1062015-03-13 09:42:57 -0700156 /*!\brief Codec control function to get last quantizer chosen by the encoder.
157 *
158 * Return value uses internal quantizer scale defined by the codec.
Yaowu Xu268f1062015-03-13 09:42:57 -0700159 */
Alex Converse0f4bcda2016-12-12 15:43:35 -0800160 AOME_GET_LAST_QUANTIZER = AOME_SET_STATIC_THRESHOLD + 2,
Yaowu Xu268f1062015-03-13 09:42:57 -0700161
162 /*!\brief Codec control function to get last quantizer chosen by the encoder.
163 *
164 * Return value uses the 0..63 scale as used by the rc_*_quantizer config
165 * parameters.
Yaowu Xu268f1062015-03-13 09:42:57 -0700166 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700167 AOME_GET_LAST_QUANTIZER_64,
Yaowu Xu268f1062015-03-13 09:42:57 -0700168
169 /*!\brief Codec control function to set the max no of frames to create arf.
Yaowu Xu268f1062015-03-13 09:42:57 -0700170 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700171 AOME_SET_ARNR_MAXFRAMES,
Yaowu Xu268f1062015-03-13 09:42:57 -0700172
173 /*!\brief Codec control function to set the filter strength for the arf.
Yaowu Xu268f1062015-03-13 09:42:57 -0700174 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700175 AOME_SET_ARNR_STRENGTH,
Yaowu Xu268f1062015-03-13 09:42:57 -0700176
Yaowu Xu268f1062015-03-13 09:42:57 -0700177 /*!\brief Codec control function to set visual tuning.
Yaowu Xu268f1062015-03-13 09:42:57 -0700178 */
Alex Conversefab62242016-12-13 10:09:15 -0800179 AOME_SET_TUNING = AOME_SET_ARNR_STRENGTH + 2,
Yaowu Xu268f1062015-03-13 09:42:57 -0700180
181 /*!\brief Codec control function to set constrained quality level.
John Koleszarc6b90392012-07-13 15:21:29 -0700182 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700183 * \attention For this value to be used aom_codec_enc_cfg_t::g_usage must be
184 * set to #AOM_CQ.
John Koleszarc6b90392012-07-13 15:21:29 -0700185 * \note Valid range: 0..63
186 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700187 AOME_SET_CQ_LEVEL,
John Koleszar1654ae92011-07-28 09:17:32 -0400188
Yaowu Xu268f1062015-03-13 09:42:57 -0700189 /*!\brief Codec control function to set Max data rate for Intra frames.
John Koleszarc6b90392012-07-13 15:21:29 -0700190 *
191 * This value controls additional clamping on the maximum size of a
192 * keyframe. It is expressed as a percentage of the average
193 * per-frame bitrate, with the special (and default) value 0 meaning
194 * unlimited, or no additional clamping beyond the codec's built-in
195 * algorithm.
196 *
197 * For example, to allocate no more than 4.5 frames worth of bitrate
198 * to a keyframe, set this to 450.
John Koleszarc6b90392012-07-13 15:21:29 -0700199 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700200 AOME_SET_MAX_INTRA_BITRATE_PCT,
John Koleszar83b1d902012-11-05 12:37:14 -0800201
Yaowu Xu268f1062015-03-13 09:42:57 -0700202 /*!\brief Codec control function to set max data rate for Inter frames.
Yaowu Xu636099f2014-10-24 09:31:16 -0700203 *
204 * This value controls additional clamping on the maximum size of an
205 * inter frame. It is expressed as a percentage of the average
206 * per-frame bitrate, with the special (and default) value 0 meaning
207 * unlimited, or no additional clamping beyond the codec's built-in
208 * algorithm.
209 *
210 * For example, to allow no more than 4.5 frames worth of bitrate
211 * to an inter frame, set this to 450.
Yaowu Xu636099f2014-10-24 09:31:16 -0700212 */
Alex Converse0f4bcda2016-12-12 15:43:35 -0800213 AV1E_SET_MAX_INTER_BITRATE_PCT = AOME_SET_MAX_INTRA_BITRATE_PCT + 2,
Yaowu Xu636099f2014-10-24 09:31:16 -0700214
Yaowu Xu268f1062015-03-13 09:42:57 -0700215 /*!\brief Boost percentage for Golden Frame in CBR mode.
Yaowu Xu03a60b72014-10-27 13:13:14 -0700216 *
217 * This value controls the amount of boost given to Golden Frame in
218 * CBR mode. It is expressed as a percentage of the average
219 * per-frame bitrate, with the special (and default) value 0 meaning
220 * the feature is off, i.e., no golden frame boost in CBR mode and
221 * average bitrate target is used.
222 *
223 * For example, to allow 100% more bits, i.e, 2X, in a golden frame
224 * than average frame, set this to 100.
Yaowu Xu03a60b72014-10-27 13:13:14 -0700225 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700226 AV1E_SET_GF_CBR_BOOST_PCT,
John Koleszar83b1d902012-11-05 12:37:14 -0800227
Yaowu Xu268f1062015-03-13 09:42:57 -0700228 /*!\brief Codec control function to set lossless encoding mode.
Yaowu Xu87c436f2015-01-13 12:39:42 -0800229 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700230 * AV1 can operate in lossless encoding mode, in which the bitstream
Yaowu Xu87c436f2015-01-13 12:39:42 -0800231 * produced will be able to decode and reconstruct a perfect copy of
232 * input source. This control function provides a mean to switch encoder
233 * into lossless coding mode(1) or normal coding mode(0) that may be lossy.
234 * 0 = lossy coding mode
235 * 1 = lossless coding mode
236 *
237 * By default, encoder operates in normal coding mode (maybe lossy).
238 */
Alex Converse0f4bcda2016-12-12 15:43:35 -0800239 AV1E_SET_LOSSLESS = AV1E_SET_GF_CBR_BOOST_PCT + 2,
Thomas Daviesaf6df172016-11-09 14:04:18 +0000240
Yaowu Xu268f1062015-03-13 09:42:57 -0700241 /*!\brief Codec control function to set number of tile columns.
Yaowu Xu87c436f2015-01-13 12:39:42 -0800242 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700243 * In encoding and decoding, AV1 allows an input image frame be partitioned
Yaowu Xu87c436f2015-01-13 12:39:42 -0800244 * into separated vertical tile columns, which can be encoded or decoded
245 * independently. This enables easy implementation of parallel encoding and
246 * decoding. This control requests the encoder to use column tiles in
247 * encoding an input frame, with number of tile columns (in Log2 unit) as
248 * the parameter:
249 * 0 = 1 tile column
250 * 1 = 2 tile columns
251 * 2 = 4 tile columns
252 * .....
253 * n = 2**n tile columns
254 * The requested tile columns will be capped by encoder based on image size
255 * limitation (The minimum width of a tile column is 256 pixel, the maximum
256 * is 4096).
257 *
258 * By default, the value is 0, i.e. one single column tile for entire image.
259 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700260 AV1E_SET_TILE_COLUMNS,
Yaowu Xu87c436f2015-01-13 12:39:42 -0800261
Yaowu Xu268f1062015-03-13 09:42:57 -0700262 /*!\brief Codec control function to set number of tile rows.
Yaowu Xu87c436f2015-01-13 12:39:42 -0800263 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700264 * In encoding and decoding, AV1 allows an input image frame be partitioned
Yaowu Xu87c436f2015-01-13 12:39:42 -0800265 * into separated horizontal tile rows. Tile rows are encoded or decoded
266 * sequentially. Even though encoding/decoding of later tile rows depends on
267 * earlier ones, this allows the encoder to output data packets for tile rows
268 * prior to completely processing all tile rows in a frame, thereby reducing
269 * the latency in processing between input and output. The parameter
270 * for this control describes the number of tile rows, which has a valid
271 * range [0, 2]:
272 * 0 = 1 tile row
273 * 1 = 2 tile rows
274 * 2 = 4 tile rows
275 *
276 * By default, the value is 0, i.e. one single row tile for entire image.
277 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700278 AV1E_SET_TILE_ROWS,
Ryan Lei7386eda2016-12-08 21:08:31 -0800279
Yaowu Xu268f1062015-03-13 09:42:57 -0700280 /*!\brief Codec control function to enable frame parallel decoding feature.
Yaowu Xu87c436f2015-01-13 12:39:42 -0800281 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700282 * AV1 has a bitstream feature to reduce decoding dependency between frames
Yaowu Xu87c436f2015-01-13 12:39:42 -0800283 * by turning off backward update of probability context used in encoding
284 * and decoding. This allows staged parallel processing of more than one
285 * video frames in the decoder. This control function provides a mean to
286 * turn this feature on or off for bitstreams produced by encoder.
287 *
288 * By default, this feature is off.
289 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700290 AV1E_SET_FRAME_PARALLEL_DECODING,
Yaowu Xu87c436f2015-01-13 12:39:42 -0800291
Yaowu Xu268f1062015-03-13 09:42:57 -0700292 /*!\brief Codec control function to set adaptive quantization mode.
Yaowu Xu87c436f2015-01-13 12:39:42 -0800293 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700294 * AV1 has a segment based feature that allows encoder to adaptively change
Yaowu Xu87c436f2015-01-13 12:39:42 -0800295 * quantization parameter for each segment within a frame to improve the
296 * subjective quality. This control makes encoder operate in one of the
297 * several AQ_modes supported.
298 *
299 * By default, encoder operates with AQ_Mode 0(adaptive quantization off).
300 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700301 AV1E_SET_AQ_MODE,
Yaowu Xu4ab39e12015-01-14 09:07:02 -0800302
Yaowu Xu268f1062015-03-13 09:42:57 -0700303 /*!\brief Codec control function to enable/disable periodic Q boost.
Yaowu Xu4ab39e12015-01-14 09:07:02 -0800304 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700305 * One AV1 encoder speed feature is to enable quality boost by lowering
Yaowu Xu4ab39e12015-01-14 09:07:02 -0800306 * frame level Q periodically. This control function provides a mean to
307 * turn on/off this feature.
308 * 0 = off
309 * 1 = on
310 *
311 * By default, the encoder is allowed to use this feature for appropriate
312 * encoding modes.
313 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700314 AV1E_SET_FRAME_PERIODIC_BOOST,
Yaowu Xu4ab39e12015-01-14 09:07:02 -0800315
Yaowu Xu268f1062015-03-13 09:42:57 -0700316 /*!\brief Codec control function to set noise sensitivity.
JackyChenbb1a2362014-09-12 11:48:44 -0700317 *
Yaowu Xu268f1062015-03-13 09:42:57 -0700318 * 0: off, 1: On(YOnly)
JackyChenbb1a2362014-09-12 11:48:44 -0700319 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700320 AV1E_SET_NOISE_SENSITIVITY,
Ivan Maltz01b35c32013-09-05 08:55:47 -0700321
Yaowu Xu268f1062015-03-13 09:42:57 -0700322 /*!\brief Codec control function to set content type.
Yaowu Xudc08b202015-01-14 11:17:09 -0800323 * \note Valid parameter range:
Yaowu Xuf883b422016-08-30 14:01:10 -0700324 * AOM_CONTENT_DEFAULT = Regular video content (Default)
325 * AOM_CONTENT_SCREEN = Screen capture content
Yaowu Xudc08b202015-01-14 11:17:09 -0800326 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700327 AV1E_SET_TUNE_CONTENT,
Yaowu Xu193ca4b2015-01-14 11:48:29 -0800328
Yaowu Xu268f1062015-03-13 09:42:57 -0700329 /*!\brief Codec control function to set color space info.
anorkin76fb1262017-03-22 15:12:12 -0700330 * \note Valid ranges: 0..9, default is "UNKNOWN".
Yaowu Xue94b4152015-01-13 10:07:20 -0800331 * 0 = UNKNOWN,
332 * 1 = BT_601
333 * 2 = BT_709
334 * 3 = SMPTE_170
335 * 4 = SMPTE_240
anorkin76fb1262017-03-22 15:12:12 -0700336 * 5 = BT_2020_NCL
337 * 6 = BT_2020_CL
Yaowu Xue94b4152015-01-13 10:07:20 -0800338 * 7 = SRGB
anorkin76fb1262017-03-22 15:12:12 -0700339 * 8 = ICtCp
340 * 9 = RESERVED
Yaowu Xue94b4152015-01-13 10:07:20 -0800341 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700342 AV1E_SET_COLOR_SPACE,
Alex Converse4dcb8392015-03-20 14:55:43 -0700343
anorkin76fb1262017-03-22 15:12:12 -0700344#if CONFIG_COLORSPACE_HEADERS
345 /*!\brief Codec control function to set transfer function info.
346 * \note Valid ranges: 0..4, default is "UNKNOWN".
347 * 0 = UNKNOWN,
348 * 1 = BT_709
349 * 2 = PQ
350 * 3 = HLG
351 * 4 = RESERVED
352 */
353 AV1E_SET_TRANSFER_FUNCTION,
354
355 /*!\brief Codec control function to set chroma 4:2:0 sample position info.
356 * \note Valid ranges: 0..3, default is "UNKNOWN".
357 * 0 = UNKNOWN,
358 * 1 = VERTICAL
359 * 2 = COLOCATED
360 * 3 = RESERVED
361 */
362 AV1E_SET_CHROMA_SAMPLE_POSITION,
363#endif
364
Debargha Mukherjee98526432015-04-01 16:39:06 -0700365 /*!\brief Codec control function to set minimum interval between GF/ARF frames
366 *
367 * By default the value is set as 4.
Debargha Mukherjee98526432015-04-01 16:39:06 -0700368 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700369 AV1E_SET_MIN_GF_INTERVAL,
Debargha Mukherjee98526432015-04-01 16:39:06 -0700370
371 /*!\brief Codec control function to set minimum interval between GF/ARF frames
372 *
373 * By default the value is set as 16.
Debargha Mukherjee98526432015-04-01 16:39:06 -0700374 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700375 AV1E_SET_MAX_GF_INTERVAL,
Debargha Mukherjee98526432015-04-01 16:39:06 -0700376
Alex Converse4dcb8392015-03-20 14:55:43 -0700377 /*!\brief Codec control function to get an Active map back from the encoder.
Alex Converse4dcb8392015-03-20 14:55:43 -0700378 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700379 AV1E_GET_ACTIVEMAP,
Ronald S. Bultjeeeb5ef02015-09-15 21:56:51 -0400380
381 /*!\brief Codec control function to set color range bit.
382 * \note Valid ranges: 0..1, default is 0
383 * 0 = Limited range (16..235 or HBD equivalent)
384 * 1 = Full range (0..255 or HBD equivalent)
Ronald S. Bultjeeeb5ef02015-09-15 21:56:51 -0400385 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700386 AV1E_SET_COLOR_RANGE,
Yaowu Xu7c514e22015-09-28 15:55:46 -0700387
Yaowu Xu7c514e22015-09-28 15:55:46 -0700388 /*!\brief Codec control function to set intended rendering image size.
389 *
390 * By default, this is identical to the image size in pixels.
Yaowu Xu7c514e22015-09-28 15:55:46 -0700391 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700392 AV1E_SET_RENDER_SIZE,
Geza Lore454989f2016-03-24 13:56:05 +0000393
hui sube3f0692016-05-05 15:37:37 -0700394 /*!\brief Codec control function to set target level.
395 *
396 * 255: off (default); 0: only keep level stats; 10: target for level 1.0;
397 * 11: target for level 1.1; ... 62: target for level 6.2
hui sube3f0692016-05-05 15:37:37 -0700398 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700399 AV1E_SET_TARGET_LEVEL,
hui su72d48902016-05-05 12:04:42 -0700400
401 /*!\brief Codec control function to get bitstream level.
hui su72d48902016-05-05 12:04:42 -0700402 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700403 AV1E_GET_LEVEL,
Yaowu Xu6fe07a22016-07-14 10:57:35 -0700404
Geza Lore454989f2016-03-24 13:56:05 +0000405 /*!\brief Codec control function to set intended superblock size.
406 *
407 * By default, the superblock size is determined separately for each
408 * frame by the encoder.
Alex Converse85370ae2016-12-13 11:18:28 -0800409 *
410 * Experiment: EXT_PARTITION
Geza Lore454989f2016-03-24 13:56:05 +0000411 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700412 AV1E_SET_SUPERBLOCK_SIZE,
Alex Converse85370ae2016-12-13 11:18:28 -0800413
414 /*!\brief Codec control function to enable automatic set and use
415 * bwd-pred frames.
416 *
417 * Experiment: EXT_REFS
418 */
419 AOME_SET_ENABLEAUTOBWDREF,
420
421 /*!\brief Codec control function to encode with quantisation matrices.
422 *
423 * AOM can operate with default quantisation matrices dependent on
424 * quantisation level and block type.
425 * 0 = do not use quantisation matrices
426 * 1 = use quantisation matrices
427 *
428 * By default, the encoder operates without quantisation matrices.
429 *
430 * Experiment: AOM_QM
431 */
432 AV1E_SET_ENABLE_QM,
433
434 /*!\brief Codec control function to set the min quant matrix flatness.
435 *
436 * AOM can operate with different ranges of quantisation matrices.
437 * As quantisation levels increase, the matrices get flatter. This
438 * control sets the minimum level of flatness from which the matrices
439 * are determined.
440 *
441 * By default, the encoder sets this minimum at half the available
442 * range.
443 *
444 * Experiment: AOM_QM
445 */
446 AV1E_SET_QM_MIN,
447
448 /*!\brief Codec control function to set the max quant matrix flatness.
449 *
450 * AOM can operate with different ranges of quantisation matrices.
451 * As quantisation levels increase, the matrices get flatter. This
452 * control sets the maximum level of flatness possible.
453 *
454 * By default, the encoder sets this maximum at the top of the
455 * available range.
456 *
457 * Experiment: AOM_QM
458 */
459 AV1E_SET_QM_MAX,
460
461 /*!\brief Codec control function to set a maximum number of tile groups.
462 *
463 * This will set the maximum number of tile groups. This will be
464 * overridden if an MTU size is set. The default value is 1.
465 *
466 * Experiment: TILE_GROUPS
467 */
468 AV1E_SET_NUM_TG,
469
470 /*!\brief Codec control function to set an MTU size for a tile group.
471 *
472 * This will set the maximum number of bytes in a tile group. This can be
473 * exceeded only if a single tile is larger than this amount.
474 *
475 * By default, the value is 0, in which case a fixed number of tile groups
476 * is used.
477 *
478 * Experiment: TILE_GROUPS
479 */
480 AV1E_SET_MTU,
Alex Converseeb780e72016-12-13 12:46:41 -0800481
Fangwen Fu7b9f2b32017-01-17 14:01:52 -0800482 /*!\brief Codec control function to set dependent_horz_tiles.
483 *
484 * In encoding and decoding, AV1 allows enabling dependent horizontal tile
485 * The parameter for this control describes the value of this flag,
486 * which has a valid range [0, 1]:
487 * 0 = disable dependent horizontal tile
488 * 1 = enable dependent horizontal tile,
489 *
490 * By default, the value is 0, i.e. disable dependent horizontal tile.
Fangwen Fu7b9f2b32017-01-17 14:01:52 -0800491 */
492 AV1E_SET_TILE_DEPENDENT_ROWS,
493
Alex Converseeb780e72016-12-13 12:46:41 -0800494 /*!\brief Codec control function to set the number of symbols in an ANS data
495 * window.
496 *
497 * The number of ANS symbols (both boolean and non-booleans alphabets) in an
498 * ANS data window is set to 1 << value.
499 *
500 * \note Valid range: [8, 23]
501 *
502 * Experiment: ANS
503 */
504 AV1E_SET_ANS_WINDOW_SIZE_LOG2,
Alex Converse00b7e272017-03-22 18:14:08 -0700505
506 /*!\brief Codec control function to set temporal mv prediction
507 * enabling/disabling.
508 *
509 * This will enable or disable temporal mv predicton. The default value is 0.
510 *
511 * Experiment: TEMPMV_SIGNALING
512 */
513 AV1E_SET_DISABLE_TEMPMV,
514
515 /*!\brief Codec control function to set loop_filter_across_tiles_enabled.
516 *
517 * In encoding and decoding, AV1 allows disabling loop filter across tile
518 * boundary The parameter for this control describes the value of this flag,
519 * which has a valid range [0, 1]:
520 * 0 = disable loop filter across tile boundary
521 * 1 = enable loop filter across tile boundary
522 *
523 * By default, the value is 1, i.e. enable loop filter across tile boundary.
524 *
525 * Experiment: LOOPFILTERING_ACROSS_TILES
526 */
527 AV1E_SET_TILE_LOOPFILTER,
Yunqing Wangd8cd55f2017-02-27 12:16:00 -0800528
Fangwen Fu6160df22017-04-24 09:45:51 -0700529 /*!\brief Codec control function to set the delta q mode
530 *
531 * AV1 has a segment based feature that allows encoder to adaptively change
532 * quantization parameter for each segment within a frame to improve the
533 * subjective quality. the delta q mode is added on top of segment based
534 * feature, and allows control per 64x64 q and lf delta.This control makes
535 * encoder operate in one of the several DELTA_Q_modes supported.
536 *
537 * By default, encoder operates with DELTAQ_Mode 0(deltaq signaling off).
538 */
539 AV1E_SET_DELTAQ_MODE,
540
Yunqing Wangd8cd55f2017-02-27 12:16:00 -0800541 /*!\brief Codec control function to set the tile encoding mode to 0 or 1.
542 *
543 * 0 means that the tile encoding mode is TILE_NORMAL, and 1 means that the
544 * tile encoding mode is TILE_VR.
545 *
546 * Experiment: EXT_TILE
547 */
548 AV1E_SET_TILE_ENCODING_MODE,
Yunqing Wangff4fa062017-04-21 10:56:08 -0700549
550 /*!\brief Codec control function to enable the extreme motion vector unit test
551 * in AV1. Please note that this is only used in motion vector unit test.
552 *
553 * 0 : off, 1 : MAX_EXTREME_MV, 2 : MIN_EXTREME_MV
554 */
555 AV1E_ENABLE_MOTION_VECTOR_UNIT_TEST,
John Koleszarb0da9b32010-12-17 09:43:39 -0500556};
John Koleszar0ea50ce2010-05-18 11:58:33 -0400557
Yaowu Xuf883b422016-08-30 14:01:10 -0700558/*!\brief aom 1-D scaling mode
John Koleszar0ea50ce2010-05-18 11:58:33 -0400559 *
Yaowu Xuf883b422016-08-30 14:01:10 -0700560 * This set of constants define 1-D aom scaling modes
John Koleszar0ea50ce2010-05-18 11:58:33 -0400561 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700562typedef enum aom_scaling_mode_1d {
563 AOME_NORMAL = 0,
564 AOME_FOURFIVE = 1,
565 AOME_THREEFIVE = 2,
566 AOME_ONETWO = 3
567} AOM_SCALING_MODE;
John Koleszar0ea50ce2010-05-18 11:58:33 -0400568
Yaowu Xuf883b422016-08-30 14:01:10 -0700569/*!\brief aom region of interest map
John Koleszar0ea50ce2010-05-18 11:58:33 -0400570 *
571 * These defines the data structures for the region of interest map
572 *
573 */
574
Yaowu Xuf883b422016-08-30 14:01:10 -0700575typedef struct aom_roi_map {
Adrian Grangef58eca92013-10-24 15:11:36 -0700576 /*! An id between 0 and 3 for each 16x16 region within a frame. */
577 unsigned char *roi_map;
clang-format83a52072016-08-08 20:22:13 -0700578 unsigned int rows; /**< Number of rows. */
579 unsigned int cols; /**< Number of columns. */
Yaowu Xuf883b422016-08-30 14:01:10 -0700580 // TODO(paulwilkins): broken for AV1 which has 8 segments
Paul Wilkins31ee1932013-04-24 13:04:45 +0100581 // q and loop filter deltas for each segment
582 // (see MAX_MB_SEGMENTS)
clang-format83a52072016-08-08 20:22:13 -0700583 int delta_q[4]; /**< Quantizer deltas. */
584 int delta_lf[4]; /**< Loop filter deltas. */
Adrian Grangef58eca92013-10-24 15:11:36 -0700585 /*! Static breakout threshold for each segment. */
586 unsigned int static_threshold[4];
Yaowu Xuf883b422016-08-30 14:01:10 -0700587} aom_roi_map_t;
John Koleszar0ea50ce2010-05-18 11:58:33 -0400588
Yaowu Xuf883b422016-08-30 14:01:10 -0700589/*!\brief aom active region map
John Koleszar0ea50ce2010-05-18 11:58:33 -0400590 *
591 * These defines the data structures for active region map
592 *
593 */
594
Yaowu Xuf883b422016-08-30 14:01:10 -0700595typedef struct aom_active_map {
clang-format83a52072016-08-08 20:22:13 -0700596 /*!\brief specify an on (1) or off (0) each 16x16 region within a frame */
597 unsigned char *active_map;
598 unsigned int rows; /**< number of rows */
599 unsigned int cols; /**< number of cols */
Yaowu Xuf883b422016-08-30 14:01:10 -0700600} aom_active_map_t;
John Koleszar0ea50ce2010-05-18 11:58:33 -0400601
Yaowu Xuf883b422016-08-30 14:01:10 -0700602/*!\brief aom image scaling mode
John Koleszar0ea50ce2010-05-18 11:58:33 -0400603 *
604 * This defines the data structure for image scaling mode
605 *
606 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700607typedef struct aom_scaling_mode {
608 AOM_SCALING_MODE h_scaling_mode; /**< horizontal scaling mode */
609 AOM_SCALING_MODE v_scaling_mode; /**< vertical scaling mode */
610} aom_scaling_mode_t;
John Koleszar0ea50ce2010-05-18 11:58:33 -0400611
Yaowu Xuf883b422016-08-30 14:01:10 -0700612/*!brief AV1 encoder content type */
Alex Converse572de922014-07-31 08:27:32 -0700613typedef enum {
Yaowu Xuf883b422016-08-30 14:01:10 -0700614 AOM_CONTENT_DEFAULT,
615 AOM_CONTENT_SCREEN,
616 AOM_CONTENT_INVALID
617} aom_tune_content;
John Koleszar0ea50ce2010-05-18 11:58:33 -0400618
Alex Converse6e3c8052016-12-16 09:48:56 -0800619/*!\brief Model tuning parameters
John Koleszarb0da9b32010-12-17 09:43:39 -0500620 *
621 * Changes the encoder to tune for certain types of input material.
622 *
623 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700624typedef enum { AOM_TUNE_PSNR, AOM_TUNE_SSIM } aom_tune_metric;
John Koleszarb0da9b32010-12-17 09:43:39 -0500625
James Zern7dd7a7d2015-10-09 16:31:17 -0700626/*!\cond */
Alex Converse6e3c8052016-12-16 09:48:56 -0800627/*!\brief Encoder control function parameter type
John Koleszar0ea50ce2010-05-18 11:58:33 -0400628 *
Alex Converse6e3c8052016-12-16 09:48:56 -0800629 * Defines the data types that AOME/AV1E control functions take. Note that
Yaowu Xuf883b422016-08-30 14:01:10 -0700630 * additional common controls are defined in aom.h
John Koleszar0ea50ce2010-05-18 11:58:33 -0400631 *
632 */
633
Yaowu Xuf883b422016-08-30 14:01:10 -0700634AOM_CTRL_USE_TYPE_DEPRECATED(AOME_USE_REFERENCE, int)
635#define AOM_CTRL_AOME_USE_REFERENCE
Yaowu Xuf883b422016-08-30 14:01:10 -0700636AOM_CTRL_USE_TYPE(AOME_SET_ROI_MAP, aom_roi_map_t *)
637#define AOM_CTRL_AOME_SET_ROI_MAP
638AOM_CTRL_USE_TYPE(AOME_SET_ACTIVEMAP, aom_active_map_t *)
639#define AOM_CTRL_AOME_SET_ACTIVEMAP
640AOM_CTRL_USE_TYPE(AOME_SET_SCALEMODE, aom_scaling_mode_t *)
641#define AOM_CTRL_AOME_SET_SCALEMODE
John Koleszar0ea50ce2010-05-18 11:58:33 -0400642
Yaowu Xuf883b422016-08-30 14:01:10 -0700643AOM_CTRL_USE_TYPE(AOME_SET_CPUUSED, int)
644#define AOM_CTRL_AOME_SET_CPUUSED
645AOM_CTRL_USE_TYPE(AOME_SET_ENABLEAUTOALTREF, unsigned int)
646#define AOM_CTRL_AOME_SET_ENABLEAUTOALTREF
Zoe Liucf5083d2016-02-04 09:47:46 -0800647
Yaowu Xuf883b422016-08-30 14:01:10 -0700648AOM_CTRL_USE_TYPE(AOME_SET_ENABLEAUTOBWDREF, unsigned int)
649#define AOM_CTRL_AOME_SET_ENABLEAUTOBWDREF
Zoe Liucf5083d2016-02-04 09:47:46 -0800650
Yaowu Xuf883b422016-08-30 14:01:10 -0700651AOM_CTRL_USE_TYPE(AOME_SET_SHARPNESS, unsigned int)
652#define AOM_CTRL_AOME_SET_SHARPNESS
653AOM_CTRL_USE_TYPE(AOME_SET_STATIC_THRESHOLD, unsigned int)
654#define AOM_CTRL_AOME_SET_STATIC_THRESHOLD
John Koleszar0ea50ce2010-05-18 11:58:33 -0400655
Yaowu Xuf883b422016-08-30 14:01:10 -0700656AOM_CTRL_USE_TYPE(AOME_SET_ARNR_MAXFRAMES, unsigned int)
657#define AOM_CTRL_AOME_SET_ARNR_MAXFRAMES
658AOM_CTRL_USE_TYPE(AOME_SET_ARNR_STRENGTH, unsigned int)
659#define AOM_CTRL_AOME_SET_ARNR_STRENGTH
Yaowu Xuf883b422016-08-30 14:01:10 -0700660AOM_CTRL_USE_TYPE(AOME_SET_TUNING, int) /* aom_tune_metric */
661#define AOM_CTRL_AOME_SET_TUNING
662AOM_CTRL_USE_TYPE(AOME_SET_CQ_LEVEL, unsigned int)
663#define AOM_CTRL_AOME_SET_CQ_LEVEL
John Koleszar0ea50ce2010-05-18 11:58:33 -0400664
Yaowu Xuf883b422016-08-30 14:01:10 -0700665AOM_CTRL_USE_TYPE(AV1E_SET_TILE_COLUMNS, int)
666#define AOM_CTRL_AV1E_SET_TILE_COLUMNS
667AOM_CTRL_USE_TYPE(AV1E_SET_TILE_ROWS, int)
668#define AOM_CTRL_AV1E_SET_TILE_ROWS
Fangwen Fu7b9f2b32017-01-17 14:01:52 -0800669
Fangwen Fu7b9f2b32017-01-17 14:01:52 -0800670AOM_CTRL_USE_TYPE(AV1E_SET_TILE_DEPENDENT_ROWS, int)
671#define AOM_CTRL_AV1E_SET_TILE_DEPENDENT_ROWS
Fangwen Fu7b9f2b32017-01-17 14:01:52 -0800672
Ryan Lei7386eda2016-12-08 21:08:31 -0800673AOM_CTRL_USE_TYPE(AV1E_SET_TILE_LOOPFILTER, int)
674#define AOM_CTRL_AV1E_SET_TILE_LOOPFILTER
Ronald S. Bultje1407bdc2013-02-01 09:35:28 -0800675
Yaowu Xuf883b422016-08-30 14:01:10 -0700676AOM_CTRL_USE_TYPE(AOME_GET_LAST_QUANTIZER, int *)
677#define AOM_CTRL_AOME_GET_LAST_QUANTIZER
678AOM_CTRL_USE_TYPE(AOME_GET_LAST_QUANTIZER_64, int *)
679#define AOM_CTRL_AOME_GET_LAST_QUANTIZER_64
John Koleszar0ea50ce2010-05-18 11:58:33 -0400680
Yaowu Xuf883b422016-08-30 14:01:10 -0700681AOM_CTRL_USE_TYPE(AOME_SET_MAX_INTRA_BITRATE_PCT, unsigned int)
682#define AOM_CTRL_AOME_SET_MAX_INTRA_BITRATE_PCT
683AOM_CTRL_USE_TYPE(AOME_SET_MAX_INTER_BITRATE_PCT, unsigned int)
684#define AOM_CTRL_AOME_SET_MAX_INTER_BITRATE_PCT
John Koleszar1654ae92011-07-28 09:17:32 -0400685
Yaowu Xuf883b422016-08-30 14:01:10 -0700686AOM_CTRL_USE_TYPE(AV1E_SET_GF_CBR_BOOST_PCT, unsigned int)
687#define AOM_CTRL_AV1E_SET_GF_CBR_BOOST_PCT
Yaowu Xu41652902015-03-12 17:59:18 -0700688
Yaowu Xuf883b422016-08-30 14:01:10 -0700689AOM_CTRL_USE_TYPE(AV1E_SET_LOSSLESS, unsigned int)
690#define AOM_CTRL_AV1E_SET_LOSSLESS
John Koleszar1654ae92011-07-28 09:17:32 -0400691
Yaowu Xuf883b422016-08-30 14:01:10 -0700692AOM_CTRL_USE_TYPE(AV1E_SET_ENABLE_QM, unsigned int)
693#define AOM_CTRL_AV1E_SET_ENABLE_QM
Yaowu Xu0818a7c2016-08-11 09:39:47 -0700694
Yaowu Xuf883b422016-08-30 14:01:10 -0700695AOM_CTRL_USE_TYPE(AV1E_SET_QM_MIN, unsigned int)
696#define AOM_CTRL_AV1E_SET_QM_MIN
Yaowu Xu0818a7c2016-08-11 09:39:47 -0700697
Yaowu Xuf883b422016-08-30 14:01:10 -0700698AOM_CTRL_USE_TYPE(AV1E_SET_QM_MAX, unsigned int)
699#define AOM_CTRL_AV1E_SET_QM_MAX
Yaowu Xu0818a7c2016-08-11 09:39:47 -0700700
Thomas Daviesaf6df172016-11-09 14:04:18 +0000701AOM_CTRL_USE_TYPE(AV1E_SET_NUM_TG, unsigned int)
702#define AOM_CTRL_AV1E_SET_NUM_TG
703AOM_CTRL_USE_TYPE(AV1E_SET_MTU, unsigned int)
704#define AOM_CTRL_AV1E_SET_MTU
Thomas Daviesaf6df172016-11-09 14:04:18 +0000705
Fangwen Fu8d164de2016-12-14 13:40:54 -0800706AOM_CTRL_USE_TYPE(AV1E_SET_DISABLE_TEMPMV, unsigned int)
707#define AOM_CTRL_AV1E_SET_DISABLE_TEMPMV
Fangwen Fu8d164de2016-12-14 13:40:54 -0800708
Yaowu Xuf883b422016-08-30 14:01:10 -0700709AOM_CTRL_USE_TYPE(AV1E_SET_FRAME_PARALLEL_DECODING, unsigned int)
710#define AOM_CTRL_AV1E_SET_FRAME_PARALLEL_DECODING
Ivan Maltz01b35c32013-09-05 08:55:47 -0700711
Yaowu Xuf883b422016-08-30 14:01:10 -0700712AOM_CTRL_USE_TYPE(AV1E_SET_AQ_MODE, unsigned int)
713#define AOM_CTRL_AV1E_SET_AQ_MODE
Guillaume Martres17084652013-11-14 19:23:57 +0100714
Fangwen Fu6160df22017-04-24 09:45:51 -0700715AOM_CTRL_USE_TYPE(AV1E_SET_DELTAQ_MODE, unsigned int)
716#define AOM_CTRL_AV1E_SET_DELTAQ_MODE
717
Yaowu Xuf883b422016-08-30 14:01:10 -0700718AOM_CTRL_USE_TYPE(AV1E_SET_FRAME_PERIODIC_BOOST, unsigned int)
719#define AOM_CTRL_AV1E_SET_FRAME_PERIODIC_BOOST
Marco Paniconi0eb88c92014-04-03 15:49:03 -0700720
Yaowu Xuf883b422016-08-30 14:01:10 -0700721AOM_CTRL_USE_TYPE(AV1E_SET_NOISE_SENSITIVITY, unsigned int)
722#define AOM_CTRL_AV1E_SET_NOISE_SENSITIVITY
JackyChenbb1a2362014-09-12 11:48:44 -0700723
Yaowu Xuf883b422016-08-30 14:01:10 -0700724AOM_CTRL_USE_TYPE(AV1E_SET_TUNE_CONTENT, int) /* aom_tune_content */
725#define AOM_CTRL_AV1E_SET_TUNE_CONTENT
Yaowu Xue94b4152015-01-13 10:07:20 -0800726
Yaowu Xuf883b422016-08-30 14:01:10 -0700727AOM_CTRL_USE_TYPE(AV1E_SET_COLOR_SPACE, int)
728#define AOM_CTRL_AV1E_SET_COLOR_SPACE
Alex Converse4dcb8392015-03-20 14:55:43 -0700729
anorkin76fb1262017-03-22 15:12:12 -0700730#if CONFIG_COLORSPACE_HEADERS
731AOM_CTRL_USE_TYPE(AV1E_SET_TRANSFER_FUNCTION, int)
732#define AOM_CTRL_AV1E_SET_TRANSFER_FUNCTION
733
734AOM_CTRL_USE_TYPE(AV1E_SET_CHROMA_SAMPLE_POSITION, int)
735#define AOM_CTRL_AV1E_SET_CHROMA_SAMPLE_POSITION
736#endif
737
Yaowu Xuf883b422016-08-30 14:01:10 -0700738AOM_CTRL_USE_TYPE(AV1E_SET_MIN_GF_INTERVAL, unsigned int)
739#define AOM_CTRL_AV1E_SET_MIN_GF_INTERVAL
Debargha Mukherjee98526432015-04-01 16:39:06 -0700740
Yaowu Xuf883b422016-08-30 14:01:10 -0700741AOM_CTRL_USE_TYPE(AV1E_SET_MAX_GF_INTERVAL, unsigned int)
742#define AOM_CTRL_AV1E_SET_MAX_GF_INTERVAL
Debargha Mukherjee98526432015-04-01 16:39:06 -0700743
Yaowu Xuf883b422016-08-30 14:01:10 -0700744AOM_CTRL_USE_TYPE(AV1E_GET_ACTIVEMAP, aom_active_map_t *)
745#define AOM_CTRL_AV1E_GET_ACTIVEMAP
Ronald S. Bultjeeeb5ef02015-09-15 21:56:51 -0400746
Yaowu Xuf883b422016-08-30 14:01:10 -0700747AOM_CTRL_USE_TYPE(AV1E_SET_COLOR_RANGE, int)
748#define AOM_CTRL_AV1E_SET_COLOR_RANGE
Yaowu Xu7c514e22015-09-28 15:55:46 -0700749
Yaowu Xu7c514e22015-09-28 15:55:46 -0700750/*!\brief
751 *
752 * TODO(rbultje) : add support of the control in ffmpeg
753 */
Yaowu Xuf883b422016-08-30 14:01:10 -0700754#define AOM_CTRL_AV1E_SET_RENDER_SIZE
755AOM_CTRL_USE_TYPE(AV1E_SET_RENDER_SIZE, int *)
Geza Lore454989f2016-03-24 13:56:05 +0000756
Yaowu Xuf883b422016-08-30 14:01:10 -0700757AOM_CTRL_USE_TYPE(AV1E_SET_SUPERBLOCK_SIZE, unsigned int)
758#define AOM_CTRL_AV1E_SET_SUPERBLOCK_SIZE
James Zern7dd7a7d2015-10-09 16:31:17 -0700759
Yaowu Xuf883b422016-08-30 14:01:10 -0700760AOM_CTRL_USE_TYPE(AV1E_SET_TARGET_LEVEL, unsigned int)
761#define AOM_CTRL_AV1E_SET_TARGET_LEVEL
hui sube3f0692016-05-05 15:37:37 -0700762
Yaowu Xuf883b422016-08-30 14:01:10 -0700763AOM_CTRL_USE_TYPE(AV1E_GET_LEVEL, int *)
764#define AOM_CTRL_AV1E_GET_LEVEL
Alex Converseeb780e72016-12-13 12:46:41 -0800765
766AOM_CTRL_USE_TYPE(AV1E_SET_ANS_WINDOW_SIZE_LOG2, unsigned int)
767#define AOM_CTRL_AV1E_SET_ANS_WINDOW_SIZE_LOG2
Yunqing Wangd8cd55f2017-02-27 12:16:00 -0800768
769AOM_CTRL_USE_TYPE(AV1E_SET_TILE_ENCODING_MODE, unsigned int)
770#define AOM_CTRL_AV1E_SET_TILE_ENCODING_MODE
Yunqing Wangff4fa062017-04-21 10:56:08 -0700771
772AOM_CTRL_USE_TYPE(AV1E_ENABLE_MOTION_VECTOR_UNIT_TEST, unsigned int)
773#define AOM_CTRL_AV1E_ENABLE_MOTION_VECTOR_UNIT_TEST
774
James Zern7dd7a7d2015-10-09 16:31:17 -0700775/*!\endcond */
Alex Conversec77b2ff2016-12-12 17:29:32 -0800776/*! @} - end defgroup aom_encoder */
Dmitry Kovaleve288c602013-09-29 18:00:15 -0700777#ifdef __cplusplus
778} // extern "C"
779#endif
780
Yaowu Xuf883b422016-08-30 14:01:10 -0700781#endif // AOM_AOMCX_H_