Coverage Report

Created: 2026-04-01 07:24

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/aom/av1/common/restoration.c
Line
Count
Source
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
13
#include <math.h>
14
#include <stddef.h>
15
16
#include "config/aom_config.h"
17
#include "config/aom_scale_rtcd.h"
18
19
#include "aom/internal/aom_codec_internal.h"
20
#include "aom_mem/aom_mem.h"
21
#include "aom_dsp/aom_dsp_common.h"
22
#include "aom_mem/aom_mem.h"
23
#include "aom_ports/mem.h"
24
#include "aom_util/aom_pthread.h"
25
26
#include "av1/common/av1_common_int.h"
27
#include "av1/common/convolve.h"
28
#include "av1/common/enums.h"
29
#include "av1/common/resize.h"
30
#include "av1/common/restoration.h"
31
#include "av1/common/thread_common.h"
32
33
// The 's' values are calculated based on original 'r' and 'e' values in the
34
// spec using GenSgrprojVtable().
35
// Note: Setting r = 0 skips the filter; with corresponding s = -1 (invalid).
36
const sgr_params_type av1_sgr_params[SGRPROJ_PARAMS] = {
37
  { { 2, 1 }, { 140, 3236 } }, { { 2, 1 }, { 112, 2158 } },
38
  { { 2, 1 }, { 93, 1618 } },  { { 2, 1 }, { 80, 1438 } },
39
  { { 2, 1 }, { 70, 1295 } },  { { 2, 1 }, { 58, 1177 } },
40
  { { 2, 1 }, { 47, 1079 } },  { { 2, 1 }, { 37, 996 } },
41
  { { 2, 1 }, { 30, 925 } },   { { 2, 1 }, { 25, 863 } },
42
  { { 0, 1 }, { -1, 2589 } },  { { 0, 1 }, { -1, 1618 } },
43
  { { 0, 1 }, { -1, 1177 } },  { { 0, 1 }, { -1, 925 } },
44
  { { 2, 0 }, { 56, -1 } },    { { 2, 0 }, { 22, -1 } },
45
};
46
47
void av1_get_upsampled_plane_size(const AV1_COMMON *cm, int is_uv, int *plane_w,
48
48.6k
                                  int *plane_h) {
49
48.6k
  int ss_x = is_uv && cm->seq_params->subsampling_x;
50
48.6k
  int ss_y = is_uv && cm->seq_params->subsampling_y;
51
48.6k
  *plane_w = ROUND_POWER_OF_TWO(cm->superres_upscaled_width, ss_x);
52
48.6k
  *plane_h = ROUND_POWER_OF_TWO(cm->height, ss_y);
53
48.6k
}
54
55
// Count horizontal or vertical units in a plane (use a width or height for
56
// plane_size, respectively). We basically want to divide the plane size by the
57
// size of a restoration unit. Rather than rounding up unconditionally as you
58
// might expect, we round to nearest, which models the way a right or bottom
59
// restoration unit can extend to up to 150% its normal width or height.
60
//
61
// The max with 1 is to deal with small frames, which may be smaller than
62
// half of an LR unit in size.
63
52.0k
int av1_lr_count_units(int unit_size, int plane_size) {
64
52.0k
  return AOMMAX((plane_size + (unit_size >> 1)) / unit_size, 1);
65
52.0k
}
66
67
void av1_alloc_restoration_struct(AV1_COMMON *cm, RestorationInfo *rsi,
68
19.0k
                                  int is_uv) {
69
19.0k
  int plane_w, plane_h;
70
19.0k
  av1_get_upsampled_plane_size(cm, is_uv, &plane_w, &plane_h);
71
72
19.0k
  const int unit_size = rsi->restoration_unit_size;
73
19.0k
  const int horz_units = av1_lr_count_units(unit_size, plane_w);
74
19.0k
  const int vert_units = av1_lr_count_units(unit_size, plane_h);
75
76
19.0k
  rsi->num_rest_units = horz_units * vert_units;
77
19.0k
  rsi->horz_units = horz_units;
78
19.0k
  rsi->vert_units = vert_units;
79
80
19.0k
  aom_free(rsi->unit_info);
81
19.0k
  CHECK_MEM_ERROR(cm, rsi->unit_info,
82
19.0k
                  (RestorationUnitInfo *)aom_memalign(
83
19.0k
                      16, sizeof(*rsi->unit_info) * rsi->num_rest_units));
84
19.0k
}
85
86
61.7k
void av1_free_restoration_struct(RestorationInfo *rst_info) {
87
61.7k
  aom_free(rst_info->unit_info);
88
61.7k
  rst_info->unit_info = NULL;
89
61.7k
}
90
91
#if 0
92
// Pair of values for each sgrproj parameter:
93
// Index 0 corresponds to r[0], e[0]
94
// Index 1 corresponds to r[1], e[1]
95
int sgrproj_mtable[SGRPROJ_PARAMS][2];
96
97
static void GenSgrprojVtable(void) {
98
  for (int i = 0; i < SGRPROJ_PARAMS; ++i) {
99
    const sgr_params_type *const params = &av1_sgr_params[i];
100
    for (int j = 0; j < 2; ++j) {
101
      const int e = params->e[j];
102
      const int r = params->r[j];
103
      if (r == 0) {                 // filter is disabled
104
        sgrproj_mtable[i][j] = -1;  // mark invalid
105
      } else {                      // filter is enabled
106
        const int n = (2 * r + 1) * (2 * r + 1);
107
        const int n2e = n * n * e;
108
        assert(n2e != 0);
109
        sgrproj_mtable[i][j] = (((1 << SGRPROJ_MTABLE_BITS) + n2e / 2) / n2e);
110
      }
111
    }
112
  }
113
}
114
#endif
115
116
20.5k
void av1_loop_restoration_precal(void) {
117
#if 0
118
  GenSgrprojVtable();
119
#endif
120
20.5k
}
121
122
static void extend_frame_lowbd(uint8_t *data, int width, int height,
123
                               ptrdiff_t stride, int border_horz,
124
2.50k
                               int border_vert) {
125
2.50k
  uint8_t *data_p;
126
2.50k
  int i;
127
832k
  for (i = 0; i < height; ++i) {
128
829k
    data_p = data + i * stride;
129
829k
    memset(data_p - border_horz, data_p[0], border_horz);
130
829k
    memset(data_p + width, data_p[width - 1], border_horz);
131
829k
  }
132
2.50k
  data_p = data - border_horz;
133
10.0k
  for (i = -border_vert; i < 0; ++i) {
134
7.52k
    memcpy(data_p + i * stride, data_p, width + 2 * border_horz);
135
7.52k
  }
136
10.0k
  for (i = height; i < height + border_vert; ++i) {
137
7.52k
    memcpy(data_p + i * stride, data_p + (height - 1) * stride,
138
7.52k
           width + 2 * border_horz);
139
7.52k
  }
140
2.50k
}
141
142
#if CONFIG_AV1_HIGHBITDEPTH
143
static void extend_frame_highbd(uint16_t *data, int width, int height,
144
                                ptrdiff_t stride, int border_horz,
145
4.94k
                                int border_vert) {
146
4.94k
  uint16_t *data_p;
147
4.94k
  int i, j;
148
1.30M
  for (i = 0; i < height; ++i) {
149
1.29M
    data_p = data + i * stride;
150
5.19M
    for (j = -border_horz; j < 0; ++j) data_p[j] = data_p[0];
151
5.19M
    for (j = width; j < width + border_horz; ++j) data_p[j] = data_p[width - 1];
152
1.29M
  }
153
4.94k
  data_p = data - border_horz;
154
19.7k
  for (i = -border_vert; i < 0; ++i) {
155
14.8k
    memcpy(data_p + i * stride, data_p,
156
14.8k
           (width + 2 * border_horz) * sizeof(uint16_t));
157
14.8k
  }
158
19.7k
  for (i = height; i < height + border_vert; ++i) {
159
14.8k
    memcpy(data_p + i * stride, data_p + (height - 1) * stride,
160
14.8k
           (width + 2 * border_horz) * sizeof(uint16_t));
161
14.8k
  }
162
4.94k
}
163
164
static void copy_rest_unit_highbd(int width, int height, const uint16_t *src,
165
                                  int src_stride, uint16_t *dst,
166
6.67k
                                  int dst_stride) {
167
418k
  for (int i = 0; i < height; ++i)
168
411k
    memcpy(dst + i * dst_stride, src + i * src_stride, width * sizeof(*dst));
169
6.67k
}
170
#endif
171
172
void av1_extend_frame(uint8_t *data, int width, int height, int stride,
173
7.44k
                      int border_horz, int border_vert, int highbd) {
174
7.44k
#if CONFIG_AV1_HIGHBITDEPTH
175
7.44k
  if (highbd) {
176
4.94k
    extend_frame_highbd(CONVERT_TO_SHORTPTR(data), width, height, stride,
177
4.94k
                        border_horz, border_vert);
178
4.94k
    return;
179
4.94k
  }
180
2.50k
#endif
181
2.50k
  (void)highbd;
182
2.50k
  extend_frame_lowbd(data, width, height, stride, border_horz, border_vert);
183
2.50k
}
184
185
static void copy_rest_unit_lowbd(int width, int height, const uint8_t *src,
186
5.66k
                                 int src_stride, uint8_t *dst, int dst_stride) {
187
370k
  for (int i = 0; i < height; ++i)
188
364k
    memcpy(dst + i * dst_stride, src + i * src_stride, width);
189
5.66k
}
190
191
static void copy_rest_unit(int width, int height, const uint8_t *src,
192
                           int src_stride, uint8_t *dst, int dst_stride,
193
12.3k
                           int highbd) {
194
12.3k
#if CONFIG_AV1_HIGHBITDEPTH
195
12.3k
  if (highbd) {
196
6.69k
    copy_rest_unit_highbd(width, height, CONVERT_TO_SHORTPTR(src), src_stride,
197
6.69k
                          CONVERT_TO_SHORTPTR(dst), dst_stride);
198
6.69k
    return;
199
6.69k
  }
200
5.69k
#endif
201
5.69k
  (void)highbd;
202
5.69k
  copy_rest_unit_lowbd(width, height, src, src_stride, dst, dst_stride);
203
5.69k
}
204
205
530k
#define REAL_PTR(hbd, d) ((hbd) ? (uint8_t *)CONVERT_TO_SHORTPTR(d) : (d))
206
207
// With striped loop restoration, the filtering for each 64-pixel stripe gets
208
// most of its input from the output of CDEF (stored in data8), but we need to
209
// fill out a border of 3 pixels above/below the stripe according to the
210
// following rules:
211
//
212
// * At the top and bottom of the frame, we copy the outermost row of CDEF
213
//   pixels three times. This extension is done by a call to av1_extend_frame()
214
//   at the start of the loop restoration process, so the value of
215
//   copy_above/copy_below doesn't strictly matter.
216
//
217
// * All other boundaries are stripe boundaries within the frame. In that case,
218
//   we take 2 rows of deblocked pixels and extend them to 3 rows of context.
219
static void get_stripe_boundary_info(const RestorationTileLimits *limits,
220
                                     int plane_w, int plane_h, int ss_y,
221
32.7k
                                     int *copy_above, int *copy_below) {
222
32.7k
  (void)plane_w;
223
224
32.7k
  *copy_above = 1;
225
32.7k
  *copy_below = 1;
226
227
32.7k
  const int full_stripe_height = RESTORATION_PROC_UNIT_SIZE >> ss_y;
228
32.7k
  const int runit_offset = RESTORATION_UNIT_OFFSET >> ss_y;
229
230
32.7k
  const int first_stripe_in_plane = (limits->v_start == 0);
231
32.7k
  const int this_stripe_height =
232
32.7k
      full_stripe_height - (first_stripe_in_plane ? runit_offset : 0);
233
32.7k
  const int last_stripe_in_plane =
234
32.7k
      (limits->v_start + this_stripe_height >= plane_h);
235
236
32.7k
  if (first_stripe_in_plane) *copy_above = 0;
237
32.7k
  if (last_stripe_in_plane) *copy_below = 0;
238
32.7k
}
239
240
// Overwrite the border pixels around a processing stripe so that the conditions
241
// listed above get_stripe_boundary_info() are preserved.
242
// We save the pixels which get overwritten into a temporary buffer, so that
243
// they can be restored by restore_processing_stripe_boundary() after we've
244
// processed the stripe.
245
//
246
// limits gives the rectangular limits of the remaining stripes for the current
247
// restoration unit. rsb is the stored stripe boundaries (taken from either
248
// deblock or CDEF output as necessary).
249
static void setup_processing_stripe_boundary(
250
    const RestorationTileLimits *limits, const RestorationStripeBoundaries *rsb,
251
    int rsb_row, int use_highbd, int h, uint8_t *data8, int data_stride,
252
32.7k
    RestorationLineBuffers *rlbs, int copy_above, int copy_below, int opt) {
253
  // Offsets within the line buffers. The buffer logically starts at column
254
  // -RESTORATION_EXTRA_HORZ so the 1st column (at x0 - RESTORATION_EXTRA_HORZ)
255
  // has column x0 in the buffer.
256
32.7k
  const int buf_stride = rsb->stripe_boundary_stride;
257
32.7k
  const int buf_x0_off = limits->h_start;
258
32.7k
  const int line_width =
259
32.7k
      (limits->h_end - limits->h_start) + 2 * RESTORATION_EXTRA_HORZ;
260
32.7k
  const int line_size = line_width << use_highbd;
261
262
32.7k
  const int data_x0 = limits->h_start - RESTORATION_EXTRA_HORZ;
263
264
  // Replace RESTORATION_BORDER pixels above the top of the stripe
265
  // We expand RESTORATION_CTX_VERT=2 lines from rsb->stripe_boundary_above
266
  // to fill RESTORATION_BORDER=3 lines of above pixels. This is done by
267
  // duplicating the topmost of the 2 lines (see the AOMMAX call when
268
  // calculating src_row, which gets the values 0, 0, 1 for i = -3, -2, -1).
269
32.7k
  if (!opt) {
270
23.3k
    if (copy_above) {
271
19.9k
      uint8_t *data8_tl = data8 + data_x0 + limits->v_start * data_stride;
272
273
79.8k
      for (int i = -RESTORATION_BORDER; i < 0; ++i) {
274
59.8k
        const int buf_row = rsb_row + AOMMAX(i + RESTORATION_CTX_VERT, 0);
275
59.8k
        const int buf_off = buf_x0_off + buf_row * buf_stride;
276
59.8k
        const uint8_t *buf =
277
59.8k
            rsb->stripe_boundary_above + (buf_off << use_highbd);
278
59.8k
        uint8_t *dst8 = data8_tl + i * data_stride;
279
        // Save old pixels, then replace with data from stripe_boundary_above
280
59.8k
        memcpy(rlbs->tmp_save_above[i + RESTORATION_BORDER],
281
59.8k
               REAL_PTR(use_highbd, dst8), line_size);
282
59.8k
        memcpy(REAL_PTR(use_highbd, dst8), buf, line_size);
283
59.8k
      }
284
19.9k
    }
285
286
    // Replace RESTORATION_BORDER pixels below the bottom of the stripe.
287
    // The second buffer row is repeated, so src_row gets the values 0, 1, 1
288
    // for i = 0, 1, 2.
289
23.3k
    if (copy_below) {
290
18.1k
      const int stripe_end = limits->v_start + h;
291
18.1k
      uint8_t *data8_bl = data8 + data_x0 + stripe_end * data_stride;
292
293
72.6k
      for (int i = 0; i < RESTORATION_BORDER; ++i) {
294
54.4k
        const int buf_row = rsb_row + AOMMIN(i, RESTORATION_CTX_VERT - 1);
295
54.4k
        const int buf_off = buf_x0_off + buf_row * buf_stride;
296
54.4k
        const uint8_t *src =
297
54.4k
            rsb->stripe_boundary_below + (buf_off << use_highbd);
298
299
54.4k
        uint8_t *dst8 = data8_bl + i * data_stride;
300
        // Save old pixels, then replace with data from stripe_boundary_below
301
54.4k
        memcpy(rlbs->tmp_save_below[i], REAL_PTR(use_highbd, dst8), line_size);
302
54.4k
        memcpy(REAL_PTR(use_highbd, dst8), src, line_size);
303
54.4k
      }
304
18.1k
    }
305
23.3k
  } else {
306
9.41k
    if (copy_above) {
307
8.61k
      uint8_t *data8_tl = data8 + data_x0 + limits->v_start * data_stride;
308
309
      // Only save and overwrite i=-RESTORATION_BORDER line.
310
8.61k
      uint8_t *dst8 = data8_tl + (-RESTORATION_BORDER) * data_stride;
311
      // Save old pixels, then replace with data from stripe_boundary_above
312
8.61k
      memcpy(rlbs->tmp_save_above[0], REAL_PTR(use_highbd, dst8), line_size);
313
8.61k
      memcpy(REAL_PTR(use_highbd, dst8),
314
8.61k
             REAL_PTR(use_highbd,
315
8.61k
                      data8_tl + (-RESTORATION_BORDER + 1) * data_stride),
316
8.61k
             line_size);
317
8.61k
    }
318
319
9.41k
    if (copy_below) {
320
8.63k
      const int stripe_end = limits->v_start + h;
321
8.63k
      uint8_t *data8_bl = data8 + data_x0 + stripe_end * data_stride;
322
323
      // Only save and overwrite i=2 line.
324
8.63k
      uint8_t *dst8 = data8_bl + 2 * data_stride;
325
      // Save old pixels, then replace with data from stripe_boundary_below
326
8.63k
      memcpy(rlbs->tmp_save_below[2], REAL_PTR(use_highbd, dst8), line_size);
327
8.63k
      memcpy(REAL_PTR(use_highbd, dst8),
328
8.63k
             REAL_PTR(use_highbd, data8_bl + (2 - 1) * data_stride), line_size);
329
8.63k
    }
330
9.41k
  }
331
32.7k
}
332
333
// Once a processing stripe is finished, this function sets the boundary
334
// pixels which were overwritten by setup_processing_stripe_boundary()
335
// back to their original values
336
static void restore_processing_stripe_boundary(
337
    const RestorationTileLimits *limits, const RestorationLineBuffers *rlbs,
338
    int use_highbd, int h, uint8_t *data8, int data_stride, int copy_above,
339
32.5k
    int copy_below, int opt) {
340
32.5k
  const int line_width =
341
32.5k
      (limits->h_end - limits->h_start) + 2 * RESTORATION_EXTRA_HORZ;
342
32.5k
  const int line_size = line_width << use_highbd;
343
344
32.5k
  const int data_x0 = limits->h_start - RESTORATION_EXTRA_HORZ;
345
346
32.5k
  if (!opt) {
347
23.3k
    if (copy_above) {
348
19.9k
      uint8_t *data8_tl = data8 + data_x0 + limits->v_start * data_stride;
349
79.9k
      for (int i = -RESTORATION_BORDER; i < 0; ++i) {
350
59.9k
        uint8_t *dst8 = data8_tl + i * data_stride;
351
59.9k
        memcpy(REAL_PTR(use_highbd, dst8),
352
59.9k
               rlbs->tmp_save_above[i + RESTORATION_BORDER], line_size);
353
59.9k
      }
354
19.9k
    }
355
356
23.3k
    if (copy_below) {
357
18.2k
      const int stripe_bottom = limits->v_start + h;
358
18.2k
      uint8_t *data8_bl = data8 + data_x0 + stripe_bottom * data_stride;
359
360
72.8k
      for (int i = 0; i < RESTORATION_BORDER; ++i) {
361
54.6k
        if (stripe_bottom + i >= limits->v_end + RESTORATION_BORDER) break;
362
363
54.6k
        uint8_t *dst8 = data8_bl + i * data_stride;
364
54.6k
        memcpy(REAL_PTR(use_highbd, dst8), rlbs->tmp_save_below[i], line_size);
365
54.6k
      }
366
18.2k
    }
367
23.3k
  } else {
368
9.16k
    if (copy_above) {
369
8.37k
      uint8_t *data8_tl = data8 + data_x0 + limits->v_start * data_stride;
370
371
      // Only restore i=-RESTORATION_BORDER line.
372
8.37k
      uint8_t *dst8 = data8_tl + (-RESTORATION_BORDER) * data_stride;
373
8.37k
      memcpy(REAL_PTR(use_highbd, dst8), rlbs->tmp_save_above[0], line_size);
374
8.37k
    }
375
376
9.16k
    if (copy_below) {
377
8.39k
      const int stripe_bottom = limits->v_start + h;
378
8.39k
      uint8_t *data8_bl = data8 + data_x0 + stripe_bottom * data_stride;
379
380
      // Only restore i=2 line.
381
8.40k
      if (stripe_bottom + 2 < limits->v_end + RESTORATION_BORDER) {
382
8.40k
        uint8_t *dst8 = data8_bl + 2 * data_stride;
383
8.40k
        memcpy(REAL_PTR(use_highbd, dst8), rlbs->tmp_save_below[2], line_size);
384
8.40k
      }
385
8.39k
    }
386
9.16k
  }
387
32.5k
}
388
389
static void wiener_filter_stripe(const RestorationUnitInfo *rui,
390
                                 int stripe_width, int stripe_height,
391
                                 int procunit_width, const uint8_t *src,
392
                                 int src_stride, uint8_t *dst, int dst_stride,
393
                                 int32_t *tmpbuf, int bit_depth,
394
7.48k
                                 struct aom_internal_error_info *error_info) {
395
7.48k
  (void)tmpbuf;
396
7.48k
  (void)bit_depth;
397
7.48k
  (void)error_info;
398
7.48k
  assert(bit_depth == 8);
399
7.48k
  const WienerConvolveParams conv_params = get_conv_params_wiener(8);
400
401
20.9k
  for (int j = 0; j < stripe_width; j += procunit_width) {
402
13.4k
    int w = AOMMIN(procunit_width, (stripe_width - j + 15) & ~15);
403
13.4k
    const uint8_t *src_p = src + j;
404
13.4k
    uint8_t *dst_p = dst + j;
405
13.4k
    av1_wiener_convolve_add_src(
406
13.4k
        src_p, src_stride, dst_p, dst_stride, rui->wiener_info.hfilter, 16,
407
13.4k
        rui->wiener_info.vfilter, 16, w, stripe_height, &conv_params);
408
13.4k
  }
409
7.48k
}
410
411
/* Calculate windowed sums (if sqr=0) or sums of squares (if sqr=1)
412
   over the input. The window is of size (2r + 1)x(2r + 1), and we
413
   specialize to r = 1, 2, 3. A default function is used for r > 3.
414
415
   Each loop follows the same format: We keep a window's worth of input
416
   in individual variables and select data out of that as appropriate.
417
*/
418
static void boxsum1(int32_t *src, int width, int height, int src_stride,
419
33.5k
                    int sqr, int32_t *dst, int dst_stride) {
420
33.5k
  int i, j, a, b, c;
421
33.5k
  assert(width > 2 * SGRPROJ_BORDER_HORZ);
422
33.5k
  assert(height > 2 * SGRPROJ_BORDER_VERT);
423
424
  // Vertical sum over 3-pixel regions, from src into dst.
425
33.5k
  if (!sqr) {
426
739k
    for (j = 0; j < width; ++j) {
427
723k
      a = src[j];
428
723k
      b = src[src_stride + j];
429
723k
      c = src[2 * src_stride + j];
430
431
723k
      dst[j] = a + b;
432
36.0M
      for (i = 1; i < height - 2; ++i) {
433
        // Loop invariant: At the start of each iteration,
434
        // a = src[(i - 1) * src_stride + j]
435
        // b = src[(i    ) * src_stride + j]
436
        // c = src[(i + 1) * src_stride + j]
437
35.3M
        dst[i * dst_stride + j] = a + b + c;
438
35.3M
        a = b;
439
35.3M
        b = c;
440
35.3M
        c = src[(i + 2) * src_stride + j];
441
35.3M
      }
442
723k
      dst[i * dst_stride + j] = a + b + c;
443
723k
      dst[(i + 1) * dst_stride + j] = b + c;
444
723k
    }
445
16.8k
  } else {
446
740k
    for (j = 0; j < width; ++j) {
447
723k
      a = src[j] * src[j];
448
723k
      b = src[src_stride + j] * src[src_stride + j];
449
723k
      c = src[2 * src_stride + j] * src[2 * src_stride + j];
450
451
723k
      dst[j] = a + b;
452
36.1M
      for (i = 1; i < height - 2; ++i) {
453
35.4M
        dst[i * dst_stride + j] = a + b + c;
454
35.4M
        a = b;
455
35.4M
        b = c;
456
35.4M
        c = src[(i + 2) * src_stride + j] * src[(i + 2) * src_stride + j];
457
35.4M
      }
458
723k
      dst[i * dst_stride + j] = a + b + c;
459
723k
      dst[(i + 1) * dst_stride + j] = b + c;
460
723k
    }
461
16.7k
  }
462
463
  // Horizontal sum over 3-pixel regions of dst
464
1.72M
  for (i = 0; i < height; ++i) {
465
1.68M
    a = dst[i * dst_stride];
466
1.68M
    b = dst[i * dst_stride + 1];
467
1.68M
    c = dst[i * dst_stride + 2];
468
469
1.68M
    dst[i * dst_stride] = a + b;
470
70.6M
    for (j = 1; j < width - 2; ++j) {
471
      // Loop invariant: At the start of each iteration,
472
      // a = src[i * src_stride + (j - 1)]
473
      // b = src[i * src_stride + (j    )]
474
      // c = src[i * src_stride + (j + 1)]
475
68.9M
      dst[i * dst_stride + j] = a + b + c;
476
68.9M
      a = b;
477
68.9M
      b = c;
478
68.9M
      c = dst[i * dst_stride + (j + 2)];
479
68.9M
    }
480
1.68M
    dst[i * dst_stride + j] = a + b + c;
481
1.68M
    dst[i * dst_stride + (j + 1)] = b + c;
482
1.68M
  }
483
33.5k
}
484
485
static void boxsum2(int32_t *src, int width, int height, int src_stride,
486
37.3k
                    int sqr, int32_t *dst, int dst_stride) {
487
37.3k
  int i, j, a, b, c, d, e;
488
37.3k
  assert(width > 2 * SGRPROJ_BORDER_HORZ);
489
37.3k
  assert(height > 2 * SGRPROJ_BORDER_VERT);
490
491
  // Vertical sum over 5-pixel regions, from src into dst.
492
37.3k
  if (!sqr) {
493
923k
    for (j = 0; j < width; ++j) {
494
904k
      a = src[j];
495
904k
      b = src[src_stride + j];
496
904k
      c = src[2 * src_stride + j];
497
904k
      d = src[3 * src_stride + j];
498
904k
      e = src[4 * src_stride + j];
499
500
904k
      dst[j] = a + b + c;
501
904k
      dst[dst_stride + j] = a + b + c + d;
502
48.6M
      for (i = 2; i < height - 3; ++i) {
503
        // Loop invariant: At the start of each iteration,
504
        // a = src[(i - 2) * src_stride + j]
505
        // b = src[(i - 1) * src_stride + j]
506
        // c = src[(i    ) * src_stride + j]
507
        // d = src[(i + 1) * src_stride + j]
508
        // e = src[(i + 2) * src_stride + j]
509
47.7M
        dst[i * dst_stride + j] = a + b + c + d + e;
510
47.7M
        a = b;
511
47.7M
        b = c;
512
47.7M
        c = d;
513
47.7M
        d = e;
514
47.7M
        e = src[(i + 3) * src_stride + j];
515
47.7M
      }
516
904k
      dst[i * dst_stride + j] = a + b + c + d + e;
517
904k
      dst[(i + 1) * dst_stride + j] = b + c + d + e;
518
904k
      dst[(i + 2) * dst_stride + j] = c + d + e;
519
904k
    }
520
18.7k
  } else {
521
924k
    for (j = 0; j < width; ++j) {
522
905k
      a = src[j] * src[j];
523
905k
      b = src[src_stride + j] * src[src_stride + j];
524
905k
      c = src[2 * src_stride + j] * src[2 * src_stride + j];
525
905k
      d = src[3 * src_stride + j] * src[3 * src_stride + j];
526
905k
      e = src[4 * src_stride + j] * src[4 * src_stride + j];
527
528
905k
      dst[j] = a + b + c;
529
905k
      dst[dst_stride + j] = a + b + c + d;
530
48.7M
      for (i = 2; i < height - 3; ++i) {
531
47.8M
        dst[i * dst_stride + j] = a + b + c + d + e;
532
47.8M
        a = b;
533
47.8M
        b = c;
534
47.8M
        c = d;
535
47.8M
        d = e;
536
47.8M
        e = src[(i + 3) * src_stride + j] * src[(i + 3) * src_stride + j];
537
47.8M
      }
538
905k
      dst[i * dst_stride + j] = a + b + c + d + e;
539
905k
      dst[(i + 1) * dst_stride + j] = b + c + d + e;
540
905k
      dst[(i + 2) * dst_stride + j] = c + d + e;
541
905k
    }
542
18.6k
  }
543
544
  // Horizontal sum over 5-pixel regions of dst
545
2.11M
  for (i = 0; i < height; ++i) {
546
2.07M
    a = dst[i * dst_stride];
547
2.07M
    b = dst[i * dst_stride + 1];
548
2.07M
    c = dst[i * dst_stride + 2];
549
2.07M
    d = dst[i * dst_stride + 3];
550
2.07M
    e = dst[i * dst_stride + 4];
551
552
2.07M
    dst[i * dst_stride] = a + b + c;
553
2.07M
    dst[i * dst_stride + 1] = a + b + c + d;
554
93.9M
    for (j = 2; j < width - 3; ++j) {
555
      // Loop invariant: At the start of each iteration,
556
      // a = src[i * src_stride + (j - 2)]
557
      // b = src[i * src_stride + (j - 1)]
558
      // c = src[i * src_stride + (j    )]
559
      // d = src[i * src_stride + (j + 1)]
560
      // e = src[i * src_stride + (j + 2)]
561
91.8M
      dst[i * dst_stride + j] = a + b + c + d + e;
562
91.8M
      a = b;
563
91.8M
      b = c;
564
91.8M
      c = d;
565
91.8M
      d = e;
566
91.8M
      e = dst[i * dst_stride + (j + 3)];
567
91.8M
    }
568
2.07M
    dst[i * dst_stride + j] = a + b + c + d + e;
569
2.07M
    dst[i * dst_stride + (j + 1)] = b + c + d + e;
570
2.07M
    dst[i * dst_stride + (j + 2)] = c + d + e;
571
2.07M
  }
572
37.3k
}
573
574
static void boxsum(int32_t *src, int width, int height, int src_stride, int r,
575
70.9k
                   int sqr, int32_t *dst, int dst_stride) {
576
70.9k
  if (r == 1)
577
33.6k
    boxsum1(src, width, height, src_stride, sqr, dst, dst_stride);
578
37.3k
  else if (r == 2)
579
37.4k
    boxsum2(src, width, height, src_stride, sqr, dst, dst_stride);
580
18.4E
  else
581
18.4E
    assert(0 && "Invalid value of r in self-guided filter");
582
70.9k
}
583
584
23.9k
void av1_decode_xq(const int *xqd, int *xq, const sgr_params_type *params) {
585
23.9k
  if (params->r[0] == 0) {
586
5.25k
    xq[0] = 0;
587
5.25k
    xq[1] = (1 << SGRPROJ_PRJ_BITS) - xqd[1];
588
18.7k
  } else if (params->r[1] == 0) {
589
7.16k
    xq[0] = xqd[0];
590
7.16k
    xq[1] = 0;
591
11.5k
  } else {
592
11.5k
    xq[0] = xqd[0];
593
11.5k
    xq[1] = (1 << SGRPROJ_PRJ_BITS) - xq[0] - xqd[1];
594
11.5k
  }
595
23.9k
}
596
597
const int32_t av1_x_by_xplus1[256] = {
598
  // Special case: Map 0 -> 1 (corresponding to a value of 1/256)
599
  // instead of 0. See comments in selfguided_restoration_internal() for why
600
  1,   128, 171, 192, 205, 213, 219, 224, 228, 230, 233, 235, 236, 238, 239,
601
  240, 241, 242, 243, 243, 244, 244, 245, 245, 246, 246, 247, 247, 247, 247,
602
  248, 248, 248, 248, 249, 249, 249, 249, 249, 250, 250, 250, 250, 250, 250,
603
  250, 251, 251, 251, 251, 251, 251, 251, 251, 251, 251, 252, 252, 252, 252,
604
  252, 252, 252, 252, 252, 252, 252, 252, 252, 252, 252, 252, 252, 253, 253,
605
  253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 253,
606
  253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 253, 254, 254, 254,
607
  254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254,
608
  254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254,
609
  254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254,
610
  254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254, 254,
611
  254, 254, 254, 254, 254, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
612
  255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
613
  255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
614
  255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
615
  255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
616
  255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
617
  256,
618
};
619
620
const int32_t av1_one_by_x[MAX_NELEM] = {
621
  4096, 2048, 1365, 1024, 819, 683, 585, 512, 455, 410, 372, 341, 315,
622
  293,  273,  256,  241,  228, 216, 205, 195, 186, 178, 171, 164,
623
};
624
625
static void calculate_intermediate_result(int32_t *dgd, int width, int height,
626
                                          int dgd_stride, int bit_depth,
627
                                          int sgr_params_idx, int radius_idx,
628
35.4k
                                          int pass, int32_t *A, int32_t *B) {
629
35.4k
  const sgr_params_type *const params = &av1_sgr_params[sgr_params_idx];
630
35.4k
  const int r = params->r[radius_idx];
631
35.4k
  const int width_ext = width + 2 * SGRPROJ_BORDER_HORZ;
632
35.4k
  const int height_ext = height + 2 * SGRPROJ_BORDER_VERT;
633
  // Adjusting the stride of A and B here appears to avoid bad cache effects,
634
  // leading to a significant speed improvement.
635
  // We also align the stride to a multiple of 16 bytes, for consistency
636
  // with the SIMD version of this function.
637
35.4k
  int buf_stride = ((width_ext + 3) & ~3) + 16;
638
35.4k
  const int step = pass == 0 ? 1 : 2;
639
35.4k
  int i, j;
640
641
35.4k
  assert(r <= MAX_RADIUS && "Need MAX_RADIUS >= r");
642
35.4k
  assert(r <= SGRPROJ_BORDER_VERT - 1 && r <= SGRPROJ_BORDER_HORZ - 1 &&
643
35.4k
         "Need SGRPROJ_BORDER_* >= r+1");
644
645
35.4k
  boxsum(dgd - dgd_stride * SGRPROJ_BORDER_VERT - SGRPROJ_BORDER_HORZ,
646
35.4k
         width_ext, height_ext, dgd_stride, r, 0, B, buf_stride);
647
35.4k
  boxsum(dgd - dgd_stride * SGRPROJ_BORDER_VERT - SGRPROJ_BORDER_HORZ,
648
35.4k
         width_ext, height_ext, dgd_stride, r, 1, A, buf_stride);
649
35.4k
  A += SGRPROJ_BORDER_VERT * buf_stride + SGRPROJ_BORDER_HORZ;
650
35.4k
  B += SGRPROJ_BORDER_VERT * buf_stride + SGRPROJ_BORDER_HORZ;
651
  // Calculate the eventual A[] and B[] arrays. Include a 1-pixel border - ie,
652
  // for a 64x64 processing unit, we calculate 66x66 pixels of A[] and B[].
653
1.35M
  for (i = -1; i < height + 1; i += step) {
654
54.8M
    for (j = -1; j < width + 1; ++j) {
655
53.5M
      const int k = i * buf_stride + j;
656
53.5M
      const int n = (2 * r + 1) * (2 * r + 1);
657
658
      // a < 2^16 * n < 2^22 regardless of bit depth
659
53.5M
      uint32_t a = ROUND_POWER_OF_TWO(A[k], 2 * (bit_depth - 8));
660
      // b < 2^8 * n < 2^14 regardless of bit depth
661
53.5M
      uint32_t b = ROUND_POWER_OF_TWO(B[k], bit_depth - 8);
662
663
      // Each term in calculating p = a * n - b * b is < 2^16 * n^2 < 2^28,
664
      // and p itself satisfies p < 2^14 * n^2 < 2^26.
665
      // This bound on p is due to:
666
      // https://en.wikipedia.org/wiki/Popoviciu's_inequality_on_variances
667
      //
668
      // Note: Sometimes, in high bit depth, we can end up with a*n < b*b.
669
      // This is an artefact of rounding, and can only happen if all pixels
670
      // are (almost) identical, so in this case we saturate to p=0.
671
53.5M
      uint32_t p = (a * n < b * b) ? 0 : a * n - b * b;
672
673
53.5M
      const uint32_t s = params->s[radius_idx];
674
675
      // p * s < (2^14 * n^2) * round(2^20 / n^2 eps) < 2^34 / eps < 2^32
676
      // as long as eps >= 4. So p * s fits into a uint32_t, and z < 2^12
677
      // (this holds even after accounting for the rounding in s)
678
53.5M
      const uint32_t z = ROUND_POWER_OF_TWO(p * s, SGRPROJ_MTABLE_BITS);
679
680
      // Note: We have to be quite careful about the value of A[k].
681
      // This is used as a blend factor between individual pixel values and the
682
      // local mean. So it logically has a range of [0, 256], including both
683
      // endpoints.
684
      //
685
      // This is a pain for hardware, as we'd like something which can be stored
686
      // in exactly 8 bits.
687
      // Further, in the calculation of B[k] below, if z == 0 and r == 2,
688
      // then A[k] "should be" 0. But then we can end up setting B[k] to a value
689
      // slightly above 2^(8 + bit depth), due to rounding in the value of
690
      // av1_one_by_x[25-1].
691
      //
692
      // Thus we saturate so that, when z == 0, A[k] is set to 1 instead of 0.
693
      // This fixes the above issues (256 - A[k] fits in a uint8, and we can't
694
      // overflow), without significantly affecting the final result: z == 0
695
      // implies that the image is essentially "flat", so the local mean and
696
      // individual pixel values are very similar.
697
      //
698
      // Note that saturating on the other side, ie. requring A[k] <= 255,
699
      // would be a bad idea, as that corresponds to the case where the image
700
      // is very variable, when we want to preserve the local pixel value as
701
      // much as possible.
702
53.5M
      A[k] = av1_x_by_xplus1[AOMMIN(z, 255)];  // in range [1, 256]
703
704
      // SGRPROJ_SGR - A[k] < 2^8 (from above), B[k] < 2^(bit_depth) * n,
705
      // av1_one_by_x[n - 1] = round(2^12 / n)
706
      // => the product here is < 2^(20 + bit_depth) <= 2^32,
707
      // and B[k] is set to a value < 2^(8 + bit depth)
708
      // This holds even with the rounding in av1_one_by_x and in the overall
709
      // result, as long as SGRPROJ_SGR - A[k] is strictly less than 2^8.
710
53.5M
      B[k] = (int32_t)ROUND_POWER_OF_TWO((uint32_t)(SGRPROJ_SGR - A[k]) *
711
53.5M
                                             (uint32_t)B[k] *
712
53.5M
                                             (uint32_t)av1_one_by_x[n - 1],
713
53.5M
                                         SGRPROJ_RECIP_BITS);
714
53.5M
    }
715
1.32M
  }
716
35.4k
}
717
718
static void selfguided_restoration_fast_internal(
719
    int32_t *dgd, int width, int height, int dgd_stride, int32_t *dst,
720
18.7k
    int dst_stride, int bit_depth, int sgr_params_idx, int radius_idx) {
721
18.7k
  const sgr_params_type *const params = &av1_sgr_params[sgr_params_idx];
722
18.7k
  const int r = params->r[radius_idx];
723
18.7k
  const int width_ext = width + 2 * SGRPROJ_BORDER_HORZ;
724
  // Adjusting the stride of A and B here appears to avoid bad cache effects,
725
  // leading to a significant speed improvement.
726
  // We also align the stride to a multiple of 16 bytes, for consistency
727
  // with the SIMD version of this function.
728
18.7k
  int buf_stride = ((width_ext + 3) & ~3) + 16;
729
18.7k
  int32_t A_[RESTORATION_PROC_UNIT_PELS];
730
18.7k
  int32_t B_[RESTORATION_PROC_UNIT_PELS];
731
18.7k
  int32_t *A = A_;
732
18.7k
  int32_t *B = B_;
733
18.7k
  int i, j;
734
18.7k
  calculate_intermediate_result(dgd, width, height, dgd_stride, bit_depth,
735
18.7k
                                sgr_params_idx, radius_idx, 1, A, B);
736
18.7k
  A += SGRPROJ_BORDER_VERT * buf_stride + SGRPROJ_BORDER_HORZ;
737
18.7k
  B += SGRPROJ_BORDER_VERT * buf_stride + SGRPROJ_BORDER_HORZ;
738
739
  // Use the A[] and B[] arrays to calculate the filtered image
740
18.7k
  (void)r;
741
18.7k
  assert(r == 2);
742
951k
  for (i = 0; i < height; ++i) {
743
933k
    if (!(i & 1)) {  // even row
744
21.4M
      for (j = 0; j < width; ++j) {
745
20.9M
        const int k = i * buf_stride + j;
746
20.9M
        const int l = i * dgd_stride + j;
747
20.9M
        const int m = i * dst_stride + j;
748
20.9M
        const int nb = 5;
749
20.9M
        const int32_t a = (A[k - buf_stride] + A[k + buf_stride]) * 6 +
750
20.9M
                          (A[k - 1 - buf_stride] + A[k - 1 + buf_stride] +
751
20.9M
                           A[k + 1 - buf_stride] + A[k + 1 + buf_stride]) *
752
20.9M
                              5;
753
20.9M
        const int32_t b = (B[k - buf_stride] + B[k + buf_stride]) * 6 +
754
20.9M
                          (B[k - 1 - buf_stride] + B[k - 1 + buf_stride] +
755
20.9M
                           B[k + 1 - buf_stride] + B[k + 1 + buf_stride]) *
756
20.9M
                              5;
757
20.9M
        const int32_t v = a * dgd[l] + b;
758
20.9M
        dst[m] =
759
20.9M
            ROUND_POWER_OF_TWO(v, SGRPROJ_SGR_BITS + nb - SGRPROJ_RST_BITS);
760
20.9M
      }
761
473k
    } else {  // odd row
762
21.4M
      for (j = 0; j < width; ++j) {
763
20.9M
        const int k = i * buf_stride + j;
764
20.9M
        const int l = i * dgd_stride + j;
765
20.9M
        const int m = i * dst_stride + j;
766
20.9M
        const int nb = 4;
767
20.9M
        const int32_t a = A[k] * 6 + (A[k - 1] + A[k + 1]) * 5;
768
20.9M
        const int32_t b = B[k] * 6 + (B[k - 1] + B[k + 1]) * 5;
769
20.9M
        const int32_t v = a * dgd[l] + b;
770
20.9M
        dst[m] =
771
20.9M
            ROUND_POWER_OF_TWO(v, SGRPROJ_SGR_BITS + nb - SGRPROJ_RST_BITS);
772
20.9M
      }
773
459k
    }
774
933k
  }
775
18.7k
}
776
777
static void selfguided_restoration_internal(int32_t *dgd, int width, int height,
778
                                            int dgd_stride, int32_t *dst,
779
                                            int dst_stride, int bit_depth,
780
                                            int sgr_params_idx,
781
16.7k
                                            int radius_idx) {
782
16.7k
  const int width_ext = width + 2 * SGRPROJ_BORDER_HORZ;
783
  // Adjusting the stride of A and B here appears to avoid bad cache effects,
784
  // leading to a significant speed improvement.
785
  // We also align the stride to a multiple of 16 bytes, for consistency
786
  // with the SIMD version of this function.
787
16.7k
  int buf_stride = ((width_ext + 3) & ~3) + 16;
788
16.7k
  int32_t A_[RESTORATION_PROC_UNIT_PELS];
789
16.7k
  int32_t B_[RESTORATION_PROC_UNIT_PELS];
790
16.7k
  int32_t *A = A_;
791
16.7k
  int32_t *B = B_;
792
16.7k
  int i, j;
793
16.7k
  calculate_intermediate_result(dgd, width, height, dgd_stride, bit_depth,
794
16.7k
                                sgr_params_idx, radius_idx, 0, A, B);
795
16.7k
  A += SGRPROJ_BORDER_VERT * buf_stride + SGRPROJ_BORDER_HORZ;
796
16.7k
  B += SGRPROJ_BORDER_VERT * buf_stride + SGRPROJ_BORDER_HORZ;
797
798
  // Use the A[] and B[] arrays to calculate the filtered image
799
793k
  for (i = 0; i < height; ++i) {
800
29.3M
    for (j = 0; j < width; ++j) {
801
28.5M
      const int k = i * buf_stride + j;
802
28.5M
      const int l = i * dgd_stride + j;
803
28.5M
      const int m = i * dst_stride + j;
804
28.5M
      const int nb = 5;
805
28.5M
      const int32_t a =
806
28.5M
          (A[k] + A[k - 1] + A[k + 1] + A[k - buf_stride] + A[k + buf_stride]) *
807
28.5M
              4 +
808
28.5M
          (A[k - 1 - buf_stride] + A[k - 1 + buf_stride] +
809
28.5M
           A[k + 1 - buf_stride] + A[k + 1 + buf_stride]) *
810
28.5M
              3;
811
28.5M
      const int32_t b =
812
28.5M
          (B[k] + B[k - 1] + B[k + 1] + B[k - buf_stride] + B[k + buf_stride]) *
813
28.5M
              4 +
814
28.5M
          (B[k - 1 - buf_stride] + B[k - 1 + buf_stride] +
815
28.5M
           B[k + 1 - buf_stride] + B[k + 1 + buf_stride]) *
816
28.5M
              3;
817
28.5M
      const int32_t v = a * dgd[l] + b;
818
28.5M
      dst[m] = ROUND_POWER_OF_TWO(v, SGRPROJ_SGR_BITS + nb - SGRPROJ_RST_BITS);
819
28.5M
    }
820
776k
  }
821
16.7k
}
822
823
int av1_selfguided_restoration_c(const uint8_t *dgd8, int width, int height,
824
                                 int dgd_stride, int32_t *flt0, int32_t *flt1,
825
                                 int flt_stride, int sgr_params_idx,
826
23.9k
                                 int bit_depth, int highbd) {
827
23.9k
  int32_t dgd32_[RESTORATION_PROC_UNIT_PELS];
828
23.9k
  const int dgd32_stride = width + 2 * SGRPROJ_BORDER_HORZ;
829
23.9k
  int32_t *dgd32 =
830
23.9k
      dgd32_ + dgd32_stride * SGRPROJ_BORDER_VERT + SGRPROJ_BORDER_HORZ;
831
832
23.9k
  if (highbd) {
833
8.37k
    const uint16_t *dgd16 = CONVERT_TO_SHORTPTR(dgd8);
834
390k
    for (int i = -SGRPROJ_BORDER_VERT; i < height + SGRPROJ_BORDER_VERT; ++i) {
835
15.1M
      for (int j = -SGRPROJ_BORDER_HORZ; j < width + SGRPROJ_BORDER_HORZ; ++j) {
836
14.7M
        dgd32[i * dgd32_stride + j] = dgd16[i * dgd_stride + j];
837
14.7M
      }
838
382k
    }
839
15.5k
  } else {
840
889k
    for (int i = -SGRPROJ_BORDER_VERT; i < height + SGRPROJ_BORDER_VERT; ++i) {
841
47.8M
      for (int j = -SGRPROJ_BORDER_HORZ; j < width + SGRPROJ_BORDER_HORZ; ++j) {
842
47.0M
        dgd32[i * dgd32_stride + j] = dgd8[i * dgd_stride + j];
843
47.0M
      }
844
873k
    }
845
15.5k
  }
846
847
23.9k
  const sgr_params_type *const params = &av1_sgr_params[sgr_params_idx];
848
  // If params->r == 0 we skip the corresponding filter. We only allow one of
849
  // the radii to be 0, as having both equal to 0 would be equivalent to
850
  // skipping SGR entirely.
851
23.9k
  assert(!(params->r[0] == 0 && params->r[1] == 0));
852
853
23.9k
  if (params->r[0] > 0)
854
18.7k
    selfguided_restoration_fast_internal(dgd32, width, height, dgd32_stride,
855
18.7k
                                         flt0, flt_stride, bit_depth,
856
18.7k
                                         sgr_params_idx, 0);
857
23.9k
  if (params->r[1] > 0)
858
16.7k
    selfguided_restoration_internal(dgd32, width, height, dgd32_stride, flt1,
859
16.7k
                                    flt_stride, bit_depth, sgr_params_idx, 1);
860
23.9k
  return 0;
861
23.9k
}
862
863
int av1_apply_selfguided_restoration_c(const uint8_t *dat8, int width,
864
                                       int height, int stride, int eps,
865
                                       const int *xqd, uint8_t *dst8,
866
                                       int dst_stride, int32_t *tmpbuf,
867
23.9k
                                       int bit_depth, int highbd) {
868
23.9k
  int32_t *flt0 = tmpbuf;
869
23.9k
  int32_t *flt1 = flt0 + RESTORATION_UNITPELS_MAX;
870
23.9k
  assert(width * height <= RESTORATION_UNITPELS_MAX);
871
872
23.9k
  const int ret = av1_selfguided_restoration_c(
873
23.9k
      dat8, width, height, stride, flt0, flt1, width, eps, bit_depth, highbd);
874
23.9k
  if (ret != 0) return ret;
875
23.9k
  const sgr_params_type *const params = &av1_sgr_params[eps];
876
23.9k
  int xq[2];
877
23.9k
  av1_decode_xq(xqd, xq, params);
878
968k
  for (int i = 0; i < height; ++i) {
879
40.0M
    for (int j = 0; j < width; ++j) {
880
39.1M
      const int k = i * width + j;
881
39.1M
      uint8_t *dst8ij = dst8 + i * dst_stride + j;
882
39.1M
      const uint8_t *dat8ij = dat8 + i * stride + j;
883
884
39.1M
      const uint16_t pre_u = highbd ? *CONVERT_TO_SHORTPTR(dat8ij) : *dat8ij;
885
39.1M
      const int32_t u = (int32_t)pre_u << SGRPROJ_RST_BITS;
886
39.1M
      int32_t v = u << SGRPROJ_PRJ_BITS;
887
      // If params->r == 0 then we skipped the filtering in
888
      // av1_selfguided_restoration_c, i.e. flt[k] == u
889
39.1M
      if (params->r[0] > 0) v += xq[0] * (flt0[k] - u);
890
39.1M
      if (params->r[1] > 0) v += xq[1] * (flt1[k] - u);
891
39.1M
      const int16_t w =
892
39.1M
          (int16_t)ROUND_POWER_OF_TWO(v, SGRPROJ_PRJ_BITS + SGRPROJ_RST_BITS);
893
894
39.1M
      const uint16_t out = clip_pixel_highbd(w, bit_depth);
895
39.1M
      if (highbd)
896
8.80M
        *CONVERT_TO_SHORTPTR(dst8ij) = out;
897
30.3M
      else
898
30.3M
        *dst8ij = (uint8_t)out;
899
39.1M
    }
900
944k
  }
901
23.9k
  return 0;
902
23.9k
}
903
904
static void sgrproj_filter_stripe(const RestorationUnitInfo *rui,
905
                                  int stripe_width, int stripe_height,
906
                                  int procunit_width, const uint8_t *src,
907
                                  int src_stride, uint8_t *dst, int dst_stride,
908
                                  int32_t *tmpbuf, int bit_depth,
909
7.28k
                                  struct aom_internal_error_info *error_info) {
910
7.28k
  (void)bit_depth;
911
7.28k
  assert(bit_depth == 8);
912
913
22.8k
  for (int j = 0; j < stripe_width; j += procunit_width) {
914
15.5k
    int w = AOMMIN(procunit_width, stripe_width - j);
915
15.5k
    if (av1_apply_selfguided_restoration(
916
15.5k
            src + j, w, stripe_height, src_stride, rui->sgrproj_info.ep,
917
15.5k
            rui->sgrproj_info.xqd, dst + j, dst_stride, tmpbuf, bit_depth,
918
15.5k
            0) != 0) {
919
0
      aom_internal_error(
920
0
          error_info, AOM_CODEC_MEM_ERROR,
921
0
          "Error allocating buffer in av1_apply_selfguided_restoration");
922
0
    }
923
15.5k
  }
924
7.28k
}
925
926
#if CONFIG_AV1_HIGHBITDEPTH
927
static void wiener_filter_stripe_highbd(
928
    const RestorationUnitInfo *rui, int stripe_width, int stripe_height,
929
    int procunit_width, const uint8_t *src8, int src_stride, uint8_t *dst8,
930
    int dst_stride, int32_t *tmpbuf, int bit_depth,
931
12.7k
    struct aom_internal_error_info *error_info) {
932
12.7k
  (void)tmpbuf;
933
12.7k
  (void)error_info;
934
12.7k
  const WienerConvolveParams conv_params = get_conv_params_wiener(bit_depth);
935
936
27.2k
  for (int j = 0; j < stripe_width; j += procunit_width) {
937
14.4k
    int w = AOMMIN(procunit_width, (stripe_width - j + 15) & ~15);
938
14.4k
    const uint8_t *src8_p = src8 + j;
939
14.4k
    uint8_t *dst8_p = dst8 + j;
940
14.4k
    av1_highbd_wiener_convolve_add_src(src8_p, src_stride, dst8_p, dst_stride,
941
14.4k
                                       rui->wiener_info.hfilter, 16,
942
14.4k
                                       rui->wiener_info.vfilter, 16, w,
943
14.4k
                                       stripe_height, &conv_params, bit_depth);
944
14.4k
  }
945
12.7k
}
946
947
static void sgrproj_filter_stripe_highbd(
948
    const RestorationUnitInfo *rui, int stripe_width, int stripe_height,
949
    int procunit_width, const uint8_t *src8, int src_stride, uint8_t *dst8,
950
    int dst_stride, int32_t *tmpbuf, int bit_depth,
951
5.35k
    struct aom_internal_error_info *error_info) {
952
13.7k
  for (int j = 0; j < stripe_width; j += procunit_width) {
953
8.37k
    int w = AOMMIN(procunit_width, stripe_width - j);
954
8.37k
    if (av1_apply_selfguided_restoration(
955
8.37k
            src8 + j, w, stripe_height, src_stride, rui->sgrproj_info.ep,
956
8.37k
            rui->sgrproj_info.xqd, dst8 + j, dst_stride, tmpbuf, bit_depth,
957
8.37k
            1) != 0) {
958
0
      aom_internal_error(
959
0
          error_info, AOM_CODEC_MEM_ERROR,
960
0
          "Error allocating buffer in av1_apply_selfguided_restoration");
961
0
    }
962
8.37k
  }
963
5.35k
}
964
#endif  // CONFIG_AV1_HIGHBITDEPTH
965
966
typedef void (*stripe_filter_fun)(const RestorationUnitInfo *rui,
967
                                  int stripe_width, int stripe_height,
968
                                  int procunit_width, const uint8_t *src,
969
                                  int src_stride, uint8_t *dst, int dst_stride,
970
                                  int32_t *tmpbuf, int bit_depth,
971
                                  struct aom_internal_error_info *error_info);
