Coverage Report

Created: 2025-10-10 07:09

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libavif/ext/aom/av1/encoder/svc_layercontext.c
Line
Count
Source
1
/*
2
 * Copyright (c) 2019, 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 <assert.h>
13
#include <math.h>
14
15
#include "av1/encoder/encoder.h"
16
#include "av1/encoder/encoder_alloc.h"
17
18
0
static void swap_ptr(void *a, void *b) {
19
0
  void **a_p = (void **)a;
20
0
  void **b_p = (void **)b;
21
0
  void *c = *a_p;
22
0
  *a_p = *b_p;
23
0
  *b_p = c;
24
0
}
25
26
0
void av1_init_layer_context(AV1_COMP *const cpi) {
27
0
  AV1_COMMON *const cm = &cpi->common;
28
0
  const AV1EncoderConfig *const oxcf = &cpi->oxcf;
29
0
  SVC *const svc = &cpi->svc;
30
0
  int mi_rows = cpi->common.mi_params.mi_rows;
31
0
  int mi_cols = cpi->common.mi_params.mi_cols;
32
0
  svc->base_framerate = 30.0;
33
0
  svc->current_superframe = 0;
34
0
  svc->force_zero_mode_spatial_ref = 1;
35
0
  svc->num_encoded_top_layer = 0;
36
0
  svc->use_flexible_mode = 0;
37
0
  svc->has_lower_quality_layer = 0;
38
39
0
  for (int sl = 0; sl < svc->number_spatial_layers; ++sl) {
40
0
    for (int tl = 0; tl < svc->number_temporal_layers; ++tl) {
41
0
      int layer = LAYER_IDS_TO_IDX(sl, tl, svc->number_temporal_layers);
42
0
      LAYER_CONTEXT *const lc = &svc->layer_context[layer];
43
0
      RATE_CONTROL *const lrc = &lc->rc;
44
0
      PRIMARY_RATE_CONTROL *const lp_rc = &lc->p_rc;
45
0
      lrc->ni_av_qi = oxcf->rc_cfg.worst_allowed_q;
46
0
      lp_rc->total_actual_bits = 0;
47
0
      lrc->ni_tot_qi = 0;
48
0
      lp_rc->tot_q = 0.0;
49
0
      lp_rc->avg_q = 0.0;
50
0
      lp_rc->ni_frames = 0;
51
0
      lrc->decimation_count = 0;
52
0
      lrc->decimation_factor = 0;
53
0
      lrc->worst_quality = av1_quantizer_to_qindex(lc->max_q);
54
0
      lrc->best_quality = av1_quantizer_to_qindex(lc->min_q);
55
0
      lrc->rtc_external_ratectrl = 0;
56
0
      for (int i = 0; i < RATE_FACTOR_LEVELS; ++i) {
57
0
        lp_rc->rate_correction_factors[i] = 1.0;
58
0
      }
59
0
      lc->target_bandwidth = lc->layer_target_bitrate;
60
0
      lp_rc->last_q[INTER_FRAME] = lrc->worst_quality;
61
0
      lp_rc->avg_frame_qindex[INTER_FRAME] = lrc->worst_quality;
62
0
      lp_rc->avg_frame_qindex[KEY_FRAME] = lrc->worst_quality;
63
0
      lp_rc->buffer_level =
64
0
          oxcf->rc_cfg.starting_buffer_level_ms * lc->target_bandwidth / 1000;
65
0
      lp_rc->bits_off_target = lp_rc->buffer_level;
66
      // Initialize the cyclic refresh parameters. If spatial layers are used
67
      // (i.e., ss_number_layers > 1), these need to be updated per spatial
68
      // layer. Cyclic refresh is only applied on base temporal layer.
69
0
      if (svc->number_spatial_layers > 1 && tl == 0) {
70
0
        lc->sb_index = 0;
71
0
        lc->actual_num_seg1_blocks = 0;
72
0
        lc->actual_num_seg2_blocks = 0;
73
0
        lc->counter_encode_maxq_scene_change = 0;
74
0
        aom_free(lc->map);
75
0
        CHECK_MEM_ERROR(cm, lc->map,
76
0
                        aom_calloc(mi_rows * mi_cols, sizeof(*lc->map)));
77
0
      }
78
0
    }
79
0
    svc->downsample_filter_type[sl] = BILINEAR;
80
0
    svc->downsample_filter_phase[sl] = 8;
81
0
    svc->last_layer_dropped[sl] = false;
82
0
    svc->drop_spatial_layer[sl] = false;
83
0
  }
84
0
  if (svc->number_spatial_layers == 3) {
85
0
    svc->downsample_filter_type[0] = EIGHTTAP_SMOOTH;
86
0
  }
87
0
}
88
89
0
bool av1_alloc_layer_context(AV1_COMP *cpi, int num_layers) {
90
0
  SVC *const svc = &cpi->svc;
91
0
  if (svc->layer_context == NULL || svc->num_allocated_layers < num_layers) {
92
0
    assert(num_layers > 1);
93
0
    aom_free(svc->layer_context);
94
0
    svc->num_allocated_layers = 0;
95
0
    svc->layer_context =
96
0
        (LAYER_CONTEXT *)aom_calloc(num_layers, sizeof(*svc->layer_context));
97
0
    if (svc->layer_context == NULL) return false;
98
0
    svc->num_allocated_layers = num_layers;
99
0
  }
100
0
  return true;
101
0
}
102
103
// Update the layer context from a change_config() call.
104
void av1_update_layer_context_change_config(AV1_COMP *const cpi,
105
0
                                            const int64_t target_bandwidth) {
106
0
  const RATE_CONTROL *const rc = &cpi->rc;
107
0
  const PRIMARY_RATE_CONTROL *const p_rc = &cpi->ppi->p_rc;
108
0
  AV1_COMMON *const cm = &cpi->common;
109
0
  SVC *const svc = &cpi->svc;
110
0
  int layer = 0;
111
0
  int64_t spatial_layer_target = 0;
112
0
  float bitrate_alloc = 1.0;
113
0
  const int mi_rows = cm->mi_params.mi_rows;
114
0
  const int mi_cols = cm->mi_params.mi_cols;
115
0
  for (int sl = 0; sl < svc->number_spatial_layers; ++sl) {
116
0
    for (int tl = 0; tl < svc->number_temporal_layers; ++tl) {
117
0
      layer = LAYER_IDS_TO_IDX(sl, tl, svc->number_temporal_layers);
118
0
      LAYER_CONTEXT *const lc = &svc->layer_context[layer];
119
0
      svc->layer_context[layer].target_bandwidth = lc->layer_target_bitrate;
120
0
    }
121
0
    spatial_layer_target = svc->layer_context[layer].target_bandwidth;
122
0
    for (int tl = 0; tl < svc->number_temporal_layers; ++tl) {
123
0
      LAYER_CONTEXT *const lc =
124
0
          &svc->layer_context[sl * svc->number_temporal_layers + tl];
125
0
      RATE_CONTROL *const lrc = &lc->rc;
126
0
      PRIMARY_RATE_CONTROL *const lp_rc = &lc->p_rc;
127
0
      lc->spatial_layer_target_bandwidth = spatial_layer_target;
128
0
      if (target_bandwidth != 0) {
129
0
        bitrate_alloc = (float)lc->target_bandwidth / target_bandwidth;
130
0
      }
131
0
      lp_rc->starting_buffer_level =
132
0
          (int64_t)(p_rc->starting_buffer_level * bitrate_alloc);
133
0
      lp_rc->optimal_buffer_level =
134
0
          (int64_t)(p_rc->optimal_buffer_level * bitrate_alloc);
135
0
      lp_rc->maximum_buffer_size =
136
0
          (int64_t)(p_rc->maximum_buffer_size * bitrate_alloc);
137
0
      lp_rc->bits_off_target =
138
0
          AOMMIN(lp_rc->bits_off_target, lp_rc->maximum_buffer_size);
139
0
      lp_rc->buffer_level =
140
0
          AOMMIN(lp_rc->buffer_level, lp_rc->maximum_buffer_size);
141
0
      lc->framerate = cpi->framerate / lc->framerate_factor;
142
0
      lrc->avg_frame_bandwidth =
143
0
          (int)round(lc->target_bandwidth / lc->framerate);
144
0
      lrc->max_frame_bandwidth = rc->max_frame_bandwidth;
145
0
      lrc->rtc_external_ratectrl = rc->rtc_external_ratectrl;
146
0
      lrc->worst_quality = av1_quantizer_to_qindex(lc->max_q);
147
0
      lrc->best_quality = av1_quantizer_to_qindex(lc->min_q);
148
0
      if (rc->use_external_qp_one_pass) {
149
0
        lrc->worst_quality = rc->worst_quality;
150
0
        lrc->best_quality = rc->best_quality;
151
0
      }
152
      // Reset the cyclic refresh parameters, if needed (map is NULL),
153
      // or number of spatial layers has changed.
154
      // Cyclic refresh is only applied on base temporal layer.
155
0
      if (svc->number_spatial_layers > 1 && tl == 0 &&
156
0
          (lc->map == NULL ||
157
0
           svc->prev_number_spatial_layers != svc->number_spatial_layers)) {
158
0
        lc->sb_index = 0;
159
0
        lc->actual_num_seg1_blocks = 0;
160
0
        lc->actual_num_seg2_blocks = 0;
161
0
        lc->counter_encode_maxq_scene_change = 0;
162
0
        aom_free(lc->map);
163
0
        CHECK_MEM_ERROR(cm, lc->map,
164
0
                        aom_calloc(mi_rows * mi_cols, sizeof(*lc->map)));
165
0
      }
166
0
    }
167
0
  }
168
0
}
169
170
/*!\brief Return layer context for current layer.
171
 *
172
 * \ingroup rate_control
173
 * \param[in]       cpi   Top level encoder structure
174
 *
175
 * \return LAYER_CONTEXT for current layer.
176
 */
