Coverage Report

Created: 2026-07-16 06:21

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libavif/ext/aom/av1/encoder/lookahead.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
#include <assert.h>
12
#include <stdlib.h>
13
14
#include "config/aom_config.h"
15
16
#include "aom_scale/yv12config.h"
17
#include "av1/common/common.h"
18
#include "av1/encoder/encoder.h"
19
#include "av1/encoder/extend.h"
20
#include "av1/encoder/lookahead.h"
21
22
/* Return the buffer at the given absolute index and increment the index */
23
280k
static struct lookahead_entry *pop(struct lookahead_ctx *ctx, int *idx) {
24
280k
  int index = *idx;
25
280k
  struct lookahead_entry *buf = ctx->buf + index;
26
27
280k
  assert(index < ctx->max_sz);
28
280k
  if (++index >= ctx->max_sz) index -= ctx->max_sz;
29
280k
  *idx = index;
30
280k
  return buf;
31
280k
}
32
33
91.2k
void av1_lookahead_destroy(struct lookahead_ctx *ctx) {
34
91.2k
  if (ctx) {
35
91.2k
    if (ctx->buf) {
36
91.2k
      int i;
37
38
440k
      for (i = 0; i < ctx->max_sz; i++) aom_free_frame_buffer(&ctx->buf[i].img);
39
91.2k
      free(ctx->buf);
40
91.2k
    }
41
91.2k
    free(ctx);
42
91.2k
  }
43
91.2k
}
44
45
struct lookahead_ctx *av1_lookahead_init(
46
    int width, int height, int subsampling_x, int subsampling_y,
47
    int use_highbitdepth, int depth, int border_in_pixels, int byte_alignment,
48
91.2k
    int num_lap_buffers, bool is_all_intra, bool alloc_pyramid) {
49
91.2k
  int lag_in_frames = AOMMAX(1, depth);
50
51
  // For all-intra frame encoding, previous source frames are not required.
52
  // Hence max_pre_frames is set to 0 in this case. As previous source frames
53
  // are accessed using a negative index to av1_lookahead_peek(), setting
54
  // max_pre_frames to 0 will cause av1_lookahead_peek() to return NULL for a
55
  // negative index.
56
91.2k
  const uint8_t max_pre_frames = is_all_intra ? 0 : MAX_PRE_FRAMES;
57
58
  // Add the lags to depth and clamp
59
91.2k
  depth += num_lap_buffers;
60
91.2k
  depth = clamp(depth, 1, MAX_TOTAL_BUFFERS);
61
62
  // Allocate memory to keep previous source frames available.
63
91.2k
  depth += max_pre_frames;
64
65
  // Allocate the lookahead structures
66
91.2k
  struct lookahead_ctx *ctx = calloc(1, sizeof(*ctx));
67
91.2k
  if (ctx) {
68
91.2k
    ctx->max_sz = depth;
69
91.2k
    ctx->push_frame_count = 0;
70
91.2k
    ctx->max_pre_frames = max_pre_frames;
71
91.2k
    ctx->read_ctxs[ENCODE_STAGE].pop_sz = ctx->max_sz - ctx->max_pre_frames;
72
91.2k
    ctx->read_ctxs[ENCODE_STAGE].valid = 1;
73
91.2k
    if (num_lap_buffers) {
74
6.99k
      ctx->read_ctxs[LAP_STAGE].pop_sz = lag_in_frames;
75
6.99k
      ctx->read_ctxs[LAP_STAGE].valid = 1;
76
6.99k
    }
77
91.2k
    ctx->buf = calloc(depth, sizeof(*ctx->buf));
78
91.2k
    if (!ctx->buf) goto fail;
79
440k
    for (int i = 0; i < depth; i++) {
80
349k
      if (aom_realloc_frame_buffer(
81
349k
              &ctx->buf[i].img, width, height, subsampling_x, subsampling_y,
82
349k
              use_highbitdepth, border_in_pixels, byte_alignment, NULL, NULL,
83
349k
              NULL, alloc_pyramid, 0)) {
84
0
        goto fail;
85
0
      }
86
349k
    }
87
91.2k
  }
88
91.2k
  return ctx;
89
0
fail:
90
0
  av1_lookahead_destroy(ctx);
91
0
  return NULL;
92
91.2k
}
93
94
0
int av1_lookahead_full(const struct lookahead_ctx *ctx) {
95
  // TODO(angiebird): Test this function.
96
0
  return ctx->read_ctxs[ENCODE_STAGE].sz >= ctx->read_ctxs[ENCODE_STAGE].pop_sz;
97
0
}
98
99
int av1_lookahead_push(struct lookahead_ctx *ctx, const YV12_BUFFER_CONFIG *src,
100
                       int64_t ts_start, int64_t ts_end, int use_highbitdepth,
101
130k
                       bool alloc_pyramid, aom_enc_frame_flags_t flags) {
102
130k
  int width = src->y_crop_width;
103
130k
  int height = src->y_crop_height;
104
130k
  int uv_width = src->uv_crop_width;
105
130k
  int uv_height = src->uv_crop_height;
106
130k
  int subsampling_x = src->subsampling_x;
107
130k
  int subsampling_y = src->subsampling_y;
108
130k
  int larger_dimensions, new_dimensions;
109
110
130k
  assert(ctx->read_ctxs[ENCODE_STAGE].valid == 1);
111
130k
  if (ctx->read_ctxs[ENCODE_STAGE].sz + ctx->max_pre_frames > ctx->max_sz)
112
0
    return 1;
113
114
130k
  ctx->read_ctxs[ENCODE_STAGE].sz++;
115
130k
  if (ctx->read_ctxs[LAP_STAGE].valid) {
116
19.9k
    ctx->read_ctxs[LAP_STAGE].sz++;
117
19.9k
  }
118
119
130k
  struct lookahead_entry *buf = pop(ctx, &ctx->write_idx);
120
121
130k
  new_dimensions = width != buf->img.y_crop_width ||
122
130k
                   height != buf->img.y_crop_height ||
123
130k
                   uv_width != buf->img.uv_crop_width ||
124
130k
                   uv_height != buf->img.uv_crop_height;
125
130k
  larger_dimensions =
126
130k
      width > buf->img.y_crop_width || height > buf->img.y_crop_height ||
127
130k
      uv_width > buf->img.uv_crop_width || uv_height > buf->img.uv_crop_height;
128
130k
  assert(!larger_dimensions || new_dimensions);
129
130
130k
  if (larger_dimensions) {
131
0
    YV12_BUFFER_CONFIG new_img;
132
0
    memset(&new_img, 0, sizeof(new_img));
133
0
    if (aom_alloc_frame_buffer(&new_img, width, height, subsampling_x,
134
0
                               subsampling_y, use_highbitdepth,
135
0
                               AOM_BORDER_IN_PIXELS, 0, alloc_pyramid, 0))
136
0
      return 1;
137
0
    aom_free_frame_buffer(&buf->img);
138
0
    buf->img = new_img;
139
130k
  } else if (new_dimensions) {
140
0
    buf->img.y_width = src->y_width;
141
0
    buf->img.y_height = src->y_height;
142
0
    buf->img.uv_width = src->uv_width;
143
0
    buf->img.uv_height = src->uv_height;
144
0
    buf->img.y_crop_width = src->y_crop_width;
145
0
    buf->img.y_crop_height = src->y_crop_height;
146
0
    buf->img.uv_crop_width = src->uv_crop_width;
147
0
    buf->img.uv_crop_height = src->uv_crop_height;
148
0
    buf->img.subsampling_x = src->subsampling_x;
149
0
    buf->img.subsampling_y = src->subsampling_y;
150
0
  }
151
130k
  av1_copy_and_extend_frame(src, &buf->img);
152
153
130k
  buf->ts_start = ts_start;
154
130k
  buf->ts_end = ts_end;
155
130k
  buf->display_idx = ctx->push_frame_count;
156
130k
  buf->flags = flags;
157
130k
  ++ctx->push_frame_count;
158
130k
  aom_remove_metadata_from_frame_buffer(&buf->img);
159
130k
  if (src->metadata &&
160
0
      aom_copy_metadata_to_frame_buffer(&buf->img, src->metadata)) {
161
0
    return 1;
162
0
  }
163
130k
  return 0;
164
130k
}
165
166
struct lookahead_entry *av1_lookahead_pop(struct lookahead_ctx *ctx, int drain,
167
150k
                                          COMPRESSOR_STAGE stage) {
168
150k
  struct lookahead_entry *buf = NULL;
169
150k
  if (ctx) {
170
150k
    struct read_ctx *read_ctx = &ctx->read_ctxs[stage];
171
150k
    assert(read_ctx->valid == 1);
172
150k
    if (read_ctx->sz && (drain || read_ctx->sz == read_ctx->pop_sz)) {
173
150k
      buf = pop(ctx, &read_ctx->read_idx);
174
150k
      read_ctx->sz--;
175
150k
    }
176
150k
  }
177
150k
  return buf;
178
150k
}
179
180
struct lookahead_entry *av1_lookahead_peek(struct lookahead_ctx *ctx, int index,
181
1.01M
                                           COMPRESSOR_STAGE stage) {
182
1.01M
  struct lookahead_entry *buf = NULL;
183
1.01M
  if (ctx == NULL) {
184
0
    return buf;
185
0
  }
186
187
1.01M
  struct read_ctx *read_ctx = &ctx->read_ctxs[stage];
188
1.01M
  assert(read_ctx->valid == 1);
189
1.01M
  if (index >= 0) {
190
    // Forward peek
191
966k
    if (index < read_ctx->sz) {
192
661k
      index += read_ctx->read_idx;
193
661k
      if (index >= ctx->max_sz) index -= ctx->max_sz;
194
661k
      buf = ctx->buf + index;
195
661k
    }
196
966k
  } else if (index < 0) {
197
    // Backward peek
198
51.9k
    if (-index <= ctx->max_pre_frames) {
199
51.9k
      index += (int)(read_ctx->read_idx);
200
51.9k
      if (index < 0) index += (int)(ctx->max_sz);
201
51.9k
      buf = ctx->buf + index;
202
51.9k
    }
203
51.9k
  }
204
205
1.01M
  return buf;
206
1.01M
}
207
208
441k
int av1_lookahead_depth(struct lookahead_ctx *ctx, COMPRESSOR_STAGE stage) {
209
441k
  assert(ctx != NULL);
210
211
441k
  struct read_ctx *read_ctx = &ctx->read_ctxs[stage];
212
441k
  assert(read_ctx->valid == 1);
213
441k
  return read_ctx->sz;
214
441k
}
215
216
428k
int av1_lookahead_pop_sz(struct lookahead_ctx *ctx, COMPRESSOR_STAGE stage) {
217
428k
  assert(ctx != NULL);
218
219
428k
  struct read_ctx *read_ctx = &ctx->read_ctxs[stage];
220
  assert(read_ctx->valid == 1);
221
428k
  return read_ctx->pop_sz;
222
428k
}