Coverage Report

Created: 2026-05-24 07:45

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/aom/av1/decoder/decodetxb.c
Line
Count
Source
1
/*
2
 * Copyright (c) 2017, 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
#include "av1/decoder/decodetxb.h"
13
14
#include "aom_ports/mem.h"
15
#include "av1/common/idct.h"
16
#include "av1/common/scan.h"
17
#include "av1/common/txb_common.h"
18
#include "av1/decoder/decodemv.h"
19
20
#define ACCT_STR __func__
21
22
0
static int read_golomb(MACROBLOCKD *xd, aom_reader *r) {
23
0
  int x = 1;
24
0
  int length = 0;
25
0
  int i = 0;
26
27
0
  while (!i) {
28
0
    i = aom_read_bit(r, ACCT_STR);
29
0
    ++length;
30
0
    if (length > 20) {
31
0
      aom_internal_error(xd->error_info, AOM_CODEC_CORRUPT_FRAME,
32
0
                         "Invalid length in read_golomb");
33
0
    }
34
0
  }
35
36
0
  for (i = 0; i < length - 1; ++i) {
37
0
    x <<= 1;
38
0
    x += aom_read_bit(r, ACCT_STR);
39
0
  }
40
41
0
  return x - 1;
42
0
}
43
44
0
static inline int rec_eob_pos(const int eob_token, const int extra) {
45
0
  int eob = av1_eob_group_start[eob_token];
46
0
  if (eob > 2) {
47
0
    eob += extra;
48
0
  }
49
0
  return eob;
50
0
}
51
52
static inline int get_dqv(const int16_t *dequant, int coeff_idx,
53
0
                          const qm_val_t *iqmatrix) {
54
0
  int dqv = dequant[!!coeff_idx];
55
0
  if (iqmatrix != NULL)
56
0
    dqv =
57
0
        ((iqmatrix[coeff_idx] * dqv) + (1 << (AOM_QM_BITS - 1))) >> AOM_QM_BITS;
58
0
  return dqv;
59
0
}
60
61
static inline void read_coeffs_reverse_2d(aom_reader *r, TX_SIZE tx_size,
62
                                          int start_si, int end_si,
63
                                          const int16_t *scan, int bhl,
64
                                          uint8_t *levels,
65
                                          base_cdf_arr base_cdf,
66
0
                                          br_cdf_arr br_cdf) {
67
0
  for (int c = end_si; c >= start_si; --c) {
68
0
    const int pos = scan[c];
69
0
    const int coeff_ctx = get_lower_levels_ctx_2d(levels, pos, bhl, tx_size);
70
0
    const int nsymbs = 4;
71
0
    int level = aom_read_symbol(r, base_cdf[coeff_ctx], nsymbs, ACCT_STR);
72
0
    if (level > NUM_BASE_LEVELS) {
73
0
      const int br_ctx = get_br_ctx_2d(levels, pos, bhl);
74
0
      aom_cdf_prob *cdf = br_cdf[br_ctx];
75
0
      for (int idx = 0; idx < COEFF_BASE_RANGE; idx += BR_CDF_SIZE - 1) {
76
0
        const int k = aom_read_symbol(r, cdf, BR_CDF_SIZE, ACCT_STR);
77
0
        level += k;
78
0
        if (k < BR_CDF_SIZE - 1) break;
79
0
      }
80
0
    }
81
0
    levels[get_padded_idx(pos, bhl)] = level;
82
0
  }
83
0
}
84
85
static inline void read_coeffs_reverse(aom_reader *r, TX_SIZE tx_size,
86
                                       TX_CLASS tx_class, int start_si,
87
                                       int end_si, const int16_t *scan, int bhl,
88
                                       uint8_t *levels, base_cdf_arr base_cdf,
89
0
                                       br_cdf_arr br_cdf) {
90
0
  for (int c = end_si; c >= start_si; --c) {
91
0
    const int pos = scan[c];
92
0
    const int coeff_ctx =
93
0
        get_lower_levels_ctx(levels, pos, bhl, tx_size, tx_class);
94
0
    const int nsymbs = 4;
95
0
    int level = aom_read_symbol(r, base_cdf[coeff_ctx], nsymbs, ACCT_STR);
96
0
    if (level > NUM_BASE_LEVELS) {
97
0
      const int br_ctx = get_br_ctx(levels, pos, bhl, tx_class);
98
0
      aom_cdf_prob *cdf = br_cdf[br_ctx];
99
0
      for (int idx = 0; idx < COEFF_BASE_RANGE; idx += BR_CDF_SIZE - 1) {
100
0
        const int k = aom_read_symbol(r, cdf, BR_CDF_SIZE, ACCT_STR);
101
0
        level += k;
102
0
        if (k < BR_CDF_SIZE - 1) break;
103
0
      }
104
0
    }
105
0
    levels[get_padded_idx(pos, bhl)] = level;
106
0
  }
107
0
}
108
109
static uint8_t read_coeffs_txb(const AV1_COMMON *const cm,
110
                               DecoderCodingBlock *dcb, aom_reader *const r,
111
                               const int blk_row, const int blk_col,
112
                               const int plane, const TXB_CTX *const txb_ctx,
113
0
                               const TX_SIZE tx_size) {
114
0
  MACROBLOCKD *const xd = &dcb->xd;
115
0
  FRAME_CONTEXT *const ec_ctx = xd->tile_ctx;
116
0
  const int32_t max_value = (1 << (7 + xd->bd)) - 1;
117
0
  const int32_t min_value = -(1 << (7 + xd->bd));
118
0
  const TX_SIZE txs_ctx = get_txsize_entropy_ctx(tx_size);
119
0
  const PLANE_TYPE plane_type = get_plane_type(plane);
120
0
  MB_MODE_INFO *const mbmi = xd->mi[0];
121
0
  struct macroblockd_plane *const pd = &xd->plane[plane];
122
0
  const int16_t *const dequant = pd->seg_dequant_QTX[mbmi->segment_id];
123
0
  tran_low_t *const tcoeffs = dcb->dqcoeff_block[plane] + dcb->cb_offset[plane];
124
0
  const int shift = av1_get_tx_scale(tx_size);
125
0
  const int bhl = get_txb_bhl(tx_size);
126
0
  const int width = get_txb_wide(tx_size);
127
0
  const int height = get_txb_high(tx_size);
128
0
  int cul_level = 0;
129
0
  int dc_val = 0;
130
0
  uint8_t levels_buf[TX_PAD_2D];
131
0
  uint8_t *const levels = set_levels(levels_buf, height);
132
0
  const int all_zero = aom_read_symbol(
133
0
      r, ec_ctx->txb_skip_cdf[txs_ctx][txb_ctx->txb_skip_ctx], 2, ACCT_STR);
134
0
  eob_info *eob_data = dcb->eob_data[plane] + dcb->txb_offset[plane];
135
0
  uint16_t *const eob = &(eob_data->eob);
136
0
  uint16_t *const max_scan_line = &(eob_data->max_scan_line);
137
0
  *max_scan_line = 0;
138
0
  *eob = 0;
139
140
#if CONFIG_INSPECTION
141
  if (plane == 0) {
142
    const int txk_type_idx =
143
        av1_get_txk_type_index(mbmi->bsize, blk_row, blk_col);
144
    mbmi->tx_skip[txk_type_idx] = all_zero;
145
  }
146
#endif
147
148
0
  if (all_zero) {
149
0
    *max_scan_line = 0;
150
0
    if (plane == 0) {
151
0
      xd->tx_type_map[blk_row * xd->tx_type_map_stride + blk_col] = DCT_DCT;
152
0
    }
153
0
    return 0;
154
0
  }
155
156
0
  if (plane == AOM_PLANE_Y) {
157
    // only y plane's tx_type is transmitted
158
0
    av1_read_tx_type(cm, xd, blk_row, blk_col, tx_size, r);
159
0
  }
160
0
  const TX_TYPE tx_type =
161
0
      av1_get_tx_type(xd, plane_type, blk_row, blk_col, tx_size,
162
0
                      cm->features.reduced_tx_set_used);
163
0
  const TX_CLASS tx_class = tx_type_to_class[tx_type];
164
0
  const qm_val_t *iqmatrix =
165
0
      av1_get_iqmatrix(&cm->quant_params, xd, plane, tx_size, tx_type);
166
0
  const SCAN_ORDER *const scan_order = get_scan(tx_size, tx_type);
167
0
  const int16_t *const scan = scan_order->scan;
168
0
  int eob_extra = 0;
169
0
  int eob_pt = 1;
170
171
0
  const int eob_multi_size = txsize_log2_minus4[tx_size];
172
0
  const int eob_multi_ctx = (tx_class == TX_CLASS_2D) ? 0 : 1;
173
0
  switch (eob_multi_size) {
174
0
    case 0:
175
0
      eob_pt =
176
0
          aom_read_symbol(r, ec_ctx->eob_flag_cdf16[plane_type][eob_multi_ctx],
177
0
                          5, ACCT_STR) +
178
0
          1;
179
0
      break;
180
0
    case 1:
181
0
      eob_pt =
182
0
          aom_read_symbol(r, ec_ctx->eob_flag_cdf32[plane_type][eob_multi_ctx],
183
0
                          6, ACCT_STR) +
184
0
          1;
185
0
      break;
186
0
    case 2:
187
0
      eob_pt =
188
0
          aom_read_symbol(r, ec_ctx->eob_flag_cdf64[plane_type][eob_multi_ctx],
189
0
                          7, ACCT_STR) +
190
0
          1;
191
0
      break;
192
0
    case 3:
193
0
      eob_pt =
194
0
          aom_read_symbol(r, ec_ctx->eob_flag_cdf128[plane_type][eob_multi_ctx],
195
0
                          8, ACCT_STR) +
196
0
          1;
197
0
      break;
198
0
    case 4:
199
0
      eob_pt =
200
0
          aom_read_symbol(r, ec_ctx->eob_flag_cdf256[plane_type][eob_multi_ctx],
201
0
                          9, ACCT_STR) +
202
0
          1;
203
0
      break;
204
0
    case 5:
205
0
      eob_pt =
206
0
          aom_read_symbol(r, ec_ctx->eob_flag_cdf512[plane_type][eob_multi_ctx],
207
0
                          10, ACCT_STR) +
208
0
          1;
209
0
      break;
210
0
    case 6:
211
0
    default:
212
0
      eob_pt = aom_read_symbol(
213
0
                   r, ec_ctx->eob_flag_cdf1024[plane_type][eob_multi_ctx], 11,
214
0
                   ACCT_STR) +
215
0
               1;
216
0
      break;
217
0
  }
218
219
0
  const int eob_offset_bits = av1_eob_offset_bits[eob_pt];
220
0
  if (eob_offset_bits > 0) {
221
0
    const int eob_ctx = eob_pt - 3;
222
0
    int bit = aom_read_symbol(
223
0
        r, ec_ctx->eob_extra_cdf[txs_ctx][plane_type][eob_ctx], 2, ACCT_STR);
224
0
    if (bit) {
225
0
      eob_extra += (1 << (eob_offset_bits - 1));
226
0
    }
227
228
0
    for (int i = 1; i < eob_offset_bits; i++) {
229
0
      bit = aom_read_bit(r, ACCT_STR);
230
0
      if (bit) {
231
0
        eob_extra += (1 << (eob_offset_bits - 1 - i));
232
0
      }
233
0
    }
234
0
  }
235
0
  *eob = rec_eob_pos(eob_pt, eob_extra);
236
237
0
  if (*eob > 1) {
238
0
    memset(levels_buf, 0,
239
0
           sizeof(*levels_buf) *
240
0
               ((height + TX_PAD_HOR) * (width + TX_PAD_VER) + TX_PAD_END));
241
0
  }
242
243
0
  {
244
    // Read the non-zero coefficient with scan index eob-1
245
    // TODO(angiebird): Put this into a function
246
0
    const int c = *eob - 1;
247
0
    const int pos = scan[c];
248
0
    const int coeff_ctx = get_lower_levels_ctx_eob(bhl, width, c);
249
0
    const int nsymbs = 3;
250
0
    aom_cdf_prob *cdf =
251
0
        ec_ctx->coeff_base_eob_cdf[txs_ctx][plane_type][coeff_ctx];
252
0
    int level = aom_read_symbol(r, cdf, nsymbs, ACCT_STR) + 1;
253
0
    if (level > NUM_BASE_LEVELS) {
254
0
      const int br_ctx = get_br_ctx_eob(pos, bhl, tx_class);
255
0
      cdf = ec_ctx->coeff_br_cdf[AOMMIN(txs_ctx, TX_32X32)][plane_type][br_ctx];
256
0
      for (int idx = 0; idx < COEFF_BASE_RANGE; idx += BR_CDF_SIZE - 1) {
257
0
        const int k = aom_read_symbol(r, cdf, BR_CDF_SIZE, ACCT_STR);
258
0
        level += k;
259
0
        if (k < BR_CDF_SIZE - 1) break;
260
0
      }
261
0
    }
262
0
    levels[get_padded_idx(pos, bhl)] = level;
263
0
  }
264
0
  if (*eob > 1) {
265
0
    base_cdf_arr base_cdf = ec_ctx->coeff_base_cdf[txs_ctx][plane_type];
266
0
    br_cdf_arr br_cdf =
267
0
        ec_ctx->coeff_br_cdf[AOMMIN(txs_ctx, TX_32X32)][plane_type];
268
0
    if (tx_class == TX_CLASS_2D) {
269
0
      read_coeffs_reverse_2d(r, tx_size, 1, *eob - 1 - 1, scan, bhl, levels,
270
0
                             base_cdf, br_cdf);
271
0
      read_coeffs_reverse(r, tx_size, tx_class, 0, 0, scan, bhl, levels,
272
0
                          base_cdf, br_cdf);
273
0
    } else {
274
0
      read_coeffs_reverse(r, tx_size, tx_class, 0, *eob - 1 - 1, scan, bhl,
275
0
                          levels, base_cdf, br_cdf);
276
0
    }
277
0
  }
278
279
0
  for (int c = 0; c < *eob; ++c) {
280
0
    const int pos = scan[c];
281
0
    uint8_t sign;
282
0
    tran_low_t level = levels[get_padded_idx(pos, bhl)];
283
0
    if (level) {
284
0
      *max_scan_line = AOMMAX(*max_scan_line, pos);
285
0
      if (c == 0) {
286
0
        const int dc_sign_ctx = txb_ctx->dc_sign_ctx;
287
0
        sign = aom_read_symbol(r, ec_ctx->dc_sign_cdf[plane_type][dc_sign_ctx],
288
0
                               2, ACCT_STR);
289
0
      } else {
290
0
        sign = aom_read_bit(r, ACCT_STR);
291
0
      }
292
0
      if (level >= MAX_BASE_BR_RANGE) {
293
0
        level += read_golomb(xd, r);
294
0
      }
295
296
0
      if (c == 0) dc_val = sign ? -level : level;
297
298
      // Bitmasking to clamp level to valid range:
299
      //   The valid range for 8/10/12 bit vdieo is at most 14/16/18 bit
300
0
      level &= 0xfffff;
301
0
      cul_level += level;
302
0
      tran_low_t dq_coeff;
303
      // Bitmasking to clamp dq_coeff to valid range:
304
      //   The valid range for 8/10/12 bit video is at most 17/19/21 bit
305
0
      dq_coeff =
306
0
          (tran_low_t)((int64_t)level * get_dqv(dequant, scan[c], iqmatrix) &
307
0
                       0xffffff);
308
0
      dq_coeff = dq_coeff >> shift;
309
0
      if (sign) {
310
0
        dq_coeff = -dq_coeff;
311
0
      }
312
0
      tcoeffs[pos] = clamp(dq_coeff, min_value, max_value);
313
0
    }
314
0
  }
315
316
0
  cul_level = AOMMIN(COEFF_CONTEXT_MASK, cul_level);
317
318
  // DC value
319
0
  set_dc_sign(&cul_level, dc_val);
320
321
0
  return cul_level;
322
0
}
323
324
void av1_read_coeffs_txb(const AV1_COMMON *const cm, DecoderCodingBlock *dcb,
325
                         aom_reader *const r, const int plane, const int row,
326
0
                         const int col, const TX_SIZE tx_size) {
327
#if TXCOEFF_TIMER
328
  struct aom_usec_timer timer;
329
  aom_usec_timer_start(&timer);
330
#endif
331
0
  MACROBLOCKD *const xd = &dcb->xd;
332
0
  MB_MODE_INFO *const mbmi = xd->mi[0];
333
0
  struct macroblockd_plane *const pd = &xd->plane[plane];
334
335
0
  const BLOCK_SIZE bsize = mbmi->bsize;
336
0
  assert(bsize < BLOCK_SIZES_ALL);
337
0
  const BLOCK_SIZE plane_bsize =
338
0
      get_plane_block_size(bsize, pd->subsampling_x, pd->subsampling_y);
339
340
0
  TXB_CTX txb_ctx;
341
0
  get_txb_ctx(plane_bsize, tx_size, plane, pd->above_entropy_context + col,
342
0
              pd->left_entropy_context + row, &txb_ctx);
343
344
0
  assert(dcb->xd.error_info->setjmp);
345
0
  const uint8_t cul_level =
346
0
      read_coeffs_txb(cm, dcb, r, row, col, plane, &txb_ctx, tx_size);
347
0
  av1_set_entropy_contexts(xd, pd, plane, plane_bsize, tx_size, cul_level, col,
348
0
                           row);
349
350
0
  if (is_inter_block(mbmi)) {
351
0
    const PLANE_TYPE plane_type = get_plane_type(plane);
352
    // tx_type will be read out in av1_read_coeffs_txb_facade
353
0
    const TX_TYPE tx_type = av1_get_tx_type(xd, plane_type, row, col, tx_size,
354
0
                                            cm->features.reduced_tx_set_used);
355
356
0
    if (plane == 0) {
357
0
      const int txw = tx_size_wide_unit[tx_size];
358
0
      const int txh = tx_size_high_unit[tx_size];
359
      // The 16x16 unit is due to the constraint from tx_64x64 which sets the
360
      // maximum tx size for chroma as 32x32. Coupled with 4x1 transform block
361
      // size, the constraint takes effect in 32x16 / 16x32 size too. To solve
362
      // the intricacy, cover all the 16x16 units inside a 64 level transform.
363
0
      if (txw == tx_size_wide_unit[TX_64X64] ||
364
0
          txh == tx_size_high_unit[TX_64X64]) {
365
0
        const int tx_unit = tx_size_wide_unit[TX_16X16];
366
0
        const int stride = xd->tx_type_map_stride;
367
0
        for (int idy = 0; idy < txh; idy += tx_unit) {
368
0
          for (int idx = 0; idx < txw; idx += tx_unit) {
369
0
            xd->tx_type_map[(row + idy) * stride + col + idx] = tx_type;
370
0
          }
371
0
        }
372
0
      }
373
0
    }
374
0
  }
375
376
#if TXCOEFF_TIMER
377
  aom_usec_timer_mark(&timer);
378
  const int64_t elapsed_time = aom_usec_timer_elapsed(&timer);
379
  cm->txcoeff_timer += elapsed_time;
380
  ++cm->txb_count;
381
#endif
382
0
}