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_AV1_QUANTIZE_H_
13 #define AOM_AV1_ENCODER_AV1_QUANTIZE_H_
14 
15 #include "config/aom_config.h"
16 
17 #include "av1/common/quant_common.h"
18 #include "av1/common/scan.h"
19 #include "av1/encoder/block.h"
20 
21 #ifdef __cplusplus
22 extern "C" {
23 #endif
24 
25 #define EOB_FACTOR 325
26 #define SKIP_EOB_FACTOR_ADJUST 200
27 
28 typedef struct QUANT_PARAM {
29   int log_scale;
30   TX_SIZE tx_size;
31   const qm_val_t *qmatrix;
32   const qm_val_t *iqmatrix;
33   int use_quant_b_adapt;
34   int use_optimize_b;
35   int xform_quant_idx;
36 } QUANT_PARAM;
37 
38 typedef void (*AV1_QUANT_FACADE)(const tran_low_t *coeff_ptr, intptr_t n_coeffs,
39                                  const MACROBLOCK_PLANE *p,
40                                  tran_low_t *qcoeff_ptr,
41                                  tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr,
42                                  const SCAN_ORDER *sc,
43                                  const QUANT_PARAM *qparam);
44 
45 // The QUANTS structure is used only for internal quantizer setup in
46 // av1_quantize.c.
47 // All of its fields use the same coefficient shift/scaling at TX.
48 typedef struct {
49   // 0: dc 1: ac 2-8: ac repeated to SIMD width
50   DECLARE_ALIGNED(16, int16_t, y_quant[QINDEX_RANGE][8]);
51   DECLARE_ALIGNED(16, int16_t, y_quant_shift[QINDEX_RANGE][8]);
52   DECLARE_ALIGNED(16, int16_t, y_zbin[QINDEX_RANGE][8]);
53   DECLARE_ALIGNED(16, int16_t, y_round[QINDEX_RANGE][8]);
54 
55   // TODO(jingning): in progress of re-working the quantization. will decide
56   // if we want to deprecate the current use of y_quant.
57   DECLARE_ALIGNED(16, int16_t, y_quant_fp[QINDEX_RANGE][8]);
58   DECLARE_ALIGNED(16, int16_t, u_quant_fp[QINDEX_RANGE][8]);
59   DECLARE_ALIGNED(16, int16_t, v_quant_fp[QINDEX_RANGE][8]);
60   DECLARE_ALIGNED(16, int16_t, y_round_fp[QINDEX_RANGE][8]);
61   DECLARE_ALIGNED(16, int16_t, u_round_fp[QINDEX_RANGE][8]);
62   DECLARE_ALIGNED(16, int16_t, v_round_fp[QINDEX_RANGE][8]);
63 
64   DECLARE_ALIGNED(16, int16_t, u_quant[QINDEX_RANGE][8]);
65   DECLARE_ALIGNED(16, int16_t, v_quant[QINDEX_RANGE][8]);
66   DECLARE_ALIGNED(16, int16_t, u_quant_shift[QINDEX_RANGE][8]);
67   DECLARE_ALIGNED(16, int16_t, v_quant_shift[QINDEX_RANGE][8]);
68   DECLARE_ALIGNED(16, int16_t, u_zbin[QINDEX_RANGE][8]);
69   DECLARE_ALIGNED(16, int16_t, v_zbin[QINDEX_RANGE][8]);
70   DECLARE_ALIGNED(16, int16_t, u_round[QINDEX_RANGE][8]);
71   DECLARE_ALIGNED(16, int16_t, v_round[QINDEX_RANGE][8]);
72 } QUANTS;
73 
74 // The Dequants structure is used only for internal quantizer setup in
75 // av1_quantize.c.
76 // Fields are suffixed according to whether or not they're expressed in
77 // the same coefficient shift/precision as TX or a fixed Q3 format.
78 typedef struct {
79   DECLARE_ALIGNED(16, int16_t,
80                   y_dequant_QTX[QINDEX_RANGE][8]);  // 8: SIMD width
81   DECLARE_ALIGNED(16, int16_t,
82                   u_dequant_QTX[QINDEX_RANGE][8]);  // 8: SIMD width
83   DECLARE_ALIGNED(16, int16_t,
84                   v_dequant_QTX[QINDEX_RANGE][8]);  // 8: SIMD width
85 } Dequants;
86 
87 typedef struct {
88   // Quantization parameters for internal quantizer setup.
89   QUANTS quants;
90   // Dequantization parameters for internal quantizer setup.
91   Dequants dequants;
92 } EncQuantDequantParams;
93 
94 struct AV1_COMP;
95 struct AV1Common;
96 
97 void av1_frame_init_quantizer(struct AV1_COMP *cpi);
98 
99 void av1_init_plane_quantizers(const struct AV1_COMP *cpi, MACROBLOCK *x,
100                                int segment_id);
101 
102 void av1_build_quantizer(aom_bit_depth_t bit_depth, int y_dc_delta_q,
103                          int u_dc_delta_q, int u_ac_delta_q, int v_dc_delta_q,
104                          int v_ac_delta_q, QUANTS *const quants,
105                          Dequants *const deq);
106 
107 void av1_init_quantizer(EncQuantDequantParams *const enc_quant_dequant_params,
108                         const CommonQuantParams *quant_params,
109                         aom_bit_depth_t bit_depth);
110 
111 void av1_set_quantizer(struct AV1Common *const cm, int min_qmlevel,
112                        int max_qmlevel, int q);
113 
114 int av1_quantizer_to_qindex(int quantizer);
115 
116 int av1_qindex_to_quantizer(int qindex);
117 
118 void av1_quantize_skip(intptr_t n_coeffs, tran_low_t *qcoeff_ptr,
119                        tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr);
120 
121 void av1_quantize_fp_facade(const tran_low_t *coeff_ptr, intptr_t n_coeffs,
122                             const MACROBLOCK_PLANE *p, tran_low_t *qcoeff_ptr,
123                             tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr,
124                             const SCAN_ORDER *sc, const QUANT_PARAM *qparam);
125 
126 void av1_quantize_b_facade(const tran_low_t *coeff_ptr, intptr_t n_coeffs,
127                            const MACROBLOCK_PLANE *p, tran_low_t *qcoeff_ptr,
128                            tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr,
129                            const SCAN_ORDER *sc, const QUANT_PARAM *qparam);
130 
131 void av1_quantize_dc_facade(const tran_low_t *coeff_ptr, intptr_t n_coeffs,
132                             const MACROBLOCK_PLANE *p, tran_low_t *qcoeff_ptr,
133                             tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr,
134                             const SCAN_ORDER *sc, const QUANT_PARAM *qparam);
135 
136 #if CONFIG_AV1_HIGHBITDEPTH
137 void av1_highbd_quantize_fp_facade(const tran_low_t *coeff_ptr,
138                                    intptr_t n_coeffs, const MACROBLOCK_PLANE *p,
139                                    tran_low_t *qcoeff_ptr,
140                                    tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr,
141                                    const SCAN_ORDER *sc,
142                                    const QUANT_PARAM *qparam);
143 
144 void av1_highbd_quantize_b_facade(const tran_low_t *coeff_ptr,
145                                   intptr_t n_coeffs, const MACROBLOCK_PLANE *p,
146                                   tran_low_t *qcoeff_ptr,
147                                   tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr,
148                                   const SCAN_ORDER *sc,
149                                   const QUANT_PARAM *qparam);
150 
151 void av1_highbd_quantize_dc_facade(const tran_low_t *coeff_ptr,
152                                    intptr_t n_coeffs, const MACROBLOCK_PLANE *p,
153                                    tran_low_t *qcoeff_ptr,
154                                    tran_low_t *dqcoeff_ptr, uint16_t *eob_ptr,
155                                    const SCAN_ORDER *sc,
156                                    const QUANT_PARAM *qparam);
157 #endif
158 
159 #ifdef __cplusplus
160 }  // extern "C"
161 #endif
162 
163 #endif  // AOM_AV1_ENCODER_AV1_QUANTIZE_H_
164