177
0
static LAYER_CONTEXT *get_layer_context(AV1_COMP *const cpi) {
178
0
  return &cpi->svc.layer_context[cpi->svc.spatial_layer_id *
179
0
                                     cpi->svc.number_temporal_layers +
180
0
                                 cpi->svc.temporal_layer_id];
181
0
}
182
183
0
void av1_update_temporal_layer_framerate(AV1_COMP *const cpi) {
184
0
  SVC *const svc = &cpi->svc;
185
0
  LAYER_CONTEXT *const lc = get_layer_context(cpi);
186
0
  RATE_CONTROL *const lrc = &lc->rc;
187
0
  const int tl = svc->temporal_layer_id;
188
0
  lc->framerate = cpi->framerate / lc->framerate_factor;
189
0
  lrc->avg_frame_bandwidth =
190
0
      saturate_cast_double_to_int(round(lc->target_bandwidth / lc->framerate));
191
0
  lrc->max_frame_bandwidth = cpi->rc.max_frame_bandwidth;
192
  // Update the average layer frame size (non-cumulative per-frame-bw).
193
0
  if (tl == 0) {
194
0
    lc->avg_frame_size = lrc->avg_frame_bandwidth;
195
0
  } else {
196
0
    int prev_layer = svc->spatial_layer_id * svc->number_temporal_layers +
197
0
                     svc->temporal_layer_id - 1;
198
0
    LAYER_CONTEXT *const lcprev = &svc->layer_context[prev_layer];
199
0
    const double prev_layer_framerate =
200
0
        cpi->framerate / lcprev->framerate_factor;
201
0
    const int64_t prev_layer_target_bandwidth = lcprev->layer_target_bitrate;
202
0
    if (lc->framerate > prev_layer_framerate) {
203
0
      lc->avg_frame_size =
204
0
          (int)round((lc->target_bandwidth - prev_layer_target_bandwidth) /
205
0
                     (lc->framerate - prev_layer_framerate));
206
0
    } else {
207
0
      lc->avg_frame_size = (int)round(lc->target_bandwidth / lc->framerate);
208
0
    }
209
0
  }
210
0
}
211
212
bool av1_check_ref_is_low_spatial_res_super_frame(AV1_COMP *const cpi,
213
0
                                                  int ref_frame) {
214
0
  SVC *svc = &cpi->svc;
215
0
  RTC_REF *const rtc_ref = &cpi->ppi->rtc_ref;
216
0
  int ref_frame_idx = rtc_ref->ref_idx[ref_frame - 1];
217
0
  return rtc_ref->buffer_time_index[ref_frame_idx] == svc->current_superframe &&
218
0
         rtc_ref->buffer_spatial_layer[ref_frame_idx] <=
219
0
             svc->spatial_layer_id - 1;
220
0
}
221
222
0
void av1_restore_layer_context(AV1_COMP *const cpi) {
223
0
  SVC *const svc = &cpi->svc;
224
0
  RTC_REF *const rtc_ref = &cpi->ppi->rtc_ref;
225
0
  const AV1_COMMON *const cm = &cpi->common;
226
0
  LAYER_CONTEXT *const lc = get_layer_context(cpi);
227
0
  const int old_frame_since_key = cpi->rc.frames_since_key;
228
0
  const int old_frame_to_key = cpi->rc.frames_to_key;
229
0
  const int frames_since_scene_change = cpi->rc.frames_since_scene_change;
230
0
  const int last_encoded_size_keyframe = cpi->rc.last_encoded_size_keyframe;
231
0
  const int last_target_size_keyframe = cpi->rc.last_target_size_keyframe;
232
0
  const int max_consec_drop = cpi->rc.max_consec_drop;
233
0
  const int postencode_drop = cpi->rc.postencode_drop;
234
0
  const int static_since_last_scene_change =
235
0
      cpi->rc.static_since_last_scene_change;
236
  // Restore layer rate control.
237
0
  cpi->rc = lc->rc;
238
0
  cpi->ppi->p_rc = lc->p_rc;
239
0
  cpi->oxcf.rc_cfg.target_bandwidth = lc->target_bandwidth;
240
0
  cpi->gf_frame_index = 0;
241
0
  cpi->mv_search_params.max_mv_magnitude = lc->max_mv_magnitude;
242
0
  if (cpi->mv_search_params.max_mv_magnitude == 0)
243
0
    cpi->mv_search_params.max_mv_magnitude = AOMMAX(cm->width, cm->height);
244
  // Reset the following parameters to their values before
245
  // the layer restore. Keep these defined for the stream (not layer).
246
0
  cpi->rc.frames_since_key = old_frame_since_key;
247
0
  cpi->rc.frames_to_key = old_frame_to_key;
248
0
  cpi->rc.frames_since_scene_change = frames_since_scene_change;
249
0
  cpi->rc.last_encoded_size_keyframe = last_encoded_size_keyframe;
250
0
  cpi->rc.last_target_size_keyframe = last_target_size_keyframe;
251
0
  cpi->rc.max_consec_drop = max_consec_drop;
252
0
  cpi->rc.postencode_drop = postencode_drop;
253
0
  cpi->rc.static_since_last_scene_change = static_since_last_scene_change;
254
  // For spatial-svc, allow cyclic-refresh to be applied on the spatial layers,
255
  // for the base temporal layer.
256
0
  if (cpi->oxcf.q_cfg.aq_mode == CYCLIC_REFRESH_AQ &&
257
0
      svc->number_spatial_layers > 1 && svc->temporal_layer_id == 0) {
258
0
    CYCLIC_REFRESH *const cr = cpi->cyclic_refresh;
259
0
    swap_ptr(&cr->map, &lc->map);
260
0
    cr->sb_index = lc->sb_index;
261
0
    cr->actual_num_seg1_blocks = lc->actual_num_seg1_blocks;
262
0
    cr->actual_num_seg2_blocks = lc->actual_num_seg2_blocks;
263
0
    cr->counter_encode_maxq_scene_change = lc->counter_encode_maxq_scene_change;
264
0
  }
265
0
  svc->skip_mvsearch_last = 0;
266
0
  svc->skip_mvsearch_gf = 0;
267
0
  svc->skip_mvsearch_altref = 0;
268
  // For each reference (LAST/GOLDEN) set the skip_mvsearch_last/gf frame flags.
269
  // This is to skip searching mv for that reference if it was last
270
  // refreshed (i.e., buffer slot holding that reference was refreshed) on the
271
  // previous spatial layer(s) at the same time (current_superframe).
272
0
  if (rtc_ref->set_ref_frame_config && svc->force_zero_mode_spatial_ref &&
273
0
      cpi->sf.rt_sf.use_nonrd_pick_mode) {
274
0
    if (av1_check_ref_is_low_spatial_res_super_frame(cpi, LAST_FRAME)) {
275
0
      svc->skip_mvsearch_last = 1;
276
0
    }
277
0
    if (av1_check_ref_is_low_spatial_res_super_frame(cpi, GOLDEN_FRAME)) {
278
0
      svc->skip_mvsearch_gf = 1;
279
0
    }
280
0
    if (av1_check_ref_is_low_spatial_res_super_frame(cpi, ALTREF_FRAME)) {
281
0
      svc->skip_mvsearch_altref = 1;
282
0
    }
283
0
  }
284
0
}
285
286
0
void av1_svc_update_buffer_slot_refreshed(AV1_COMP *const cpi) {
287
0
  SVC *const svc = &cpi->svc;
288
0
  RTC_REF *const rtc_ref = &cpi->ppi->rtc_ref;
289
0
  const unsigned int current_frame =
290
0
      cpi->ppi->use_svc ? svc->current_superframe
291
0
                        : cpi->common.current_frame.frame_number;
292
  // For any buffer slot that is refreshed, update it with
293
  // the spatial_layer_id and the current_superframe.
294
0
  if (cpi->common.current_frame.frame_type == KEY_FRAME) {
295
    // All slots are refreshed on KEY.
296
0
    for (unsigned int i = 0; i < REF_FRAMES; i++) {
297
0
      rtc_ref->buffer_time_index[i] = current_frame;
298
0
      rtc_ref->buffer_spatial_layer[i] = svc->spatial_layer_id;
299
0
    }
300
0
  } else if (rtc_ref->set_ref_frame_config) {
301
0
    for (unsigned int i = 0; i < INTER_REFS_PER_FRAME; i++) {
302
0
      const int ref_frame_map_idx = rtc_ref->ref_idx[i];
303
0
      if (rtc_ref->refresh[ref_frame_map_idx]) {
304
0
        rtc_ref->buffer_time_index[ref_frame_map_idx] = current_frame;
305
0
        rtc_ref->buffer_spatial_layer[ref_frame_map_idx] =
306
0
            svc->spatial_layer_id;
307
0
      }
308
0
    }
309
0
  }
310
0
}
311
312
0
void av1_save_layer_context(AV1_COMP *const cpi) {
313
0
  SVC *const svc = &cpi->svc;
314
0
  const AV1_COMMON *const cm = &cpi->common;
315
0
  LAYER_CONTEXT *lc = get_layer_context(cpi);
316
0
  lc->rc = cpi->rc;
317
0
  lc->p_rc = cpi->ppi->p_rc;
318
0
  lc->target_bandwidth = (int)cpi->oxcf.rc_cfg.target_bandwidth;
319
0
  lc->group_index = cpi->gf_frame_index;
320
0
  lc->max_mv_magnitude = cpi->mv_search_params.max_mv_magnitude;
321
0
  if (svc->spatial_layer_id == 0) svc->base_framerate = cpi->framerate;
322
  // For spatial-svc, allow cyclic-refresh to be applied on the spatial layers,
323
  // for the base temporal layer.
324
0
  if (cpi->oxcf.q_cfg.aq_mode == CYCLIC_REFRESH_AQ &&
325
0
      cpi->svc.number_spatial_layers > 1 && svc->temporal_layer_id == 0) {
326
0
    CYCLIC_REFRESH *const cr = cpi->cyclic_refresh;
327
0
    signed char *temp = lc->map;
328
0
    lc->map = cr->map;
329
0
    cr->map = temp;
330
0
    lc->sb_index = cr->sb_index;
331
0
    lc->actual_num_seg1_blocks = cr->actual_num_seg1_blocks;
332
0
    lc->actual_num_seg2_blocks = cr->actual_num_seg2_blocks;
333
0
    lc->counter_encode_maxq_scene_change = cr->counter_encode_maxq_scene_change;
334
0
  }
335
0
  if (!cpi->is_dropped_frame) {
336
0
    av1_svc_update_buffer_slot_refreshed(cpi);
337
0
    for (unsigned int i = 0; i < REF_FRAMES; i++) {
338
0
      if (frame_is_intra_only(cm) ||
339
0
          cm->current_frame.refresh_frame_flags & (1 << i)) {
340
0
        svc->spatial_layer_fb[i] = svc->spatial_layer_id;
341
0
        svc->temporal_layer_fb[i] = svc->temporal_layer_id;
342
0
      }
343
0
    }
344
0
  }
345
0
  if (svc->spatial_layer_id == svc->number_spatial_layers - 1) {
346
0
    svc->current_superframe++;
347
    // Reset drop flag to false for next superframe.
348
0
    for (int sl = 0; sl < svc->number_spatial_layers; sl++)
349
0
      svc->drop_spatial_layer[sl] = false;
350
0
  }
351
0
}
352
353
0
int av1_svc_primary_ref_frame(const AV1_COMP *const cpi) {
354
0
  const SVC *const svc = &cpi->svc;
355
0
  const AV1_COMMON *const cm = &cpi->common;
356
0
  int fb_idx = -1;
357
0
  int primary_ref_frame = PRIMARY_REF_NONE;
358
0
  if (cpi->svc.number_spatial_layers > 1 ||
359
0
      cpi->svc.number_temporal_layers > 1) {
360
    // Set the primary_ref_frame to LAST_FRAME if that buffer slot for LAST
361
    // was last updated on a lower temporal layer (or base TL0) and for the
362
    // same spatial layer. For RTC patterns this allows for continued decoding
363
    // when set of enhancement layers are dropped (continued decoding starting
364
    // at next base TL0), so error_resilience can be off/0 for all layers.
365
0
    fb_idx = get_ref_frame_map_idx(cm, LAST_FRAME);
366
0
    if (cpi->ppi->rtc_ref.reference[0] == 1 &&
367
0
        svc->spatial_layer_fb[fb_idx] == svc->spatial_layer_id &&
368
0
        (svc->temporal_layer_fb[fb_idx] < svc->temporal_layer_id ||
369
0
         svc->temporal_layer_fb[fb_idx] == 0)) {
370
0
      primary_ref_frame = 0;  // LAST_FRAME: ref_frame - LAST_FRAME
371
0
    }
372
0
  } else if (cpi->ppi->rtc_ref.set_ref_frame_config) {
373
0
    const ExternalFlags *const ext_flags = &cpi->ext_flags;
374
0
    int flags = ext_flags->ref_frame_flags;
375
0
    if (flags & AOM_LAST_FLAG) {
376
0
      primary_ref_frame = 0;  // LAST_FRAME: ref_frame - LAST_FRAME
377
0
    } else if (flags & AOM_GOLD_FLAG) {
378
0
      primary_ref_frame = GOLDEN_FRAME - LAST_FRAME;
379
0
    } else if (flags & AOM_ALT_FLAG) {
380
0
      primary_ref_frame = ALTREF_FRAME - LAST_FRAME;
381
0
    }
382
0
  }
383
0
  return primary_ref_frame;
384
0
}
385
386
0
void av1_free_svc_cyclic_refresh(AV1_COMP *const cpi) {
387
0
  SVC *const svc = &cpi->svc;
388
0
  for (int sl = 0; sl < svc->number_spatial_layers; ++sl) {
389
0
    for (int tl = 0; tl < svc->number_temporal_layers; ++tl) {
390
0
      int layer = LAYER_IDS_TO_IDX(sl, tl, svc->number_temporal_layers);
391
0
      LAYER_CONTEXT *const lc = &svc->layer_context[layer];
392
0
      aom_free(lc->map);
393
0
      lc->map = NULL;
394
0
    }
395
0
  }
396
0
}
397
398
0
void av1_svc_reset_temporal_layers(AV1_COMP *const cpi, int is_key) {
399
0
  SVC *const svc = &cpi->svc;
400
0
  LAYER_CONTEXT *lc = NULL;
401
0
  for (int sl = 0; sl < svc->number_spatial_layers; ++sl) {
402
0
    for (int tl = 0; tl < svc->number_temporal_layers; ++tl) {
403
0
      lc = &cpi->svc.layer_context[sl * svc->number_temporal_layers + tl];
404
0
      if (is_key) lc->frames_from_key_frame = 0;
405
0
    }
406
0
  }
407
0
  av1_update_temporal_layer_framerate(cpi);
408
0
  av1_restore_layer_context(cpi);
409
0
}
410
411
void av1_get_layer_resolution(const int width_org, const int height_org,
412
                              const int num, const int den, int *width_out,
413
0
                              int *height_out) {
414
0
  int w, h;
415
0
  if (width_out == NULL || height_out == NULL || den == 0) return;
416
0
  if (den == 1 && num == 1) {
417
0
    *width_out = width_org;
418
0
    *height_out = height_org;
419
0
    return;
420
0
  }
421
0
  w = width_org * num / den;
422
0
  h = height_org * num / den;
423
  // Make height and width even.
424
0
  w += w % 2;
425
0
  h += h % 2;
426
0
  *width_out = w;
427
0
  *height_out = h;
428
0
}
429
430
0
void av1_one_pass_cbr_svc_start_layer(AV1_COMP *const cpi) {
431
0
  SVC *const svc = &cpi->svc;
432
0
  AV1_COMMON *const cm = &cpi->common;
433
0
  LAYER_CONTEXT *lc = NULL;
434
0
  int width = 0, height = 0;
435
0
  lc = &svc->layer_context[svc->spatial_layer_id * svc->number_temporal_layers +
436
0
                           svc->temporal_layer_id];
437
  // Set the lower quality layer flag.
438
0
  svc->has_lower_quality_layer = 0;
439
0
  if (cpi->svc.spatial_layer_id > 0) {
440
0
    const LAYER_CONTEXT *lc_prev =
441
0
        &svc->layer_context[(svc->spatial_layer_id - 1) *
442
0
                                svc->number_temporal_layers +
443
0
                            svc->temporal_layer_id];
444
0
    if (lc_prev->scaling_factor_den == 1 && lc_prev->scaling_factor_num == 1)
445
0
      svc->has_lower_quality_layer = 1;
446
0
  }
447
0
  av1_get_layer_resolution(cpi->oxcf.frm_dim_cfg.width,
448
0
                           cpi->oxcf.frm_dim_cfg.height, lc->scaling_factor_num,
449
0
                           lc->scaling_factor_den, &width, &height);
450
  // Use Eightap_smooth for low resolutions.
451
0
  if (width * height <= 320 * 240)
452
0
    svc->downsample_filter_type[svc->spatial_layer_id] = EIGHTTAP_SMOOTH;
453
454
0
  cm->width = width;
455
0
  cm->height = height;
456
0
  alloc_mb_mode_info_buffers(cpi);
457
0
  av1_update_frame_size(cpi);
458
0
  if (svc->spatial_layer_id == svc->number_spatial_layers - 1) {
459
0
    svc->mi_cols_full_resoln = cm->mi_params.mi_cols;
460
0
    svc->mi_rows_full_resoln = cm->mi_params.mi_rows;
461
0
  }
462
0
}
463
464
enum {
465
  SVC_LAST_FRAME = 0,
466
  SVC_LAST2_FRAME,
467
  SVC_LAST3_FRAME,
468
  SVC_GOLDEN_FRAME,
469
  SVC_BWDREF_FRAME,
470
  SVC_ALTREF2_FRAME,
471
  SVC_ALTREF_FRAME
472
};
473
474
// For fixed svc mode: fixed pattern is set based on the number of
475
// spatial and temporal layers, and the ksvc_fixed_mode.
476
0
void av1_set_svc_fixed_mode(AV1_COMP *const cpi) {
477
0
  SVC *const svc = &cpi->svc;
478
0
  RTC_REF *const rtc_ref = &cpi->ppi->rtc_ref;
479
0
  int i;
480
0
  assert(svc->use_flexible_mode == 0);
481
0
  assert(svc->number_spatial_layers >= 1 && svc->number_temporal_layers >= 1);
482
  // Fixed SVC mode only supports at most 3 spatial or temporal layers.
483
0
  if (svc->number_spatial_layers > 3 || svc->number_temporal_layers > 3) {
484
0
    aom_internal_error(&cpi->ppi->error, AOM_CODEC_INVALID_PARAM,
485
0
                       "Invalid number of spatial/temporal layers for fixed "
486
0
                       "SVC mode (max: 3)");
487
0
  }
488
0
  rtc_ref->set_ref_frame_config = 1;
489
0
  int superframe_cnt = svc->current_superframe;
490
  // Set the reference map buffer idx for the 7 references:
491
  // LAST_FRAME (0), LAST2_FRAME(1), LAST3_FRAME(2), GOLDEN_FRAME(3),
492
  // BWDREF_FRAME(4), ALTREF2_FRAME(5), ALTREF_FRAME(6).
493
0
  for (i = 0; i < INTER_REFS_PER_FRAME; i++) {
494
0
    rtc_ref->reference[i] = 0;
495
0
    rtc_ref->ref_idx[i] = i;
496
0
  }
497
0
  for (i = 0; i < REF_FRAMES; i++) rtc_ref->refresh[i] = 0;
498
  // Always reference LAST, and reference GOLDEN on SL > 0.
499
  // For KSVC: GOLDEN reference will be removed on INTER_FRAMES later
500
  // when frame_type is set.
501
0
  rtc_ref->reference[SVC_LAST_FRAME] = 1;
502
0
  if (svc->spatial_layer_id > 0) rtc_ref->reference[SVC_GOLDEN_FRAME] = 1;
503
0
  if (svc->temporal_layer_id == 0) {
504
    // Base temporal layer.
505
0
    if (svc->spatial_layer_id == 0) {
506
      // Set all buffer_idx to 0. Update slot 0 (LAST).
507
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 0;
508
0
      rtc_ref->refresh[0] = 1;
509
0
    } else if (svc->spatial_layer_id == 1) {
510
      // Set buffer_idx for LAST to slot 1, GOLDEN (and all other refs) to
511
      // slot 0. Update slot 1 (LAST).
512
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 0;
513
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 1;
514
0
      rtc_ref->refresh[1] = 1;
515
0
    } else if (svc->spatial_layer_id == 2) {
516
      // Set buffer_idx for LAST to slot 2, GOLDEN (and all other refs) to
517
      // slot 1. Update slot 2 (LAST).
518
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 1;
519
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 2;
520
0
      rtc_ref->refresh[2] = 1;
521
0
    }
522
0
  } else if (svc->temporal_layer_id == 2 && (superframe_cnt - 1) % 4 == 0) {
523
    // First top temporal enhancement layer.
524
0
    if (svc->spatial_layer_id == 0) {
525
      // Reference LAST (slot 0).
526
      // Set GOLDEN to slot 3 and update slot 3.
527
      // Set all other buffer_idx to slot 0.
528
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 0;
529
0
      if (svc->spatial_layer_id < svc->number_spatial_layers - 1) {
530
0
        rtc_ref->ref_idx[SVC_GOLDEN_FRAME] = 3;
531
0
        rtc_ref->refresh[3] = 1;
532
0
      }
533
0
    } else if (svc->spatial_layer_id == 1) {
534
      // Reference LAST and GOLDEN. Set buffer_idx for LAST to slot 1,
535
      // GOLDEN (and all other refs) to slot 3.
536
      // Set LAST2 to slot 4 and Update slot 4.
537
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 3;
538
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 1;
539
0
      if (svc->spatial_layer_id < svc->number_spatial_layers - 1) {
540
0
        rtc_ref->ref_idx[SVC_LAST2_FRAME] = 4;
541
0
        rtc_ref->refresh[4] = 1;
542
0
      }
543
0
    } else if (svc->spatial_layer_id == 2) {
544
      // Reference LAST and GOLDEN. Set buffer_idx for LAST to slot 2,
545
      // GOLDEN (and all other refs) to slot 4.
546
      // No update.
547
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 4;
548
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 2;
549
0
    }
550
0
  } else if (svc->temporal_layer_id == 1) {
551
    // Middle temporal enhancement layer.
552
0
    if (svc->spatial_layer_id == 0) {
553
      // Reference LAST.
554
      // Set all buffer_idx to 0.
555
      // Set GOLDEN to slot 5 and update slot 5.
556
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 0;
557
0
      if (svc->temporal_layer_id < svc->number_temporal_layers - 1 ||
558
0
          svc->spatial_layer_id < svc->number_spatial_layers - 1) {
559
0
        rtc_ref->ref_idx[SVC_GOLDEN_FRAME] = 5;
560
0
        rtc_ref->refresh[5] = 1;
561
0
      }
562
0
    } else if (svc->spatial_layer_id == 1) {
563
      // Reference LAST and GOLDEN. Set buffer_idx for LAST to slot 1,
564
      // GOLDEN (and all other refs) to slot 5.
565
      // Set LAST3 to slot 6 and update slot 6.
566
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 5;
567
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 1;
568
0
      if (svc->temporal_layer_id < svc->number_temporal_layers - 1 ||
569
0
          svc->spatial_layer_id < svc->number_spatial_layers - 1) {
570
0
        rtc_ref->ref_idx[SVC_LAST3_FRAME] = 6;
571
0
        rtc_ref->refresh[6] = 1;
572
0
      }
573
0
    } else if (svc->spatial_layer_id == 2) {
574
      // Reference LAST and GOLDEN. Set buffer_idx for LAST to slot 2,
575
      // GOLDEN (and all other refs) to slot 6.
576
      // Set LAST3 to slot 7 and update slot 7.
577
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 6;
578
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 2;
579
0
      if (svc->temporal_layer_id < svc->number_temporal_layers - 1) {
580
0
        rtc_ref->ref_idx[SVC_LAST3_FRAME] = 7;
581
0
        rtc_ref->refresh[7] = 1;
582
0
      }
583
0
    }
584
0
  } else if (svc->temporal_layer_id == 2 && (superframe_cnt - 3) % 4 == 0) {
585
    // Second top temporal enhancement layer.
586
0
    if (svc->spatial_layer_id == 0) {
587
      // Set LAST to slot 5 and reference LAST.
588
      // Set GOLDEN to slot 3 and update slot 3.
589
      // Set all other buffer_idx to 0.
590
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 0;
591
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 5;
592
0
      if (svc->spatial_layer_id < svc->number_spatial_layers - 1) {
593
0
        rtc_ref->ref_idx[SVC_GOLDEN_FRAME] = 3;
594
0
        rtc_ref->refresh[3] = 1;
595
0
      }
596
0
    } else if (svc->spatial_layer_id == 1) {
597
      // Reference LAST and GOLDEN. Set buffer_idx for LAST to slot 6,
598
      // GOLDEN to slot 3. Set LAST2 to slot 4 and update slot 4.
599
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 0;
600
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 6;
601
0
      rtc_ref->ref_idx[SVC_GOLDEN_FRAME] = 3;
602
0
      if (svc->spatial_layer_id < svc->number_spatial_layers - 1) {
603
0
        rtc_ref->ref_idx[SVC_LAST2_FRAME] = 4;
604
0
        rtc_ref->refresh[4] = 1;
605
0
      }
606
0
    } else if (svc->spatial_layer_id == 2) {
607
      // Reference LAST and GOLDEN. Set buffer_idx for LAST to slot 7,
608
      // GOLDEN to slot 4. No update.
609
0
      for (i = 0; i < INTER_REFS_PER_FRAME; i++) rtc_ref->ref_idx[i] = 0;
610
0
      rtc_ref->ref_idx[SVC_LAST_FRAME] = 7;
611
0
      rtc_ref->ref_idx[SVC_GOLDEN_FRAME] = 4;
612
0
    }
613
0
  }
614
0
}
615
616
0
void av1_svc_check_reset_layer_rc_flag(AV1_COMP *const cpi) {
617
0
  SVC *const svc = &cpi->svc;
618
0
  for (int sl = 0; sl < svc->number_spatial_layers; ++sl) {
619
    // Check for reset based on avg_frame_bandwidth for spatial layer sl.
620
    // If avg_frame_bandwidth for top temporal layer is not set
621
    // (because enhancement layer was inactive), use the base TL0
622
0
    int layer = LAYER_IDS_TO_IDX(sl, svc->number_temporal_layers - 1,
623
0
                                 svc->number_temporal_layers);
624
0
    LAYER_CONTEXT *lc = &svc->layer_context[layer];
625
0
    RATE_CONTROL *lrc = &lc->rc;
626
0
    int avg_frame_bandwidth = lrc->avg_frame_bandwidth;
627
0
    int prev_avg_frame_bandwidth = lrc->prev_avg_frame_bandwidth;
628
0
    if (avg_frame_bandwidth == 0 || prev_avg_frame_bandwidth == 0) {
629
      // Use base TL0.
630
0
      layer = LAYER_IDS_TO_IDX(sl, 0, svc->number_temporal_layers);
631
0
      lc = &svc->layer_context[layer];
632
0
      lrc = &lc->rc;
633
0
      avg_frame_bandwidth = lrc->avg_frame_bandwidth;
634
0
      prev_avg_frame_bandwidth = lrc->prev_avg_frame_bandwidth;
635
0
    }
636
0
    if (avg_frame_bandwidth / 3 > (prev_avg_frame_bandwidth >> 1) ||
637
0
        avg_frame_bandwidth < (prev_avg_frame_bandwidth >> 1)) {
638
      // Reset for all temporal layers with spatial layer sl.
639
0
      for (int tl = 0; tl < svc->number_temporal_layers; ++tl) {
640
0
        int layer2 = LAYER_IDS_TO_IDX(sl, tl, svc->number_temporal_layers);
641
0
        LAYER_CONTEXT *lc2 = &svc->layer_context[layer2];
642
0
        RATE_CONTROL *lrc2 = &lc2->rc;
643
0
        PRIMARY_RATE_CONTROL *lp_rc2 = &lc2->p_rc;
644
0
        PRIMARY_RATE_CONTROL *const lp_rc = &lc2->p_rc;
645
0
        lrc2->rc_1_frame = 0;
646
0
        lrc2->rc_2_frame = 0;
647
0
        lp_rc2->bits_off_target = lp_rc->optimal_buffer_level;
648
0
        lp_rc2->buffer_level = lp_rc->optimal_buffer_level;
649
0
      }
650
0
    }
651
0
  }
652
0
}
653
654
void av1_svc_set_last_source(AV1_COMP *const cpi, EncodeFrameInput *frame_input,
655
0
                             YV12_BUFFER_CONFIG *prev_source) {
656
0
  frame_input->last_source = prev_source != NULL ? prev_source : NULL;
657
0
  if (!cpi->ppi->use_svc && cpi->rc.prev_frame_is_dropped &&
658
0
      cpi->rc.frame_number_encoded > 0) {
659
0
    frame_input->last_source = &cpi->svc.source_last_TL0;
660
0
  } else {
661
0
    RTC_REF *const rtc_ref = &cpi->ppi->rtc_ref;
662
0
    if (cpi->svc.spatial_layer_id == 0) {
663
      // For base spatial layer: if the LAST reference (index 0) is not
664
      // the previous (super)frame set the last_source to the source
665
      // corresponding to the last TL0, otherwise keep it at prev_source.
666
      // Always use source_last_TL0 if previous base TL0 was dropped.
667
0
      if (cpi->svc.current_superframe > 0) {
668
0
        const int buffslot_last = rtc_ref->ref_idx[0];
669
        // Check if previous frame was dropped on base TL0 layer.
670
0
        const int layer =
671
0
            LAYER_IDS_TO_IDX(0, 0, cpi->svc.number_temporal_layers);
672
0
        LAYER_CONTEXT *lc = &cpi->svc.layer_context[layer];
673
0
        RATE_CONTROL *lrc = &lc->rc;
674
0
        if (lrc->prev_frame_is_dropped ||
675
0
            rtc_ref->buffer_time_index[buffslot_last] <
676
0
                cpi->svc.current_superframe - 1) {
677
0
          frame_input->last_source = &cpi->svc.source_last_TL0;
678
0
        }
679
0
      }
680
0
    } else if (cpi->svc.spatial_layer_id > 0) {
681
      // For spatial enhancement layers: the previous source (prev_source)
682
      // corresponds to the lower spatial layer (which is the same source so
683
      // we can't use that), so always set the last_source to the source of the
684
      // last TL0.
685
0
      if (cpi->svc.current_superframe > 0)
686
0
        frame_input->last_source = &cpi->svc.source_last_TL0;
687
0
      else
688
0
        frame_input->last_source = NULL;
689
0
    }
690
0
  }
691
0
}
692
693
0
int av1_svc_get_min_ref_dist(const AV1_COMP *cpi) {
694
0
  RTC_REF *const rtc_ref = &cpi->ppi->rtc_ref;
695
0
  int min_dist = INT_MAX;
696
0
  const unsigned int current_frame_num =
697
0
      cpi->ppi->use_svc ? cpi->svc.current_superframe
698
0
                        : cpi->common.current_frame.frame_number;
699
0
  for (unsigned int i = 0; i < INTER_REFS_PER_FRAME; i++) {
700
0
    if (rtc_ref->reference[i]) {
701
0
      const int ref_frame_map_idx = rtc_ref->ref_idx[i];
702
0
      const int dist = (1 + current_frame_num) -
703
0
                       rtc_ref->buffer_time_index[ref_frame_map_idx];
704
0
      if (dist < min_dist) min_dist = dist;
705
0
    }
706
0
  }
707
0
  return min_dist;
708
0
}
709
710
0
void av1_svc_set_reference_was_previous(AV1_COMP *cpi) {
711
0
  RTC_REF *const rtc_ref = &cpi->ppi->rtc_ref;
712
  // Check if the encoded frame had some reference that was the
713
  // previous frame.
714
0
  const unsigned int current_frame =
715
0
      cpi->ppi->use_svc ? cpi->svc.current_superframe
716
0
                        : cpi->common.current_frame.frame_number;
717
0
  rtc_ref->reference_was_previous_frame = true;
718
0
  if (current_frame > 0) {
719
0
    rtc_ref->reference_was_previous_frame = false;
720
0
    for (unsigned int i = 0; i < INTER_REFS_PER_FRAME; i++) {
721
0
      if (rtc_ref->reference[i]) {
722
0
        const int ref_frame_map_idx = rtc_ref->ref_idx[i];
723
0
        if (rtc_ref->buffer_time_index[ref_frame_map_idx] == current_frame - 1)
724
0
          rtc_ref->reference_was_previous_frame = true;
725
0
      }
726
0
    }
727
0
  }
728
0
}