Coverage Report

Created: 2025-06-22 08:04

/src/aom/av1/encoder/pickrst.h
Line
Count
Source (jump to first uncovered line)
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
#ifndef AOM_AV1_ENCODER_PICKRST_H_
12
#define AOM_AV1_ENCODER_PICKRST_H_
13
14
#ifdef __cplusplus
15
extern "C" {
16
#endif
17
18
#include "av1/encoder/encoder.h"
19
20
struct yv12_buffer_config;
21
struct AV1_COMP;
22
23
// Enable extra debugging for loop restoration costing?
24
//
25
// If this is set to 1, then we record not just the selected LR parameters, but
26
// also the values which the search process thinks they should be delta-coded
27
// against. Then, when writing out the bitstream, we verify this information,
28
// to help ensure that the search code is costing things properly
29
#define DEBUG_LR_COSTING 0
30
31
#if DEBUG_LR_COSTING
32
#define MAX_LR_UNITS_W 64
33
#define MAX_LR_UNITS_H 64
34
35
// Storage for reference parameters.
36
//
37
// The storage size is determined by:
38
// * This is always written and then checked within the same frame encode pass,
39
//   so we do not need to buffer multiple frames of data
40
// * The parameters can be different per plane within one frame
41
// * The relevant set of ref parameters can differ between the search where
42
//   we set the frame restoration mode to RESTORE_WIENER, and the search where
43
//   we set it to RESTORE_SWITCHABLE.
44
//   So we need to store at least two sets of Wiener params and two sets of
45
//   SGR params, and the easiest way to do this is to index by
46
//   frame_restoration_type
47
extern RestorationUnitInfo lr_ref_params[RESTORE_TYPES][MAX_MB_PLANE]
48
                                        [MAX_LR_UNITS_W * MAX_LR_UNITS_H];
49
#endif  // DEBUG_LR_COSTING
50
51
static const uint8_t g_shuffle_stats_data[16] = {
52
  0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, 8,
53
};
54
55
static const uint8_t g_shuffle_stats_highbd_data[32] = {
56
  0, 1, 2, 3, 2, 3, 4, 5, 4, 5, 6, 7, 6, 7, 8, 9,
57
  0, 1, 2, 3, 2, 3, 4, 5, 4, 5, 6, 7, 6, 7, 8, 9,
58
};
59
60
static inline uint8_t find_average(const uint8_t *src, int h_start, int h_end,
61
0
                                   int v_start, int v_end, int stride) {
62
0
  uint64_t sum = 0;
63
0
  for (int i = v_start; i < v_end; i++) {
64
0
    for (int j = h_start; j < h_end; j++) {
65
0
      sum += src[i * stride + j];
66
0
    }
67
0
  }
68
0
  uint64_t avg = sum / ((v_end - v_start) * (h_end - h_start));
69
0
  return (uint8_t)avg;
70
0
}
Unexecuted instantiation: bitstream.c:find_average
Unexecuted instantiation: encoder.c:find_average
Unexecuted instantiation: pickrst.c:find_average
71
72
#if CONFIG_AV1_HIGHBITDEPTH
73
static inline uint16_t find_average_highbd(const uint16_t *src, int h_start,
74
                                           int h_end, int v_start, int v_end,
75
0
                                           int stride) {
76
0
  uint64_t sum = 0;
77
0
  for (int i = v_start; i < v_end; i++) {
78
0
    for (int j = h_start; j < h_end; j++) {
79
0
      sum += src[i * stride + j];
80
0
    }
81
0
  }
82
0
  uint64_t avg = sum / ((v_end - v_start) * (h_end - h_start));
83
0
  return (uint16_t)avg;
84
0
}
Unexecuted instantiation: bitstream.c:find_average_highbd
Unexecuted instantiation: encoder.c:find_average_highbd
Unexecuted instantiation: pickrst.c:find_average_highbd
85
#endif
86
87
/*!\brief Algorithm for AV1 loop restoration search and estimation.
88
 *
89
 * \ingroup in_loop_restoration
90
 * This function determines proper restoration filter types and
91
 * associated parameters for each restoration unit in a frame.
92
 *
93
 * \param[in]       sd           Source frame buffer
94
 * \param[in,out]   cpi          Top-level encoder structure
95
 *
96
 * \remark Nothing is returned. Instead, chosen restoration filter
97
 * types and parameters are stored per plane in the \c rst_info structure
98
 * of type \ref RestorationInfo inside \c cpi->common:
99
 * \arg \c rst_info[ \c 0 ]: Chosen parameters for Y plane
100
 * \arg \c rst_info[ \c 1 ]: Chosen parameters for U plane if it exists
101
 * \arg \c rst_info[ \c 2 ]: Chosen parameters for V plane if it exists
102
 * \par
103
 * The following fields in each \c rst_info[ \c p], \c p = 0, 1, 2
104
 * are populated:
105
 * \arg \c rst_info[ \c p ].\c frame_restoration_type
106
 * \arg \c rst_info[ \c p ].\c unit_info[ \c u ],
107
 * for each \c u in 0, 1, ..., \c n( \c p ) - 1,
108
 * where \c n( \c p ) is the number of restoration units in plane \c p.
109
 * \par
110
 * The following fields in each \c rst_info[ \c p ].\c unit_info[ \c u ],
111
 * \c p = 0, 1, 2 and \c u = 0, 1, ..., \c n( \c p ) - 1, of type
112
 * \ref RestorationUnitInfo are populated:
113
 * \arg \c rst_info[ \c p ].\c unit_info[ \c u ].\c restoration_type
114
 * \arg \c rst_info[ \c p ].\c unit_info[ \c u ].\c wiener_info OR
115
 *      \c rst_info[ \c p ].\c unit_info[ \c u ].\c sgrproj_info OR
116
 *      neither, depending on
117
 *      \c rst_info[ \c p ].\c unit_info[ \c u ].\c restoration_type
118
 *
119
 */
120
void av1_pick_filter_restoration(const YV12_BUFFER_CONFIG *sd, AV1_COMP *cpi);
121
122
#ifdef __cplusplus
123
}  // extern "C"
124
#endif
125
126
#endif  // AOM_AV1_ENCODER_PICKRST_H_