• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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_VAR_BASED_PART_H_
13 #define AOM_AV1_ENCODER_VAR_BASED_PART_H_
14 
15 #include <stdio.h>
16 
17 #include "config/aom_config.h"
18 #include "config/aom_dsp_rtcd.h"
19 #include "config/av1_rtcd.h"
20 
21 #include "av1/encoder/encoder.h"
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 #define QINDEX_LOW_THR \
28   200  // Use low qindex variance partition thresholds when qindex is below this
29        // threshold
30 #define QINDEX_HIGH_THR \
31   220  // Use high qindex variance partition thresholds when qindex is above
32        // this threshold
33 #define QINDEX_LARGE_BLOCK_THR \
34   100  // Use increased thresholds for midres for speed 9 when qindex is above
35        // this threshold
36 
37 /*!\brief Set the thresholds for variance based partition.
38  *
39  * Set the variance split thresholds for following the block sizes:
40  * 0 - threshold_128x128, 1 - threshold_64x64, 2 - threshold_32x32,
41  * 3 - vbp_threshold_16x16. 4 - vbp_threshold_8x8 (to split to 4x4 partition) is
42  * currently only used on key frame. The thresholds are based om Q, resolution,
43  * noise level, and content state.
44  *
45  * \ingroup variance_partition
46  * \callgraph
47  * \callergraph
48  *
49  * \param[in]      cpi                Top level encoder structure
50  * \param[in]      q                  q index
51  * \param[in]      content_lowsumdiff Low sumdiff flag for superblock
52  *
53  * \return Returns the set of thresholds in \c cpi->vbp_info.thresholds.
54  */
55 void av1_set_variance_partition_thresholds(AV1_COMP *cpi, int q,
56                                            int content_lowsumdiff);
57 
58 /*!\brief Variance based partition selection.
59  *
60  * Select the partitioning based on the variance of the residual signal,
61  * residual generated as the difference between the source and prediction.
62  * The prediction is the reconstructed LAST or reconstructed GOLDEN, whichever
63  * has lower y sad. For LAST, option exists (speed feature) to use motion
64  * compensation based on superblock motion via int_pro_motion_estimation. For
65  * key frames reference is fixed 128 level, so variance is the source variance.
66  * The variance is computed for downsampled inputs (8x8 or 4x4 downsampled),
67  * and selection is done top-down via as set of partition thresholds. defined
68  * for each block level, and set based on Q, resolution, noise level, and
69  * content state.
70  *
71  * \ingroup variance_partition
72  * \callgraph
73  * \callergraph
74  *
75  * \param[in]       cpi          Top level encoder structure
76  * \param[in]       tile         Pointer to TileInfo
77  * \param[in]       td           Pointer to ThreadData
78  * \param[in]       x            Pointer to MACROBLOCK
79  * \param[in]       mi_row       Row coordinate of the superblock in a step
80  size of MI_SIZE
81  * \param[in]       mi_col       Column coordinate of the super block in a step
82  size of MI_SIZE
83  *
84  * \return Returns the partition in \c xd->mi[0]->sb_type. Also sets the low
85  * temporal variance flag and the color sensitivity flag (both used in
86  * nonrd_pickmode).
87  */
88 int av1_choose_var_based_partitioning(AV1_COMP *cpi, const TileInfo *const tile,
89                                       ThreadData *td, MACROBLOCK *x, int mi_row,
90                                       int mi_col);
91 
92 #ifdef __cplusplus
93 }  // extern "C"
94 #endif
95 
96 #endif  // AOM_AV1_ENCODER_VAR_BASED_PART_H_
97