972
973
#if CONFIG_AV1_HIGHBITDEPTH
974
#define NUM_STRIPE_FILTERS 4
975
static const stripe_filter_fun stripe_filters[NUM_STRIPE_FILTERS] = {
976
  wiener_filter_stripe, sgrproj_filter_stripe, wiener_filter_stripe_highbd,
977
  sgrproj_filter_stripe_highbd
978
};
979
#else
980
#define NUM_STRIPE_FILTERS 2
981
static const stripe_filter_fun stripe_filters[NUM_STRIPE_FILTERS] = {
982
  wiener_filter_stripe, sgrproj_filter_stripe
983
};
984
#endif  // CONFIG_AV1_HIGHBITDEPTH
985
986
// Filter one restoration unit
987
void av1_loop_restoration_filter_unit(
988
    const RestorationTileLimits *limits, const RestorationUnitInfo *rui,
989
    const RestorationStripeBoundaries *rsb, RestorationLineBuffers *rlbs,
990
    int plane_w, int plane_h, int ss_x, int ss_y, int highbd, int bit_depth,
991
    uint8_t *data8, int stride, uint8_t *dst8, int dst_stride, int32_t *tmpbuf,
992
28.4k
    int optimized_lr, struct aom_internal_error_info *error_info) {
993
28.4k
  RestorationType unit_rtype = rui->restoration_type;
994
995
28.4k
  int unit_h = limits->v_end - limits->v_start;
996
28.4k
  int unit_w = limits->h_end - limits->h_start;
997
28.4k
  uint8_t *data8_tl =
998
28.4k
      data8 + limits->v_start * (ptrdiff_t)stride + limits->h_start;
999
28.4k
  uint8_t *dst8_tl =
1000
28.4k
      dst8 + limits->v_start * (ptrdiff_t)dst_stride + limits->h_start;
1001
1002
28.4k
  if (unit_rtype == RESTORE_NONE) {
1003
12.3k
    copy_rest_unit(unit_w, unit_h, data8_tl, stride, dst8_tl, dst_stride,
1004
12.3k
                   highbd);
1005
12.3k
    return;
1006
12.3k
  }
1007
1008
16.1k
  const int filter_idx = 2 * highbd + (unit_rtype == RESTORE_SGRPROJ);
1009
16.1k
  assert(filter_idx < NUM_STRIPE_FILTERS);
1010
16.1k
  const stripe_filter_fun stripe_filter = stripe_filters[filter_idx];
1011
1012
16.1k
  const int procunit_width = RESTORATION_PROC_UNIT_SIZE >> ss_x;
1013
1014
  // Filter the whole image one stripe at a time
1015
16.1k
  RestorationTileLimits remaining_stripes = *limits;
1016
16.1k
  int i = 0;
1017
48.8k
  while (i < unit_h) {
1018
32.7k
    int copy_above, copy_below;
1019
32.7k
    remaining_stripes.v_start = limits->v_start + i;
1020
1021
32.7k
    get_stripe_boundary_info(&remaining_stripes, plane_w, plane_h, ss_y,
1022
32.7k
                             &copy_above, &copy_below);
1023
1024
32.7k
    const int full_stripe_height = RESTORATION_PROC_UNIT_SIZE >> ss_y;
1025
32.7k
    const int runit_offset = RESTORATION_UNIT_OFFSET >> ss_y;
1026
1027
    // Work out where this stripe's boundaries are within
1028
    // rsb->stripe_boundary_{above,below}
1029
32.7k
    const int frame_stripe =
1030
32.7k
        (remaining_stripes.v_start + runit_offset) / full_stripe_height;
1031
32.7k
    const int rsb_row = RESTORATION_CTX_VERT * frame_stripe;
1032
1033
    // Calculate this stripe's height, based on two rules:
1034
    // * The topmost stripe in the frame is 8 luma pixels shorter than usual.
1035
    // * We can't extend past the end of the current restoration unit
1036
32.7k
    const int nominal_stripe_height =
1037
32.7k
        full_stripe_height - ((frame_stripe == 0) ? runit_offset : 0);
1038
32.7k
    const int h = AOMMIN(nominal_stripe_height,
1039
32.7k
                         remaining_stripes.v_end - remaining_stripes.v_start);
1040
1041
32.7k
    setup_processing_stripe_boundary(&remaining_stripes, rsb, rsb_row, highbd,
1042
32.7k
                                     h, data8, stride, rlbs, copy_above,
1043
32.7k
                                     copy_below, optimized_lr);
1044
1045
32.7k
    stripe_filter(rui, unit_w, h, procunit_width, data8_tl + i * stride, stride,
1046
32.7k
                  dst8_tl + i * dst_stride, dst_stride, tmpbuf, bit_depth,
1047
32.7k
                  error_info);
1048
1049
32.7k
    restore_processing_stripe_boundary(&remaining_stripes, rlbs, highbd, h,
1050
32.7k
                                       data8, stride, copy_above, copy_below,
1051
32.7k
                                       optimized_lr);
1052
1053
32.7k
    i += h;
1054
32.7k
  }
1055
16.1k
}
1056
1057
static void filter_frame_on_unit(const RestorationTileLimits *limits,
1058
                                 int rest_unit_idx, void *priv, int32_t *tmpbuf,
1059
                                 RestorationLineBuffers *rlbs,
1060
28.5k
                                 struct aom_internal_error_info *error_info) {
1061
28.5k
  FilterFrameCtxt *ctxt = (FilterFrameCtxt *)priv;
1062
28.5k
  const RestorationInfo *rsi = ctxt->rsi;
1063
1064
28.5k
  av1_loop_restoration_filter_unit(
1065
28.5k
      limits, &rsi->unit_info[rest_unit_idx], &rsi->boundaries, rlbs,
1066
28.5k
      ctxt->plane_w, ctxt->plane_h, ctxt->ss_x, ctxt->ss_y, ctxt->highbd,
1067
28.5k
      ctxt->bit_depth, ctxt->data8, ctxt->data_stride, ctxt->dst8,
1068
28.5k
      ctxt->dst_stride, tmpbuf, rsi->optimized_lr, error_info);
1069
28.5k
}
1070
1071
void av1_loop_restoration_filter_frame_init(AV1LrStruct *lr_ctxt,
1072
                                            YV12_BUFFER_CONFIG *frame,
1073
                                            AV1_COMMON *cm, int optimized_lr,
1074
4.08k
                                            int num_planes) {
1075
4.08k
  const SequenceHeader *const seq_params = cm->seq_params;
1076
4.08k
  const int bit_depth = seq_params->bit_depth;
1077
4.08k
  const int highbd = seq_params->use_highbitdepth;
1078
4.08k
  lr_ctxt->dst = &cm->rst_frame;
1079
1080
4.08k
  const int frame_width = frame->crop_widths[0];
1081
4.08k
  const int frame_height = frame->crop_heights[0];
1082
4.08k
  if (aom_realloc_frame_buffer(
1083
4.08k
          lr_ctxt->dst, frame_width, frame_height, seq_params->subsampling_x,
1084
4.08k
          seq_params->subsampling_y, highbd, AOM_RESTORATION_FRAME_BORDER,
1085
4.08k
          cm->features.byte_alignment, NULL, NULL, NULL, false,
1086
4.08k
          0) != AOM_CODEC_OK)
1087
0
    aom_internal_error(cm->error, AOM_CODEC_MEM_ERROR,
1088
0
                       "Failed to allocate restoration dst buffer");
1089
1090
4.08k
  lr_ctxt->on_rest_unit = filter_frame_on_unit;
1091
4.08k
  lr_ctxt->frame = frame;
1092
15.9k
  for (int plane = 0; plane < num_planes; ++plane) {
1093
11.8k
    RestorationInfo *rsi = &cm->rst_info[plane];
1094
11.8k
    RestorationType rtype = rsi->frame_restoration_type;
1095
11.8k
    rsi->optimized_lr = optimized_lr;
1096
11.8k
    lr_ctxt->ctxt[plane].rsi = rsi;
1097
1098
11.8k
    if (rtype == RESTORE_NONE) {
1099
4.39k
      continue;
1100
4.39k
    }
1101
1102
7.44k
    const int is_uv = plane > 0;
1103
7.44k
    int plane_w, plane_h;
1104
7.44k
    av1_get_upsampled_plane_size(cm, is_uv, &plane_w, &plane_h);
1105
7.44k
    assert(plane_w == frame->crop_widths[is_uv]);
1106
7.44k
    assert(plane_h == frame->crop_heights[is_uv]);
1107
1108
7.44k
    av1_extend_frame(frame->buffers[plane], plane_w, plane_h,
1109
7.44k
                     frame->strides[is_uv], RESTORATION_BORDER,
1110
7.44k
                     RESTORATION_BORDER, highbd);
1111
1112
7.44k
    FilterFrameCtxt *lr_plane_ctxt = &lr_ctxt->ctxt[plane];
1113
7.44k
    lr_plane_ctxt->ss_x = is_uv && seq_params->subsampling_x;
1114
7.44k
    lr_plane_ctxt->ss_y = is_uv && seq_params->subsampling_y;
1115
7.44k
    lr_plane_ctxt->plane_w = plane_w;
1116
7.44k
    lr_plane_ctxt->plane_h = plane_h;
1117
7.44k
    lr_plane_ctxt->highbd = highbd;
1118
7.44k
    lr_plane_ctxt->bit_depth = bit_depth;
1119
7.44k
    lr_plane_ctxt->data8 = frame->buffers[plane];
1120
7.44k
    lr_plane_ctxt->dst8 = lr_ctxt->dst->buffers[plane];
1121
7.44k
    lr_plane_ctxt->data_stride = frame->strides[is_uv];
1122
7.44k
    lr_plane_ctxt->dst_stride = lr_ctxt->dst->strides[is_uv];
1123
7.44k
  }
1124
4.08k
}
1125
1126
static void loop_restoration_copy_planes(AV1LrStruct *loop_rest_ctxt,
1127
219
                                         AV1_COMMON *cm, int num_planes) {
1128
219
  typedef void (*copy_fun)(const YV12_BUFFER_CONFIG *src_ybc,
1129
219
                           YV12_BUFFER_CONFIG *dst_ybc, int hstart, int hend,
1130
219
                           int vstart, int vend);
1131
219
  static const copy_fun copy_funs[3] = { aom_yv12_partial_coloc_copy_y,
1132
219
                                         aom_yv12_partial_coloc_copy_u,
1133
219
                                         aom_yv12_partial_coloc_copy_v };
1134
219
  assert(num_planes <= 3);
1135
854
  for (int plane = 0; plane < num_planes; ++plane) {
1136
635
    if (cm->rst_info[plane].frame_restoration_type == RESTORE_NONE) continue;
1137
372
    FilterFrameCtxt *lr_plane_ctxt = &loop_rest_ctxt->ctxt[plane];
1138
372
    copy_funs[plane](loop_rest_ctxt->dst, loop_rest_ctxt->frame, 0,
1139
372
                     lr_plane_ctxt->plane_w, 0, lr_plane_ctxt->plane_h);
1140
372
  }
1141
219
}
1142
1143
// Call on_rest_unit for each loop restoration unit in the plane.
1144
static void foreach_rest_unit_in_plane(const struct AV1Common *cm, int plane,
1145
                                       rest_unit_visitor_t on_rest_unit,
1146
                                       void *priv, int32_t *tmpbuf,
1147
372
                                       RestorationLineBuffers *rlbs) {
1148
372
  const RestorationInfo *rsi = &cm->rst_info[plane];
1149
372
  const int hnum_rest_units = rsi->horz_units;
1150
372
  const int vnum_rest_units = rsi->vert_units;
1151
372
  const int unit_size = rsi->restoration_unit_size;
1152
1153
372
  const int is_uv = plane > 0;
1154
372
  const int ss_y = is_uv && cm->seq_params->subsampling_y;
1155
372
  const int ext_size = unit_size * 3 / 2;
1156
372
  int plane_w, plane_h;
1157
372
  av1_get_upsampled_plane_size(cm, is_uv, &plane_w, &plane_h);
1158
1159
372
  int y0 = 0, i = 0;
1160
767
  while (y0 < plane_h) {
1161
395
    int remaining_h = plane_h - y0;
1162
395
    int h = (remaining_h < ext_size) ? remaining_h : unit_size;
1163
1164
395
    RestorationTileLimits limits;
1165
395
    limits.v_start = y0;
1166
395
    limits.v_end = y0 + h;
1167
395
    assert(limits.v_end <= plane_h);
1168
    // Offset upwards to align with the restoration processing stripe
1169
395
    const int voffset = RESTORATION_UNIT_OFFSET >> ss_y;
1170
395
    limits.v_start = AOMMAX(0, limits.v_start - voffset);
1171
395
    if (limits.v_end < plane_h) limits.v_end -= voffset;
1172
1173
395
    av1_foreach_rest_unit_in_row(&limits, plane_w, on_rest_unit, i, unit_size,
1174
395
                                 hnum_rest_units, vnum_rest_units, plane, priv,
1175
395
                                 tmpbuf, rlbs, av1_lr_sync_read_dummy,
1176
395
                                 av1_lr_sync_write_dummy, NULL, cm->error);
1177
1178
395
    y0 += h;
1179
395
    ++i;
1180
395
  }
1181
372
}
1182
1183
static void foreach_rest_unit_in_planes(AV1LrStruct *lr_ctxt, AV1_COMMON *cm,
1184
219
                                        int num_planes) {
1185
219
  FilterFrameCtxt *ctxt = lr_ctxt->ctxt;
1186
1187
854
  for (int plane = 0; plane < num_planes; ++plane) {
1188
635
    if (cm->rst_info[plane].frame_restoration_type == RESTORE_NONE) {
1189
263
      continue;
1190
263
    }
1191
1192
372
    foreach_rest_unit_in_plane(cm, plane, lr_ctxt->on_rest_unit, &ctxt[plane],
1193
372
                               cm->rst_tmpbuf, cm->rlbs);
1194
372
  }
1195
219
}
1196
1197
void av1_loop_restoration_filter_frame(YV12_BUFFER_CONFIG *frame,
1198
                                       AV1_COMMON *cm, int optimized_lr,
1199
219
                                       void *lr_ctxt) {
1200
219
  assert(!cm->features.all_lossless);
1201
219
  const int num_planes = av1_num_planes(cm);
1202
1203
219
  AV1LrStruct *loop_rest_ctxt = (AV1LrStruct *)lr_ctxt;
1204
1205
219
  av1_loop_restoration_filter_frame_init(loop_rest_ctxt, frame, cm,
1206
219
                                         optimized_lr, num_planes);
1207
1208
219
  foreach_rest_unit_in_planes(loop_rest_ctxt, cm, num_planes);
1209
1210
219
  loop_restoration_copy_planes(loop_rest_ctxt, cm, num_planes);
1211
219
}
1212
1213
void av1_foreach_rest_unit_in_row(
1214
    RestorationTileLimits *limits, int plane_w,
1215
    rest_unit_visitor_t on_rest_unit, int row_number, int unit_size,
1216
    int hnum_rest_units, int vnum_rest_units, int plane, void *priv,
1217
    int32_t *tmpbuf, RestorationLineBuffers *rlbs, sync_read_fn_t on_sync_read,
1218
    sync_write_fn_t on_sync_write, struct AV1LrSyncData *const lr_sync,
1219
24.1k
    struct aom_internal_error_info *error_info) {
1220
24.1k
  const int ext_size = unit_size * 3 / 2;
1221
24.1k
  int x0 = 0, j = 0;
1222
52.7k
  while (x0 < plane_w) {
1223
28.5k
    int remaining_w = plane_w - x0;
1224
28.5k
    int w = (remaining_w < ext_size) ? remaining_w : unit_size;
1225
1226
28.5k
    limits->h_start = x0;
1227
28.5k
    limits->h_end = x0 + w;
1228
28.5k
    assert(limits->h_end <= plane_w);
1229
1230
28.5k
    const int unit_idx = row_number * hnum_rest_units + j;
1231
1232
    // No sync for even numbered rows
1233
    // For odd numbered rows, Loop Restoration of current block requires the LR
1234
    // of top-right and bottom-right blocks to be completed
1235
1236
    // top-right sync
1237
28.5k
    on_sync_read(lr_sync, row_number, j, plane);
1238
28.5k
    if ((row_number + 1) < vnum_rest_units)
1239
      // bottom-right sync
1240
17.7k
      on_sync_read(lr_sync, row_number + 2, j, plane);
1241
1242
28.5k
#if CONFIG_MULTITHREAD
1243
28.5k
    if (lr_sync && lr_sync->num_workers > 1) {
1244
25.8k
      pthread_mutex_lock(lr_sync->job_mutex);
1245
25.8k
      const bool lr_mt_exit = lr_sync->lr_mt_exit;
1246
25.8k
      pthread_mutex_unlock(lr_sync->job_mutex);
1247
      // Exit in case any worker has encountered an error.
1248
25.8k
      if (lr_mt_exit) return;
1249
25.8k
    }
1250
28.5k
#endif
1251
1252
28.5k
    on_rest_unit(limits, unit_idx, priv, tmpbuf, rlbs, error_info);
1253
1254
28.5k
    on_sync_write(lr_sync, row_number, j, hnum_rest_units, plane);
1255
1256
28.5k
    x0 += w;
1257
28.5k
    ++j;
1258
28.5k
  }
1259
24.1k
}
1260
1261
28.7k
void av1_lr_sync_read_dummy(void *const lr_sync, int r, int c, int plane) {
1262
28.7k
  (void)lr_sync;
1263
28.7k
  (void)r;
1264
28.7k
  (void)c;
1265
28.7k
  (void)plane;
1266
28.7k
}
1267
1268
void av1_lr_sync_write_dummy(void *const lr_sync, int r, int c,
1269
12.8k
                             const int sb_cols, int plane) {
1270
12.8k
  (void)lr_sync;
1271
12.8k
  (void)r;
1272
12.8k
  (void)c;
1273
12.8k
  (void)sb_cols;
1274
12.8k
  (void)plane;
1275
12.8k
}
1276
1277
int av1_loop_restoration_corners_in_sb(const struct AV1Common *cm, int plane,
1278
                                       int mi_row, int mi_col, BLOCK_SIZE bsize,
1279
                                       int *rcol0, int *rcol1, int *rrow0,
1280
987k
                                       int *rrow1) {
1281
987k
  assert(rcol0 && rcol1 && rrow0 && rrow1);
1282
1283
987k
  if (bsize != cm->seq_params->sb_size) return 0;
1284
1285
987k
  assert(!cm->features.all_lossless);
1286
1287
124k
  const int is_uv = plane > 0;
1288
1289
  // Compute the mi-unit corners of the superblock
1290
124k
  const int mi_row0 = mi_row;
1291
124k
  const int mi_col0 = mi_col;
1292
124k
  const int mi_row1 = mi_row0 + mi_size_high[bsize];
1293
124k
  const int mi_col1 = mi_col0 + mi_size_wide[bsize];
1294
1295
124k
  const RestorationInfo *rsi = &cm->rst_info[plane];
1296
124k
  const int size = rsi->restoration_unit_size;
1297
124k
  const int horz_units = rsi->horz_units;
1298
124k
  const int vert_units = rsi->vert_units;
1299
1300
  // The size of an MI-unit on this plane of the image
1301
124k
  const int ss_x = is_uv && cm->seq_params->subsampling_x;
1302
124k
  const int ss_y = is_uv && cm->seq_params->subsampling_y;
1303
124k
  const int mi_size_x = MI_SIZE >> ss_x;
1304
124k
  const int mi_size_y = MI_SIZE >> ss_y;
1305
1306
  // Write m for the relative mi column or row, D for the superres denominator
1307
  // and N for the superres numerator. If u is the upscaled pixel offset then
1308
  // we can write the downscaled pixel offset in two ways as:
1309
  //
1310
  //   MI_SIZE * m = N / D u
1311
  //
1312
  // from which we get u = D * MI_SIZE * m / N
1313
124k
  const int mi_to_num_x = av1_superres_scaled(cm)
1314
124k
                              ? mi_size_x * cm->superres_scale_denominator
1315
124k
                              : mi_size_x;
1316
124k
  const int mi_to_num_y = mi_size_y;
1317
124k
  const int denom_x = av1_superres_scaled(cm) ? size * SCALE_NUMERATOR : size;
1318
124k
  const int denom_y = size;
1319
1320
124k
  const int rnd_x = denom_x - 1;
1321
124k
  const int rnd_y = denom_y - 1;
1322
1323
  // rcol0/rrow0 should be the first column/row of restoration units that
1324
  // doesn't start left/below of mi_col/mi_row. For this calculation, we need
1325
  // to round up the division (if the sb starts at runit column 10.1, the first
1326
  // matching runit has column index 11)
1327
124k
  *rcol0 = (mi_col0 * mi_to_num_x + rnd_x) / denom_x;
1328
124k
  *rrow0 = (mi_row0 * mi_to_num_y + rnd_y) / denom_y;
1329
1330
  // rel_col1/rel_row1 is the equivalent calculation, but for the superblock
1331
  // below-right. If we're at the bottom or right of the frame, this restoration
1332
  // unit might not exist, in which case we'll clamp accordingly.
1333
124k
  *rcol1 = AOMMIN((mi_col1 * mi_to_num_x + rnd_x) / denom_x, horz_units);
1334
124k
  *rrow1 = AOMMIN((mi_row1 * mi_to_num_y + rnd_y) / denom_y, vert_units);
1335
1336
124k
  return *rcol0 < *rcol1 && *rrow0 < *rrow1;
1337
987k
}
1338
1339
// Extend to left and right
1340
static void extend_lines(uint8_t *buf, int width, int height, int stride,
1341
118k
                         int extend, int use_highbitdepth) {
1342
356k
  for (int i = 0; i < height; ++i) {
1343
237k
    if (use_highbitdepth) {
1344
171k
      uint16_t *buf16 = (uint16_t *)buf;
1345
171k
      aom_memset16(buf16 - extend, buf16[0], extend);
1346
171k
      aom_memset16(buf16 + width, buf16[width - 1], extend);
1347
171k
    } else {
1348
66.5k
      memset(buf - extend, buf[0], extend);
1349
66.5k
      memset(buf + width, buf[width - 1], extend);
1350
66.5k
    }
1351
237k
    buf += stride;
1352
237k
  }
1353
118k
}
1354
1355
static void save_deblock_boundary_lines(
1356
    const YV12_BUFFER_CONFIG *frame, const AV1_COMMON *cm, int plane, int row,
1357
    int stripe, int use_highbd, int is_above,
1358
97.0k
    RestorationStripeBoundaries *boundaries) {
1359
97.0k
  const int is_uv = plane > 0;
1360
97.0k
  const uint8_t *src_buf = REAL_PTR(use_highbd, frame->buffers[plane]);
1361
97.0k
  const int src_stride = frame->strides[is_uv] << use_highbd;
1362
97.0k
  const uint8_t *src_rows = src_buf + row * (ptrdiff_t)src_stride;
1363
1364
97.0k
  uint8_t *bdry_buf = is_above ? boundaries->stripe_boundary_above
1365
97.0k
                               : boundaries->stripe_boundary_below;
1366
97.0k
  uint8_t *bdry_start = bdry_buf + (RESTORATION_EXTRA_HORZ << use_highbd);
1367
97.0k
  const int bdry_stride = boundaries->stripe_boundary_stride << use_highbd;
1368
97.0k
  uint8_t *bdry_rows = bdry_start + RESTORATION_CTX_VERT * stripe * bdry_stride;
1369
1370
  // There is a rare case in which a processing stripe can end 1px above the
1371
  // crop border. In this case, we do want to use deblocked pixels from below
1372
  // the stripe (hence why we ended up in this function), but instead of
1373
  // fetching 2 "below" rows we need to fetch one and duplicate it.
1374
  // This is equivalent to clamping the sample locations against the crop border
1375
97.0k
  const int lines_to_save =
1376
97.0k
      AOMMIN(RESTORATION_CTX_VERT, frame->crop_heights[is_uv] - row);
1377
97.0k
  assert(lines_to_save == 1 || lines_to_save == 2);
1378
1379
97.0k
  int upscaled_width;
1380
97.0k
  int line_bytes;
1381
97.0k
  if (av1_superres_scaled(cm)) {
1382
83.0k
    const int ss_x = is_uv && cm->seq_params->subsampling_x;
1383
83.0k
    upscaled_width = (cm->superres_upscaled_width + ss_x) >> ss_x;
1384
83.0k
    line_bytes = upscaled_width << use_highbd;
1385
83.0k
    if (use_highbd)
1386
61.1k
      av1_upscale_normative_rows(
1387
61.1k
          cm, CONVERT_TO_BYTEPTR(src_rows), frame->strides[is_uv],
1388
61.1k
          CONVERT_TO_BYTEPTR(bdry_rows), boundaries->stripe_boundary_stride,
1389
61.1k
          plane, lines_to_save);
1390
21.8k
    else
1391
21.8k
      av1_upscale_normative_rows(cm, src_rows, frame->strides[is_uv], bdry_rows,
1392
21.8k
                                 boundaries->stripe_boundary_stride, plane,
1393
21.8k
                                 lines_to_save);
1394
83.0k
  } else {
1395
13.9k
    upscaled_width = frame->crop_widths[is_uv];
1396
13.9k
    line_bytes = upscaled_width << use_highbd;
1397
41.8k
    for (int i = 0; i < lines_to_save; i++) {
1398
27.8k
      memcpy(bdry_rows + i * bdry_stride, src_rows + i * src_stride,
1399
27.8k
             line_bytes);
1400
27.8k
    }
1401
13.9k
  }
1402
  // If we only saved one line, then copy it into the second line buffer
1403
97.0k
  if (lines_to_save == 1)
1404
142
    memcpy(bdry_rows + bdry_stride, bdry_rows, line_bytes);
1405
1406
97.0k
  extend_lines(bdry_rows, upscaled_width, RESTORATION_CTX_VERT, bdry_stride,
1407
97.0k
               RESTORATION_EXTRA_HORZ, use_highbd);
1408
97.0k
}
1409
1410
static void save_cdef_boundary_lines(const YV12_BUFFER_CONFIG *frame,
1411
                                     const AV1_COMMON *cm, int plane, int row,
1412
                                     int stripe, int use_highbd, int is_above,
1413
21.8k
                                     RestorationStripeBoundaries *boundaries) {
1414
21.8k
  const int is_uv = plane > 0;
1415
21.8k
  const uint8_t *src_buf = REAL_PTR(use_highbd, frame->buffers[plane]);
1416
21.8k
  const int src_stride = frame->strides[is_uv] << use_highbd;
1417
21.8k
  const uint8_t *src_rows = src_buf + row * (ptrdiff_t)src_stride;
1418
1419
21.8k
  uint8_t *bdry_buf = is_above ? boundaries->stripe_boundary_above
1420
21.8k
                               : boundaries->stripe_boundary_below;
1421
21.8k
  uint8_t *bdry_start = bdry_buf + (RESTORATION_EXTRA_HORZ << use_highbd);
1422
21.8k
  const int bdry_stride = boundaries->stripe_boundary_stride << use_highbd;
1423
21.8k
  uint8_t *bdry_rows = bdry_start + RESTORATION_CTX_VERT * stripe * bdry_stride;
1424
21.8k
  const int src_width = frame->crop_widths[is_uv];
1425
1426
  // At the point where this function is called, we've already applied
1427
  // superres. So we don't need to extend the lines here, we can just
1428
  // pull directly from the topmost row of the upscaled frame.
1429
21.8k
  const int ss_x = is_uv && cm->seq_params->subsampling_x;
1430
21.8k
  const int upscaled_width = av1_superres_scaled(cm)
1431
21.8k
                                 ? (cm->superres_upscaled_width + ss_x) >> ss_x
1432
21.8k
                                 : src_width;
1433
21.8k
  const int line_bytes = upscaled_width << use_highbd;
1434
65.5k
  for (int i = 0; i < RESTORATION_CTX_VERT; i++) {
1435
    // Copy the line at 'src_rows' into both context lines
1436
43.6k
    memcpy(bdry_rows + i * bdry_stride, src_rows, line_bytes);
1437
43.6k
  }
1438
21.8k
  extend_lines(bdry_rows, upscaled_width, RESTORATION_CTX_VERT, bdry_stride,
1439
21.8k
               RESTORATION_EXTRA_HORZ, use_highbd);
1440
21.8k
}
1441
1442
static void save_boundary_lines(const YV12_BUFFER_CONFIG *frame, int use_highbd,
1443
21.8k
                                int plane, AV1_COMMON *cm, int after_cdef) {
1444
21.8k
  const int is_uv = plane > 0;
1445
21.8k
  const int ss_y = is_uv && cm->seq_params->subsampling_y;
1446
21.8k
  const int stripe_height = RESTORATION_PROC_UNIT_SIZE >> ss_y;
1447
21.8k
  const int stripe_off = RESTORATION_UNIT_OFFSET >> ss_y;
1448
1449
21.8k
  int plane_w, plane_h;
1450
21.8k
  av1_get_upsampled_plane_size(cm, is_uv, &plane_w, &plane_h);
1451
1452
21.8k
  RestorationStripeBoundaries *boundaries = &cm->rst_info[plane].boundaries;
1453
1454
21.8k
  const int plane_height = ROUND_POWER_OF_TWO(cm->height, ss_y);
1455
1456
21.8k
  int stripe_idx;
1457
140k
  for (stripe_idx = 0;; ++stripe_idx) {
1458
140k
    const int rel_y0 = AOMMAX(0, stripe_idx * stripe_height - stripe_off);
1459
140k
    const int y0 = rel_y0;
1460
140k
    if (y0 >= plane_h) break;
1461
1462
118k
    const int rel_y1 = (stripe_idx + 1) * stripe_height - stripe_off;
1463
118k
    const int y1 = AOMMIN(rel_y1, plane_h);
1464
1465
    // Extend using CDEF pixels at the top and bottom of the frame,
1466
    // and deblocked pixels at internal stripe boundaries
1467
118k
    const int use_deblock_above = (stripe_idx > 0);
1468
118k
    const int use_deblock_below = (y1 < plane_height);
1469
1470
118k
    if (!after_cdef) {
1471
      // Save deblocked context at internal stripe boundaries
1472
59.4k
      if (use_deblock_above) {
1473
48.5k
        save_deblock_boundary_lines(frame, cm, plane, y0 - RESTORATION_CTX_VERT,
1474
48.5k
                                    stripe_idx, use_highbd, 1, boundaries);
1475
48.5k
      }
1476
59.4k
      if (use_deblock_below) {
1477
48.5k
        save_deblock_boundary_lines(frame, cm, plane, y1, stripe_idx,
1478
48.5k
                                    use_highbd, 0, boundaries);
1479
48.5k
      }
1480
59.4k
    } else {
1481
      // Save CDEF context at frame boundaries
1482
59.4k
      if (!use_deblock_above) {
1483
10.9k
        save_cdef_boundary_lines(frame, cm, plane, y0, stripe_idx, use_highbd,
1484
10.9k
                                 1, boundaries);
1485
10.9k
      }
1486
59.4k
      if (!use_deblock_below) {
1487
10.9k
        save_cdef_boundary_lines(frame, cm, plane, y1 - 1, stripe_idx,
1488
10.9k
                                 use_highbd, 0, boundaries);
1489
10.9k
      }
1490
59.4k
    }
1491
118k
  }
1492
21.8k
}
1493
1494
// For each RESTORATION_PROC_UNIT_SIZE pixel high stripe, save 4 scan
1495
// lines to be used as boundary in the loop restoration process. The
1496
// lines are saved in rst_internal.stripe_boundary_lines
1497
void av1_loop_restoration_save_boundary_lines(const YV12_BUFFER_CONFIG *frame,
1498
7.37k
                                              AV1_COMMON *cm, int after_cdef) {
1499
7.37k
  const int num_planes = av1_num_planes(cm);
1500
7.37k
  const int use_highbd = cm->seq_params->use_highbitdepth;
1501
29.2k
  for (int p = 0; p < num_planes; ++p) {
1502
21.8k
    save_boundary_lines(frame, use_highbd, p, cm, after_cdef);
1503
21.8k
  }
1504
7.37k
}