AOMedia AV1 Codec
aq_cyclicrefresh.h
1 /*
2  * Copyright (c) 2016, Alliance for Open Media. All rights reserved.
3  *
4  * 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.
10  */
11 
12 #ifndef AOM_AV1_ENCODER_AQ_CYCLICREFRESH_H_
13 #define AOM_AV1_ENCODER_AQ_CYCLICREFRESH_H_
14 
15 #include "av1/common/blockd.h"
16 #include "av1/encoder/block.h"
17 #include "av1/encoder/tokenize.h"
18 
19 #ifdef __cplusplus
20 extern "C" {
21 #endif
22 
23 // The segment ids used in cyclic refresh: from base (no boost) to increasing
24 // boost (higher delta-qp).
25 #define CR_SEGMENT_ID_BASE 0
26 #define CR_SEGMENT_ID_BOOST1 1
27 #define CR_SEGMENT_ID_BOOST2 2
28 
29 // Maximum rate target ratio for setting segment delta-qp.
30 #define CR_MAX_RATE_TARGET_RATIO 4.0
31 
42 
47 
55  int sb_index;
83  int rdmult;
87  int8_t *map;
92  int64_t thresh_rate_sb;
97  int64_t thresh_dist_sb;
102  int16_t motion_thresh;
107 
112 
117 
119  int qindex_delta[3];
120  int apply_cyclic_refresh;
121  int skip_over4x4;
122  int counter_encode_maxq_scene_change;
123  int use_block_sad_scene_det;
125 };
126 
127 struct AV1_COMP;
128 
129 typedef struct CYCLIC_REFRESH CYCLIC_REFRESH;
130 
131 CYCLIC_REFRESH *av1_cyclic_refresh_alloc(int mi_rows, int mi_cols);
132 
133 void av1_cyclic_refresh_free(CYCLIC_REFRESH *cr);
134 
150 int av1_cyclic_refresh_estimate_bits_at_q(const struct AV1_COMP *cpi,
151  double correction_factor);
152 
171 int av1_cyclic_refresh_rc_bits_per_mb(const struct AV1_COMP *cpi, int i,
172  double correction_factor);
173 
196 void av1_cyclic_reset_segment_skip(const struct AV1_COMP *cpi,
197  MACROBLOCK *const x, int mi_row, int mi_col,
198  BLOCK_SIZE bsize, RUN_TYPE dry_run);
199 
224 void av1_cyclic_refresh_update_segment(const struct AV1_COMP *cpi,
225  MACROBLOCK *const x, int mi_row,
226  int mi_col, BLOCK_SIZE bsize,
227  int64_t rate, int64_t dist, int skip,
228  RUN_TYPE dry_run);
229 
245 
262  CYCLIC_REFRESH *const cyclic_refresh, const MACROBLOCK *const x);
263 
274 void av1_cyclic_refresh_set_golden_update(struct AV1_COMP *const cpi);
275 
291 void av1_cyclic_refresh_update_parameters(struct AV1_COMP *const cpi);
292 
306 void av1_cyclic_refresh_setup(struct AV1_COMP *const cpi);
307 
308 int av1_cyclic_refresh_get_rdmult(const CYCLIC_REFRESH *cr);
309 
310 int av1_cyclic_refresh_disable_lf_cdef(struct AV1_COMP *const cpi);
311 
312 static inline int cyclic_refresh_segment_id_boosted(int segment_id) {
313  return segment_id == CR_SEGMENT_ID_BOOST1 ||
314  segment_id == CR_SEGMENT_ID_BOOST2;
315 }
316 
317 static inline int cyclic_refresh_segment_id(int segment_id) {
318  if (segment_id == CR_SEGMENT_ID_BOOST1)
319  return CR_SEGMENT_ID_BOOST1;
320  else if (segment_id == CR_SEGMENT_ID_BOOST2)
321  return CR_SEGMENT_ID_BOOST2;
322  else
323  return CR_SEGMENT_ID_BASE;
324 }
325 
326 #ifdef __cplusplus
327 } // extern "C"
328 #endif
329 
330 #endif // AOM_AV1_ENCODER_AQ_CYCLICREFRESH_H_
void av1_cyclic_refresh_update_parameters(struct AV1_COMP *const cpi)
Set the global/frame level parameters for cyclic refresh.
int64_t thresh_dist_sb
Definition: aq_cyclicrefresh.h:97
void av1_cyclic_refresh_setup(struct AV1_COMP *const cpi)
Setup the cyclic background refresh.
int time_for_refresh
Definition: aq_cyclicrefresh.h:65
void av1_cyclic_refresh_update_segment(const struct AV1_COMP *cpi, MACROBLOCK *const x, int mi_row, int mi_col, BLOCK_SIZE bsize, int64_t rate, int64_t dist, int skip, RUN_TYPE dry_run)
Update segment_id for block based on mode selected.
int sb_index
Definition: aq_cyclicrefresh.h:55
void av1_cyclic_reset_segment_skip(const struct AV1_COMP *cpi, MACROBLOCK *const x, int mi_row, int mi_col, BLOCK_SIZE bsize, RUN_TYPE dry_run)
Update segment_id for blocks are skipped.
void av1_cyclic_refresh_set_golden_update(struct AV1_COMP *const cpi)
Set golden frame update interval nased on cyclic refresh.
void av1_init_cyclic_refresh_counters(MACROBLOCK *const x)
Initialize counters used for cyclic refresh.
double rate_ratio_qdelta
Definition: aq_cyclicrefresh.h:106
int target_num_seg_blocks
Definition: aq_cyclicrefresh.h:69
double rate_ratio_qdelta_adjustment
Definition: aq_cyclicrefresh.h:111
int16_t motion_thresh
Definition: aq_cyclicrefresh.h:102
int64_t thresh_rate_sb
Definition: aq_cyclicrefresh.h:92
int av1_cyclic_refresh_estimate_bits_at_q(const struct AV1_COMP *cpi, double correction_factor)
Estimate the bits, incorporating the delta-q from the segments.
void av1_accumulate_cyclic_refresh_counters(CYCLIC_REFRESH *const cyclic_refresh, const MACROBLOCK *const x)
Accumulate cyclic refresh counters.
int av1_cyclic_refresh_rc_bits_per_mb(const struct AV1_COMP *cpi, int i, double correction_factor)
Estimate the bits per mb, for given q = i and delta-q.
Top level encoder structure.
Definition: encoder.h:2870
int percent_refresh_adjustment
Definition: aq_cyclicrefresh.h:46
int actual_num_seg1_blocks
Definition: aq_cyclicrefresh.h:74
int actual_num_seg2_blocks
Definition: aq_cyclicrefresh.h:79
int rdmult
Definition: aq_cyclicrefresh.h:83
int percent_refresh
Definition: aq_cyclicrefresh.h:41
int max_qdelta_perc
Definition: aq_cyclicrefresh.h:51
int last_sb_index
Definition: aq_cyclicrefresh.h:59
The stucture of CYCLIC_REFRESH.
Definition: aq_cyclicrefresh.h:36
Encoder's parameters related to the current coding block.
Definition: block.h:878
int rate_boost_fac
Definition: aq_cyclicrefresh.h:116
int8_t * map
Definition: aq_cyclicrefresh.h:87