Coverage Report

Created: 2025-11-16 07:09

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/aom/av1/av1_dx_iface.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
#include <stdlib.h>
13
#include <string.h>
14
15
#include "config/aom_config.h"
16
#include "config/aom_version.h"
17
18
#include "aom/internal/aom_codec_internal.h"
19
#include "aom/internal/aom_image_internal.h"
20
#include "aom/aomdx.h"
21
#include "aom/aom_decoder.h"
22
#include "aom/aom_image.h"
23
#include "aom_dsp/bitreader_buffer.h"
24
#include "aom_dsp/aom_dsp_common.h"
25
#include "aom_ports/mem.h"
26
#include "aom_ports/mem_ops.h"
27
#include "aom_util/aom_pthread.h"
28
#include "aom_util/aom_thread.h"
29
30
#include "av1/common/alloccommon.h"
31
#include "av1/common/av1_common_int.h"
32
#include "av1/common/frame_buffers.h"
33
#include "av1/common/enums.h"
34
#include "av1/common/obu_util.h"
35
36
#include "av1/decoder/decoder.h"
37
#include "av1/decoder/decodeframe.h"
38
#include "av1/decoder/dthread.h"
39
#include "av1/decoder/grain_synthesis.h"
40
#include "av1/decoder/obu.h"
41
42
#include "av1/av1_iface_common.h"
43
44
struct aom_codec_alg_priv {
45
  aom_codec_priv_t base;
46
  aom_codec_dec_cfg_t cfg;
47
  aom_codec_stream_info_t si;
48
  aom_image_t img;
49
  int img_avail;
50
  int flushed;
51
  int invert_tile_order;
52
  RefCntBuffer *last_show_frame;  // Last output frame buffer
53
  int byte_alignment;
54
  int skip_loop_filter;
55
  int skip_film_grain;
56
  int decode_tile_row;
57
  int decode_tile_col;
58
  unsigned int tile_mode;
59
  unsigned int ext_tile_debug;
60
  unsigned int row_mt;
61
  EXTERNAL_REFERENCES ext_refs;
62
  unsigned int is_annexb;
63
  int operating_point;
64
  int output_all_layers;
65
66
  AVxWorker *frame_worker;
67
68
  aom_image_t image_with_grain;
69
  aom_codec_frame_buffer_t grain_image_frame_buffers[MAX_NUM_SPATIAL_LAYERS];
70
  size_t num_grain_image_frame_buffers;
71
  int need_resync;  // wait for key/intra-only frame
72
  // BufferPool that holds all reference frames. Shared by all the FrameWorkers.
73
  BufferPool *buffer_pool;
74
75
  // External frame buffer info to save for AV1 common.
76
  void *ext_priv;  // Private data associated with the external frame buffers.
77
  aom_get_frame_buffer_cb_fn_t get_ext_fb_cb;
78
  aom_release_frame_buffer_cb_fn_t release_ext_fb_cb;
79
80
#if CONFIG_INSPECTION
81
  aom_inspect_cb inspect_cb;
82
  void *inspect_ctx;
83
#endif
84
};
85
86
15.8k
static aom_codec_err_t decoder_init(aom_codec_ctx_t *ctx) {
87
  // This function only allocates space for the aom_codec_alg_priv_t
88
  // structure. More memory may be required at the time the stream
89
  // information becomes known.
90
15.8k
  if (!ctx->priv) {
91
15.8k
    aom_codec_alg_priv_t *const priv =
92
15.8k
        (aom_codec_alg_priv_t *)aom_calloc(1, sizeof(*priv));
93
15.8k
    if (priv == NULL) return AOM_CODEC_MEM_ERROR;
94
95
15.8k
    ctx->priv = (aom_codec_priv_t *)priv;
96
15.8k
    ctx->priv->init_flags = ctx->init_flags;
97
15.8k
    priv->flushed = 0;
98
99
    // TODO(tdaede): this should not be exposed to the API
100
15.8k
    priv->cfg.allow_lowbitdepth = !FORCE_HIGHBITDEPTH_DECODING;
101
15.8k
    if (ctx->config.dec) {
102
15.8k
      priv->cfg = *ctx->config.dec;
103
15.8k
      ctx->config.dec = &priv->cfg;
104
15.8k
    }
105
15.8k
    priv->num_grain_image_frame_buffers = 0;
106
    // Turn row_mt on by default.
107
15.8k
    priv->row_mt = 1;
108
109
    // Turn on normal tile coding mode by default.
110
    // 0 is for normal tile coding mode, and 1 is for large scale tile coding
111
    // mode(refer to lightfield example).
112
15.8k
    priv->tile_mode = 0;
113
15.8k
    priv->decode_tile_row = -1;
114
15.8k
    priv->decode_tile_col = -1;
115
15.8k
  }
116
117
15.8k
  return AOM_CODEC_OK;
118
15.8k
}
119
120
15.8k
static aom_codec_err_t decoder_destroy(aom_codec_alg_priv_t *ctx) {
121
15.8k
  if (ctx->frame_worker != NULL) {
122
15.8k
    AVxWorker *const worker = ctx->frame_worker;
123
15.8k
    aom_get_worker_interface()->end(worker);
124
15.8k
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
125
15.8k
    if (frame_worker_data != NULL && frame_worker_data->pbi != NULL) {
126
15.8k
      AV1Decoder *const pbi = frame_worker_data->pbi;
127
15.8k
      aom_free(pbi->common.tpl_mvs);
128
15.8k
      pbi->common.tpl_mvs = NULL;
129
15.8k
      av1_remove_common(&pbi->common);
130
15.8k
      av1_free_cdef_buffers(&pbi->common, &pbi->cdef_worker, &pbi->cdef_sync);
131
15.8k
      av1_free_cdef_sync(&pbi->cdef_sync);
132
15.8k
      av1_free_restoration_buffers(&pbi->common);
133
15.8k
      av1_decoder_remove(pbi);
134
15.8k
    }
135
15.8k
    aom_free(frame_worker_data);
136
15.8k
  }
137
138
15.8k
  if (ctx->buffer_pool) {
139
16.1k
    for (size_t i = 0; i < ctx->num_grain_image_frame_buffers; i++) {
140
350
      ctx->buffer_pool->release_fb_cb(ctx->buffer_pool->cb_priv,
141
350
                                      &ctx->grain_image_frame_buffers[i]);
142
350
    }
143
15.8k
    av1_free_ref_frame_buffers(ctx->buffer_pool);
144
15.8k
    av1_free_internal_frame_buffers(&ctx->buffer_pool->int_frame_buffers);
145
15.8k
#if CONFIG_MULTITHREAD
146
15.8k
    pthread_mutex_destroy(&ctx->buffer_pool->pool_mutex);
147
15.8k
#endif
148
15.8k
  }
149
150
15.8k
  aom_free(ctx->frame_worker);
151
15.8k
  aom_free(ctx->buffer_pool);
152
15.8k
  assert(!ctx->img.self_allocd);
153
15.8k
  aom_img_free(&ctx->img);
154
15.8k
  aom_free(ctx);
155
15.8k
  return AOM_CODEC_OK;
156
15.8k
}
157
158
17.8k
static aom_codec_err_t parse_timing_info(struct aom_read_bit_buffer *rb) {
159
17.8k
  const uint32_t num_units_in_display_tick =
160
17.8k
      aom_rb_read_unsigned_literal(rb, 32);
161
17.8k
  const uint32_t time_scale = aom_rb_read_unsigned_literal(rb, 32);
162
17.8k
  if (num_units_in_display_tick == 0 || time_scale == 0)
163
549
    return AOM_CODEC_UNSUP_BITSTREAM;
164
17.2k
  const uint8_t equal_picture_interval = aom_rb_read_bit(rb);
165
17.2k
  if (equal_picture_interval) {
166
8.76k
    const uint32_t num_ticks_per_picture_minus_1 = aom_rb_read_uvlc(rb);
167
8.76k
    if (num_ticks_per_picture_minus_1 == UINT32_MAX) {
168
      // num_ticks_per_picture_minus_1 cannot be (1 << 32) - 1.
169
172
      return AOM_CODEC_UNSUP_BITSTREAM;
170
172
    }
171
8.76k
  }
172
17.0k
  return AOM_CODEC_OK;
173
17.2k
}
174
175
static aom_codec_err_t parse_decoder_model_info(
176
8.23k
    struct aom_read_bit_buffer *rb, int *buffer_delay_length_minus_1) {
177
8.23k
  *buffer_delay_length_minus_1 = aom_rb_read_literal(rb, 5);
178
8.23k
  const uint32_t num_units_in_decoding_tick =
179
8.23k
      aom_rb_read_unsigned_literal(rb, 32);
180
8.23k
  const uint8_t buffer_removal_time_length_minus_1 = aom_rb_read_literal(rb, 5);
181
8.23k
  const uint8_t frame_presentation_time_length_minus_1 =
182
8.23k
      aom_rb_read_literal(rb, 5);
183
8.23k
  (void)num_units_in_decoding_tick;
184
8.23k
  (void)buffer_removal_time_length_minus_1;
185
8.23k
  (void)frame_presentation_time_length_minus_1;
186
8.23k
  return AOM_CODEC_OK;
187
8.23k
}
188
189
static aom_codec_err_t parse_op_parameters_info(
190
23.3k
    struct aom_read_bit_buffer *rb, int buffer_delay_length_minus_1) {
191
23.3k
  const int n = buffer_delay_length_minus_1 + 1;
192
23.3k
  const uint32_t decoder_buffer_delay = aom_rb_read_unsigned_literal(rb, n);
193
23.3k
  const uint32_t encoder_buffer_delay = aom_rb_read_unsigned_literal(rb, n);
194
23.3k
  const uint8_t low_delay_mode_flag = aom_rb_read_bit(rb);
195
23.3k
  (void)decoder_buffer_delay;
196
23.3k
  (void)encoder_buffer_delay;
197
23.3k
  (void)low_delay_mode_flag;
198
23.3k
  return AOM_CODEC_OK;
199
23.3k
}
200
201
// Parses the operating points (including operating_point_idc, seq_level_idx,
202
// and seq_tier) and then sets si->number_spatial_layers and
203
// si->number_temporal_layers based on operating_point_idc[0].
204
static aom_codec_err_t parse_operating_points(struct aom_read_bit_buffer *rb,
205
                                              int is_reduced_header,
206
97.5k
                                              aom_codec_stream_info_t *si) {
207
97.5k
  int operating_point_idc0 = 0;
208
97.5k
  if (is_reduced_header) {
209
15.4k
    aom_rb_read_literal(rb, LEVEL_BITS);  // level
210
82.0k
  } else {
211
82.0k
    uint8_t decoder_model_info_present_flag = 0;
212
82.0k
    int buffer_delay_length_minus_1 = 0;
213
82.0k
    aom_codec_err_t status;
214
82.0k
    const uint8_t timing_info_present_flag = aom_rb_read_bit(rb);
215
82.0k
    if (timing_info_present_flag) {
216
17.8k
      if ((status = parse_timing_info(rb)) != AOM_CODEC_OK) return status;
217
17.0k
      decoder_model_info_present_flag = aom_rb_read_bit(rb);
218
17.0k
      if (decoder_model_info_present_flag) {
219
8.23k
        if ((status = parse_decoder_model_info(
220
8.23k
                 rb, &buffer_delay_length_minus_1)) != AOM_CODEC_OK)
221
0
          return status;
222
8.23k
      }
223
17.0k
    }
224
81.3k
    const uint8_t initial_display_delay_present_flag = aom_rb_read_bit(rb);
225
81.3k
    const uint8_t operating_points_cnt_minus_1 =
226
81.3k
        aom_rb_read_literal(rb, OP_POINTS_CNT_MINUS_1_BITS);
227
427k
    for (int i = 0; i < operating_points_cnt_minus_1 + 1; i++) {
228
346k
      int operating_point_idc;
229
346k
      operating_point_idc = aom_rb_read_literal(rb, OP_POINTS_IDC_BITS);
230
346k
      if (i == 0) operating_point_idc0 = operating_point_idc;
231
346k
      int seq_level_idx = aom_rb_read_literal(rb, LEVEL_BITS);  // level
232
346k
      if (seq_level_idx > 7) aom_rb_read_bit(rb);               // tier
233
346k
      if (decoder_model_info_present_flag) {
234
66.4k
        const uint8_t decoder_model_present_for_this_op = aom_rb_read_bit(rb);
235
66.4k
        if (decoder_model_present_for_this_op) {
236
23.3k
          if ((status = parse_op_parameters_info(
237
23.3k
                   rb, buffer_delay_length_minus_1)) != AOM_CODEC_OK)
238
0
            return status;
239
23.3k
        }
240
66.4k
      }
241
346k
      if (initial_display_delay_present_flag) {
242
243k
        const uint8_t initial_display_delay_present_for_this_op =
243
243k
            aom_rb_read_bit(rb);
244
243k
        if (initial_display_delay_present_for_this_op)
245
110k
          aom_rb_read_literal(rb, 4);  // initial_display_delay_minus_1
246
243k
      }
247
346k
    }
248
81.3k
  }
249
250
96.8k
  if (aom_get_num_layers_from_operating_point_idc(
251
96.8k
          operating_point_idc0, &si->number_spatial_layers,
252
96.8k
          &si->number_temporal_layers) != AOM_CODEC_OK) {
253
0
    return AOM_CODEC_ERROR;
254
0
  }
255
256
96.8k
  return AOM_CODEC_OK;
257
96.8k
}
258
259
static aom_codec_err_t decoder_peek_si_internal(const uint8_t *data,
260
                                                size_t data_sz,
261
                                                aom_codec_stream_info_t *si,
262
312k
                                                int *is_intra_only) {
263
312k
  int intra_only_flag = 0;
264
312k
  int got_sequence_header = 0;
265
312k
  int found_keyframe = 0;
266
267
312k
  if (data + data_sz <= data || data_sz < 1) return AOM_CODEC_INVALID_PARAM;
268
269
311k
  si->w = 0;
270
311k
  si->h = 0;
271
311k
  si->is_kf = 0;  // is_kf indicates whether the current packet contains a RAP
272
273
311k
  ObuHeader obu_header;
274
311k
  memset(&obu_header, 0, sizeof(obu_header));
275
311k
  size_t payload_size = 0;
276
311k
  size_t bytes_read = 0;
277
311k
  uint8_t reduced_still_picture_hdr = 0;
278
311k
  aom_codec_err_t status = aom_read_obu_header_and_size(
279
311k
      data, data_sz, si->is_annexb, &obu_header, &payload_size, &bytes_read);
280
311k
  if (status != AOM_CODEC_OK) return status;
281
282
  // If the first OBU is a temporal delimiter, skip over it and look at the next
283
  // OBU in the bitstream
284
230k
  if (obu_header.type == OBU_TEMPORAL_DELIMITER) {
285
    // Skip any associated payload (there shouldn't be one, but just in case)
286
105k
    if (data_sz < bytes_read + payload_size) return AOM_CODEC_CORRUPT_FRAME;
287
104k
    data += bytes_read + payload_size;
288
104k
    data_sz -= bytes_read + payload_size;
289
290
104k
    status = aom_read_obu_header_and_size(
291
104k
        data, data_sz, si->is_annexb, &obu_header, &payload_size, &bytes_read);
292
104k
    if (status != AOM_CODEC_OK) return status;
293
104k
  }
294
441k
  while (1) {
295
441k
    data += bytes_read;
296
441k
    data_sz -= bytes_read;
297
441k
    if (data_sz < payload_size) return AOM_CODEC_CORRUPT_FRAME;
298
    // Check that the selected OBU is a sequence header
299
437k
    if (obu_header.type == OBU_SEQUENCE_HEADER) {
300
      // Sanity check on sequence header size
301
98.2k
      if (data_sz < 2) return AOM_CODEC_CORRUPT_FRAME;
302
      // Read a few values from the sequence header payload
303
97.7k
      struct aom_read_bit_buffer rb = { data, data + data_sz, 0, NULL, NULL };
304
305
97.7k
      av1_read_profile(&rb);  // profile
306
97.7k
      const uint8_t still_picture = aom_rb_read_bit(&rb);
307
97.7k
      reduced_still_picture_hdr = aom_rb_read_bit(&rb);
308
309
97.7k
      if (!still_picture && reduced_still_picture_hdr) {
310
236
        return AOM_CODEC_UNSUP_BITSTREAM;
311
236
      }
312
313
97.5k
      status = parse_operating_points(&rb, reduced_still_picture_hdr, si);
314
97.5k
      if (status != AOM_CODEC_OK) return status;
315
316
96.8k
      int num_bits_width = aom_rb_read_literal(&rb, 4) + 1;
317
96.8k
      int num_bits_height = aom_rb_read_literal(&rb, 4) + 1;
318
96.8k
      int max_frame_width = aom_rb_read_literal(&rb, num_bits_width) + 1;
319
96.8k
      int max_frame_height = aom_rb_read_literal(&rb, num_bits_height) + 1;
320
96.8k
      si->w = max_frame_width;
321
96.8k
      si->h = max_frame_height;
322
96.8k
      got_sequence_header = 1;
323
339k
    } else if (obu_header.type == OBU_FRAME_HEADER ||
324
337k
               obu_header.type == OBU_FRAME) {
325
208k
      if (got_sequence_header && reduced_still_picture_hdr) {
326
12.4k
        found_keyframe = 1;
327
12.4k
        break;
328
196k
      } else {
329
        // make sure we have enough bits to get the frame type out
330
196k
        if (data_sz < 1) return AOM_CODEC_CORRUPT_FRAME;
331
195k
        struct aom_read_bit_buffer rb = { data, data + data_sz, 0, NULL, NULL };
332
195k
        const int show_existing_frame = aom_rb_read_bit(&rb);
333
195k
        if (!show_existing_frame) {
334
192k
          const FRAME_TYPE frame_type = (FRAME_TYPE)aom_rb_read_literal(&rb, 2);
335
192k
          if (frame_type == KEY_FRAME) {
336
70.2k
            found_keyframe = 1;
337
70.2k
            break;  // Stop here as no further OBUs will change the outcome.
338
121k
          } else if (frame_type == INTRA_ONLY_FRAME) {
339
31.3k
            intra_only_flag = 1;
340
31.3k
          }
341
192k
        }
342
195k
      }
343
208k
    }
344
    // skip past any unread OBU header data
345
352k
    data += payload_size;
346
352k
    data_sz -= payload_size;
347
352k
    if (data_sz == 0) break;  // exit if we're out of OBUs
348
351k
    status = aom_read_obu_header_and_size(
349
351k
        data, data_sz, si->is_annexb, &obu_header, &payload_size, &bytes_read);
350
351k
    if (status != AOM_CODEC_OK) return status;
351
351k
  }
352
84.5k
  if (got_sequence_header && found_keyframe) si->is_kf = 1;
353
84.5k
  if (is_intra_only != NULL) *is_intra_only = intra_only_flag;
354
84.5k
  return AOM_CODEC_OK;
355
220k
}
356
357
static aom_codec_err_t decoder_peek_si(const uint8_t *data, size_t data_sz,
358
284k
                                       aom_codec_stream_info_t *si) {
359
284k
  return decoder_peek_si_internal(data, data_sz, si, NULL);
360
284k
}
361
362
static aom_codec_err_t decoder_get_si(aom_codec_alg_priv_t *ctx,
363
0
                                      aom_codec_stream_info_t *si) {
364
0
  *si = ctx->si;
365
366
0
  return AOM_CODEC_OK;
367
0
}
368
369
static void set_error_detail(aom_codec_alg_priv_t *ctx,
370
160k
                             const char *const error) {
371
160k
  ctx->base.err_detail = error;
372
160k
}
373
374
static aom_codec_err_t update_error_state(
375
160k
    aom_codec_alg_priv_t *ctx, const struct aom_internal_error_info *error) {
376
160k
  if (error->error_code)
377
160k
    set_error_detail(ctx, error->has_detail ? error->detail : NULL);
378
379
160k
  return error->error_code;
380
160k
}
381
382
15.8k
static void init_buffer_callbacks(aom_codec_alg_priv_t *ctx) {
383
15.8k
  AVxWorker *const worker = ctx->frame_worker;
384
15.8k
  FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
385
15.8k
  AV1Decoder *const pbi = frame_worker_data->pbi;
386
15.8k
  AV1_COMMON *const cm = &pbi->common;
387
15.8k
  BufferPool *const pool = cm->buffer_pool;
388
389
15.8k
  cm->cur_frame = NULL;
390
15.8k
  cm->features.byte_alignment = ctx->byte_alignment;
391
15.8k
  pbi->skip_loop_filter = ctx->skip_loop_filter;
392
15.8k
  pbi->skip_film_grain = ctx->skip_film_grain;
393
394
15.8k
  if (ctx->get_ext_fb_cb != NULL && ctx->release_ext_fb_cb != NULL) {
395
0
    pool->get_fb_cb = ctx->get_ext_fb_cb;
396
0
    pool->release_fb_cb = ctx->release_ext_fb_cb;
397
0
    pool->cb_priv = ctx->ext_priv;
398
15.8k
  } else {
399
15.8k
    pool->get_fb_cb = av1_get_frame_buffer;
400
15.8k
    pool->release_fb_cb = av1_release_frame_buffer;
401
402
15.8k
    if (av1_alloc_internal_frame_buffers(&pool->int_frame_buffers))
403
0
      aom_internal_error(&pbi->error, AOM_CODEC_MEM_ERROR,
404
0
                         "Failed to initialize internal frame buffers");
405
406
15.8k
    pool->cb_priv = &pool->int_frame_buffers;
407
15.8k
  }
408
15.8k
}
409
410
250k
static int frame_worker_hook(void *arg1, void *arg2) {
411
250k
  FrameWorkerData *const frame_worker_data = (FrameWorkerData *)arg1;
412
250k
  const uint8_t *data = frame_worker_data->data;
413
250k
  (void)arg2;
414
415
250k
  int result = av1_receive_compressed_data(frame_worker_data->pbi,
416
250k
                                           frame_worker_data->data_size, &data);
417
250k
  frame_worker_data->data_end = data;
418
419
250k
  if (result != 0) {
420
    // Check decode result in serial decode.
421
160k
    frame_worker_data->pbi->need_resync = 1;
422
160k
  }
423
250k
  return !result;
424
250k
}
425
426
15.8k
static aom_codec_err_t init_decoder(aom_codec_alg_priv_t *ctx) {
427
15.8k
  const AVxWorkerInterface *const winterface = aom_get_worker_interface();
428
429
15.8k
  ctx->last_show_frame = NULL;
430
15.8k
  ctx->need_resync = 1;
431
15.8k
  ctx->flushed = 0;
432
433
15.8k
  ctx->buffer_pool = (BufferPool *)aom_calloc(1, sizeof(BufferPool));
434
15.8k
  if (ctx->buffer_pool == NULL) return AOM_CODEC_MEM_ERROR;
435
15.8k
  ctx->buffer_pool->num_frame_bufs = FRAME_BUFFERS;
436
15.8k
  ctx->buffer_pool->frame_bufs = (RefCntBuffer *)aom_calloc(
437
15.8k
      ctx->buffer_pool->num_frame_bufs, sizeof(*ctx->buffer_pool->frame_bufs));
438
15.8k
  if (ctx->buffer_pool->frame_bufs == NULL) {
439
0
    ctx->buffer_pool->num_frame_bufs = 0;
440
0
    aom_free(ctx->buffer_pool);
441
0
    ctx->buffer_pool = NULL;
442
0
    return AOM_CODEC_MEM_ERROR;
443
0
  }
444
445
15.8k
#if CONFIG_MULTITHREAD
446
15.8k
  if (pthread_mutex_init(&ctx->buffer_pool->pool_mutex, NULL)) {
447
0
    aom_free(ctx->buffer_pool->frame_bufs);
448
0
    ctx->buffer_pool->frame_bufs = NULL;
449
0
    ctx->buffer_pool->num_frame_bufs = 0;
450
0
    aom_free(ctx->buffer_pool);
451
0
    ctx->buffer_pool = NULL;
452
0
    set_error_detail(ctx, "Failed to allocate buffer pool mutex");
453
0
    return AOM_CODEC_MEM_ERROR;
454
0
  }
455
15.8k
#endif
456
457
15.8k
  ctx->frame_worker = (AVxWorker *)aom_malloc(sizeof(*ctx->frame_worker));
458
15.8k
  if (ctx->frame_worker == NULL) {
459
0
    set_error_detail(ctx, "Failed to allocate frame_worker");
460
0
    return AOM_CODEC_MEM_ERROR;
461
0
  }
462
463
15.8k
  AVxWorker *const worker = ctx->frame_worker;
464
15.8k
  winterface->init(worker);
465
15.8k
  worker->thread_name = "aom frameworker";
466
15.8k
  worker->data1 = aom_memalign(32, sizeof(FrameWorkerData));
467
15.8k
  if (worker->data1 == NULL) {
468
0
    winterface->end(worker);
469
0
    aom_free(worker);
470
0
    ctx->frame_worker = NULL;
471
0
    set_error_detail(ctx, "Failed to allocate frame_worker_data");
472
0
    return AOM_CODEC_MEM_ERROR;
473
0
  }
474
15.8k
  FrameWorkerData *frame_worker_data = (FrameWorkerData *)worker->data1;
475
15.8k
  frame_worker_data->pbi = av1_decoder_create(ctx->buffer_pool);
476
15.8k
  if (frame_worker_data->pbi == NULL) {
477
0
    winterface->end(worker);
478
0
    aom_free(frame_worker_data);
479
0
    aom_free(worker);
480
0
    ctx->frame_worker = NULL;
481
0
    set_error_detail(ctx, "Failed to allocate frame_worker_data->pbi");
482
0
    return AOM_CODEC_MEM_ERROR;
483
0
  }
484
15.8k
  frame_worker_data->frame_context_ready = 0;
485
15.8k
  frame_worker_data->received_frame = 0;
486
15.8k
  frame_worker_data->pbi->allow_lowbitdepth = ctx->cfg.allow_lowbitdepth;
487
488
  // If decoding in serial mode, FrameWorker thread could create tile worker
489
  // thread or loopfilter thread.
490
15.8k
  frame_worker_data->pbi->max_threads = ctx->cfg.threads;
491
15.8k
  frame_worker_data->pbi->inv_tile_order = ctx->invert_tile_order;
492
15.8k
  frame_worker_data->pbi->common.tiles.large_scale = ctx->tile_mode;
493
15.8k
  frame_worker_data->pbi->is_annexb = ctx->is_annexb;
494
15.8k
  frame_worker_data->pbi->dec_tile_row = ctx->decode_tile_row;
495
15.8k
  frame_worker_data->pbi->dec_tile_col = ctx->decode_tile_col;
496
15.8k
  frame_worker_data->pbi->operating_point = ctx->operating_point;
497
15.8k
  frame_worker_data->pbi->output_all_layers = ctx->output_all_layers;
498
15.8k
  frame_worker_data->pbi->ext_tile_debug = ctx->ext_tile_debug;
499
15.8k
  frame_worker_data->pbi->row_mt = ctx->row_mt;
500
15.8k
  frame_worker_data->pbi->is_fwd_kf_present = 0;
501
15.8k
  frame_worker_data->pbi->is_arf_frame_present = 0;
502
15.8k
  worker->hook = frame_worker_hook;
503
504
15.8k
  init_buffer_callbacks(ctx);
505
506
15.8k
  return AOM_CODEC_OK;
507
15.8k
}
508
509
static inline void check_resync(aom_codec_alg_priv_t *const ctx,
510
139k
                                const AV1Decoder *const pbi) {
511
  // Clear resync flag if worker got a key frame or intra only frame.
512
139k
  if (ctx->need_resync == 1 && pbi->need_resync == 0 &&
513
38.4k
      frame_is_intra_only(&pbi->common))
514
38.4k
    ctx->need_resync = 0;
515
139k
}
516
517
static aom_codec_err_t decode_one(aom_codec_alg_priv_t *ctx,
518
                                  const uint8_t **data, size_t data_sz,
519
263k
                                  void *user_priv) {
520
263k
  const AVxWorkerInterface *const winterface = aom_get_worker_interface();
521
522
  // Determine the stream parameters. Note that we rely on peek_si to
523
  // validate that we have a buffer that does not wrap around the top
524
  // of the heap.
525
263k
  if (!ctx->si.h) {
526
27.6k
    int is_intra_only = 0;
527
27.6k
    ctx->si.is_annexb = ctx->is_annexb;
528
27.6k
    const aom_codec_err_t res =
529
27.6k
        decoder_peek_si_internal(*data, data_sz, &ctx->si, &is_intra_only);
530
27.6k
    if (res != AOM_CODEC_OK) return res;
531
532
15.7k
    if (!ctx->si.is_kf && !is_intra_only) return AOM_CODEC_ERROR;
533
15.7k
  }
534
535
250k
  AVxWorker *const worker = ctx->frame_worker;
536
250k
  FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
537
250k
  frame_worker_data->data = *data;
538
250k
  frame_worker_data->data_size = data_sz;
539
250k
  frame_worker_data->user_priv = user_priv;
540
250k
  frame_worker_data->received_frame = 1;
541
542
250k
  frame_worker_data->pbi->common.tiles.large_scale = ctx->tile_mode;
543
250k
  frame_worker_data->pbi->dec_tile_row = ctx->decode_tile_row;
544
250k
  frame_worker_data->pbi->dec_tile_col = ctx->decode_tile_col;
545
250k
  frame_worker_data->pbi->ext_tile_debug = ctx->ext_tile_debug;
546
250k
  frame_worker_data->pbi->row_mt = ctx->row_mt;
547
250k
  frame_worker_data->pbi->ext_refs = ctx->ext_refs;
548
549
250k
  frame_worker_data->pbi->is_annexb = ctx->is_annexb;
550
551
250k
  worker->had_error = 0;
552
250k
  winterface->execute(worker);
553
554
  // Update data pointer after decode.
555
250k
  *data = frame_worker_data->data_end;
556
557
250k
  if (worker->had_error)
558
160k
    return update_error_state(ctx, &frame_worker_data->pbi->error);
559
560
90.0k
  check_resync(ctx, frame_worker_data->pbi);
561
562
90.0k
  return AOM_CODEC_OK;
563
250k
}
564
565
284k
static void release_pending_output_frames(aom_codec_alg_priv_t *ctx) {
566
  // Release any pending output frames from the previous decoder_decode or
567
  // decoder_inspect call. We need to do this even if the decoder is being
568
  // flushed or the input arguments are invalid.
569
284k
  if (ctx->frame_worker) {
570
265k
    BufferPool *const pool = ctx->buffer_pool;
571
265k
    lock_buffer_pool(pool);
572
265k
    AVxWorker *const worker = ctx->frame_worker;
573
265k
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
574
265k
    struct AV1Decoder *pbi = frame_worker_data->pbi;
575
315k
    for (size_t j = 0; j < pbi->num_output_frames; j++) {
576
49.9k
      decrease_ref_count(pbi->output_frames[j], pool);
577
49.9k
    }
578
265k
    pbi->num_output_frames = 0;
579
265k
    unlock_buffer_pool(pool);
580
277k
    for (size_t j = 0; j < ctx->num_grain_image_frame_buffers; j++) {
581
12.2k
      pool->release_fb_cb(pool->cb_priv, &ctx->grain_image_frame_buffers[j]);
582
12.2k
      ctx->grain_image_frame_buffers[j].data = NULL;
583
12.2k
      ctx->grain_image_frame_buffers[j].size = 0;
584
12.2k
      ctx->grain_image_frame_buffers[j].priv = NULL;
585
12.2k
    }
586
265k
    ctx->num_grain_image_frame_buffers = 0;
587
265k
  }
588
284k
}
589
590
// This function enables the inspector to inspect non visible frames.
591
static aom_codec_err_t decoder_inspect(aom_codec_alg_priv_t *ctx,
592
                                       const uint8_t *data, size_t data_sz,
593
0
                                       void *user_priv) {
594
0
  aom_codec_err_t res = AOM_CODEC_OK;
595
596
0
  release_pending_output_frames(ctx);
597
598
  /* Sanity checks */
599
  /* NULL data ptr allowed if data_sz is 0 too */
600
0
  if (data == NULL && data_sz == 0) {
601
0
    ctx->flushed = 1;
602
0
    return AOM_CODEC_OK;
603
0
  }
604
0
  if (data == NULL || data_sz == 0) return AOM_CODEC_INVALID_PARAM;
605
606
  // Reset flushed when receiving a valid frame.
607
0
  ctx->flushed = 0;
608
609
0
  const uint8_t *data_start = data;
610
0
  const uint8_t *data_end = data + data_sz;
611
612
0
  uint64_t frame_size;
613
0
  if (ctx->is_annexb) {
614
    // read the size of this temporal unit
615
0
    size_t length_of_size;
616
0
    uint64_t temporal_unit_size;
617
0
    if (aom_uleb_decode(data_start, data_sz, &temporal_unit_size,
618
0
                        &length_of_size) != 0) {
619
0
      return AOM_CODEC_CORRUPT_FRAME;
620
0
    }
621
0
    data_start += length_of_size;
622
0
    if (temporal_unit_size > (size_t)(data_end - data_start))
623
0
      return AOM_CODEC_CORRUPT_FRAME;
624
0
    data_end = data_start + temporal_unit_size;
625
626
    // read the size of this frame unit
627
0
    if (aom_uleb_decode(data_start, (size_t)(data_end - data_start),
628
0
                        &frame_size, &length_of_size) != 0) {
629
0
      return AOM_CODEC_CORRUPT_FRAME;
630
0
    }
631
0
    data_start += length_of_size;
632
0
    if (frame_size > (size_t)(data_end - data_start))
633
0
      return AOM_CODEC_CORRUPT_FRAME;
634
0
  } else {
635
0
    frame_size = (uint64_t)(data_end - data_start);
636
0
  }
637
638
0
  if (ctx->frame_worker == NULL) {
639
0
    res = init_decoder(ctx);
640
0
    if (res != AOM_CODEC_OK) return res;
641
0
  }
642
0
  FrameWorkerData *const frame_worker_data =
643
0
      (FrameWorkerData *)ctx->frame_worker->data1;
644
0
  AV1Decoder *const pbi = frame_worker_data->pbi;
645
0
  AV1_COMMON *const cm = &pbi->common;
646
#if CONFIG_INSPECTION
647
  frame_worker_data->pbi->inspect_cb = ctx->inspect_cb;
648
  frame_worker_data->pbi->inspect_ctx = ctx->inspect_ctx;
649
#endif
650
0
  res = av1_receive_compressed_data(frame_worker_data->pbi, (size_t)frame_size,
651
0
                                    &data_start);
652
0
  check_resync(ctx, frame_worker_data->pbi);
653
654
0
  if (ctx->frame_worker->had_error)
655
0
    return update_error_state(ctx, &frame_worker_data->pbi->error);
656
657
  // Allow extra zero bytes after the frame end
658
0
  while (data_start < data_end) {
659
0
    const uint8_t marker = data_start[0];
660
0
    if (marker) break;
661
0
    ++data_start;
662
0
  }
663
664
0
  Av1DecodeReturn *data2 = (Av1DecodeReturn *)user_priv;
665
0
  data2->idx = -1;
666
0
  if (cm->cur_frame) {
667
0
    for (int i = 0; i < REF_FRAMES; ++i)
668
0
      if (cm->ref_frame_map[i] == cm->cur_frame) data2->idx = i;
669
0
  }
670
0
  data2->buf = data_start;
671
0
  data2->show_existing = cm->show_existing_frame;
672
0
  return res;
673
0
}
674
675
static aom_codec_err_t decoder_decode(aom_codec_alg_priv_t *ctx,
676
                                      const uint8_t *data, size_t data_sz,
677
284k
                                      void *user_priv) {
678
284k
  aom_codec_err_t res = AOM_CODEC_OK;
679
680
#if CONFIG_INSPECTION
681
  if (user_priv != 0) {
682
    return decoder_inspect(ctx, data, data_sz, user_priv);
683
  }
684
#endif
685
686
284k
  release_pending_output_frames(ctx);
687
688
  /* Sanity checks */
689
  /* NULL data ptr allowed if data_sz is 0 too */
690
284k
  if (data == NULL && data_sz == 0) {
691
0
    ctx->flushed = 1;
692
0
    return AOM_CODEC_OK;
693
0
  }
694
284k
  if (data == NULL || data_sz == 0) return AOM_CODEC_INVALID_PARAM;
695
696
  // Reset flushed when receiving a valid frame.
697
228k
  ctx->flushed = 0;
698
699
  // Initialize the decoder worker on the first frame.
700
228k
  if (ctx->frame_worker == NULL) {
701
15.8k
    res = init_decoder(ctx);
702
15.8k
    if (res != AOM_CODEC_OK) return res;
703
15.8k
  }
704
705
228k
  const uint8_t *data_start = data;
706
228k
  const uint8_t *data_end = data + data_sz;
707
708
228k
  if (ctx->is_annexb) {
709
    // read the size of this temporal unit
710
6.70k
    size_t length_of_size;
711
6.70k
    uint64_t temporal_unit_size;
712
6.70k
    if (aom_uleb_decode(data_start, data_sz, &temporal_unit_size,
713
6.70k
                        &length_of_size) != 0) {
714
224
      return AOM_CODEC_CORRUPT_FRAME;
715
224
    }
716
6.47k
    data_start += length_of_size;
717
6.47k
    if (temporal_unit_size > (size_t)(data_end - data_start))
718
2.61k
      return AOM_CODEC_CORRUPT_FRAME;
719
3.86k
    data_end = data_start + temporal_unit_size;
720
3.86k
  }
721
722
  // Decode in serial mode.
723
315k
  while (data_start < data_end) {
724
264k
    uint64_t frame_size;
725
264k
    if (ctx->is_annexb) {
726
      // read the size of this frame unit
727
2.62k
      size_t length_of_size;
728
2.62k
      if (aom_uleb_decode(data_start, (size_t)(data_end - data_start),
729
2.62k
                          &frame_size, &length_of_size) != 0) {
730
129
        return AOM_CODEC_CORRUPT_FRAME;
731
129
      }
732
2.49k
      data_start += length_of_size;
733
2.49k
      if (frame_size > (size_t)(data_end - data_start))
734
857
        return AOM_CODEC_CORRUPT_FRAME;
735
261k
    } else {
736
261k
      frame_size = (uint64_t)(data_end - data_start);
737
261k
    }
738
739
263k
    res = decode_one(ctx, &data_start, (size_t)frame_size, user_priv);
740
263k
    if (res != AOM_CODEC_OK) return res;
741
742
    // Allow extra zero bytes after the frame end
743
172k
    while (data_start < data_end) {
744
122k
      const uint8_t marker = data_start[0];
745
122k
      if (marker) break;
746
82.1k
      ++data_start;
747
82.1k
    }
748
90.0k
  }
749
750
50.9k
  return res;
751
225k
}
752
753
typedef struct {
754
  BufferPool *pool;
755
  aom_codec_frame_buffer_t *fb;
756
} AllocCbParam;
757
758
12.6k
static void *AllocWithGetFrameBufferCb(void *priv, size_t size) {
759
12.6k
  AllocCbParam *param = (AllocCbParam *)priv;
760
12.6k
  if (param->pool->get_fb_cb(param->pool->cb_priv, size, param->fb) < 0)
761
0
    return NULL;
762
12.6k
  if (param->fb->data == NULL || param->fb->size < size) return NULL;
763
12.6k
  return param->fb->data;
764
12.6k
}
765
766
// If grain_params->apply_grain is false, returns img. Otherwise, adds film
767
// grain to img, saves the result in grain_img, and returns grain_img.
768
static aom_image_t *add_grain_if_needed(aom_codec_alg_priv_t *ctx,
769
                                        aom_image_t *img,
770
                                        aom_image_t *grain_img,
771
44.0k
                                        aom_film_grain_t *grain_params) {
772
44.0k
  if (!grain_params->apply_grain) return img;
773
774
12.6k
  const int w_even = ALIGN_POWER_OF_TWO_UNSIGNED(img->d_w, 1);
775
12.6k
  const int h_even = ALIGN_POWER_OF_TWO_UNSIGNED(img->d_h, 1);
776
777
12.6k
  BufferPool *const pool = ctx->buffer_pool;
778
12.6k
  aom_codec_frame_buffer_t *fb =
779
12.6k
      &ctx->grain_image_frame_buffers[ctx->num_grain_image_frame_buffers];
780
12.6k
  AllocCbParam param;
781
12.6k
  param.pool = pool;
782
12.6k
  param.fb = fb;
783
12.6k
  if (!aom_img_alloc_with_cb(grain_img, img->fmt, w_even, h_even, 16,
784
12.6k
                             AllocWithGetFrameBufferCb, &param)) {
785
0
    return NULL;
786
0
  }
787
788
12.6k
  grain_img->user_priv = img->user_priv;
789
12.6k
  grain_img->fb_priv = fb->priv;
790
12.6k
  if (av1_add_film_grain(grain_params, img, grain_img)) {
791
0
    pool->release_fb_cb(pool->cb_priv, fb);
792
0
    return NULL;
793
0
  }
794
795
12.6k
  ctx->num_grain_image_frame_buffers++;
796
12.6k
  return grain_img;
797
12.6k
}
798
799
// Copies and clears the metadata from AV1Decoder.
800
54.2k
static void move_decoder_metadata_to_img(AV1Decoder *pbi, aom_image_t *img) {
801
54.2k
  if (pbi->metadata && img) {
802
65
    assert(!img->metadata);
803
65
    img->metadata = pbi->metadata;
804
65
    pbi->metadata = NULL;
805
65
  }
806
54.2k
}
807
808
static aom_image_t *decoder_get_frame(aom_codec_alg_priv_t *ctx,
809
333k
                                      aom_codec_iter_t *iter) {
810
333k
  aom_image_t *img = NULL;
811
812
333k
  if (!iter) {
813
0
    return NULL;
814
0
  }
815
816
  // To avoid having to allocate any extra storage, treat 'iter' as
817
  // simply a pointer to an integer index
818
333k
  uintptr_t *index = (uintptr_t *)iter;
819
820
333k
  if (ctx->frame_worker == NULL) {
821
3.08k
    return NULL;
822
3.08k
  }
823
330k
  const AVxWorkerInterface *const winterface = aom_get_worker_interface();
824
330k
  AVxWorker *const worker = ctx->frame_worker;
825
330k
  FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
826
330k
  AV1Decoder *const pbi = frame_worker_data->pbi;
827
330k
  pbi->error.error_code = AOM_CODEC_OK;
828
330k
  pbi->error.has_detail = 0;
829
330k
  AV1_COMMON *const cm = &pbi->common;
830
330k
  CommonTileParams *const tiles = &cm->tiles;
831
  // Wait for the frame from worker thread.
832
330k
  if (!winterface->sync(worker)) {
833
    // Decoding failed. Release the worker thread.
834
171k
    frame_worker_data->received_frame = 0;
835
171k
    ctx->need_resync = 1;
836
    // TODO(aomedia:3519): Set an error code. Check if a different error code
837
    // should be used if ctx->flushed != 1.
838
171k
    return NULL;
839
171k
  }
840
  // Check if worker has received any frames.
841
158k
  if (frame_worker_data->received_frame == 1) {
842
49.7k
    frame_worker_data->received_frame = 0;
843
49.7k
    check_resync(ctx, frame_worker_data->pbi);
844
49.7k
  }
845
158k
  YV12_BUFFER_CONFIG *sd;
846
158k
  aom_film_grain_t *grain_params;
847
158k
  if (av1_get_raw_frame(frame_worker_data->pbi, *index, &sd, &grain_params) !=
848
158k
      0) {
849
109k
    return NULL;
850
109k
  }
851
49.1k
  RefCntBuffer *const output_frame_buf = pbi->output_frames[*index];
852
49.1k
  ctx->last_show_frame = output_frame_buf;
853
49.1k
  if (ctx->need_resync) return NULL;
854
49.1k
  aom_img_remove_metadata(&ctx->img);
855
49.1k
  yuvconfig2image(&ctx->img, sd, frame_worker_data->user_priv);
856
49.1k
  move_decoder_metadata_to_img(pbi, &ctx->img);
857
858
49.1k
  if (!pbi->ext_tile_debug && tiles->large_scale) {
859
5.10k
    *index += 1;  // Advance the iterator to point to the next image
860
5.10k
    aom_img_remove_metadata(&ctx->img);
861
5.10k
    yuvconfig2image(&ctx->img, &pbi->tile_list_outbuf, NULL);
862
5.10k
    move_decoder_metadata_to_img(pbi, &ctx->img);
863
5.10k
    img = &ctx->img;
864
5.10k
    return img;
865
5.10k
  }
866
867
44.0k
  const int num_planes = av1_num_planes(cm);
868
44.0k
  if (pbi->ext_tile_debug && tiles->single_tile_decoding &&
869
4.21k
      pbi->dec_tile_row >= 0) {
870
0
    int tile_width, tile_height;
871
0
    if (!av1_get_uniform_tile_size(cm, &tile_width, &tile_height)) {
872
0
      return NULL;
873
0
    }
874
0
    const int tile_row = AOMMIN(pbi->dec_tile_row, tiles->rows - 1);
875
0
    const int mi_row = tile_row * tile_height;
876
0
    const int ssy = ctx->img.y_chroma_shift;
877
0
    int plane;
878
0
    ctx->img.planes[0] += mi_row * MI_SIZE * ctx->img.stride[0];
879
0
    if (num_planes > 1) {
880
0
      for (plane = 1; plane < MAX_MB_PLANE; ++plane) {
881
0
        ctx->img.planes[plane] +=
882
0
            mi_row * (MI_SIZE >> ssy) * ctx->img.stride[plane];
883
0
      }
884
0
    }
885
0
    ctx->img.d_h =
886
0
        AOMMIN(tile_height, cm->mi_params.mi_rows - mi_row) * MI_SIZE;
887
0
  }
888
889
44.0k
  if (pbi->ext_tile_debug && tiles->single_tile_decoding &&
890
4.21k
      pbi->dec_tile_col >= 0) {
891
0
    int tile_width, tile_height;
892
0
    if (!av1_get_uniform_tile_size(cm, &tile_width, &tile_height)) {
893
0
      return NULL;
894
0
    }
895
0
    const int tile_col = AOMMIN(pbi->dec_tile_col, tiles->cols - 1);
896
0
    const int mi_col = tile_col * tile_width;
897
0
    const int ssx = ctx->img.x_chroma_shift;
898
0
    const int is_hbd = (ctx->img.fmt & AOM_IMG_FMT_HIGHBITDEPTH) ? 1 : 0;
899
0
    int plane;
900
0
    ctx->img.planes[0] += mi_col * MI_SIZE * (1 + is_hbd);
901
0
    if (num_planes > 1) {
902
0
      for (plane = 1; plane < MAX_MB_PLANE; ++plane) {
903
0
        ctx->img.planes[plane] += mi_col * (MI_SIZE >> ssx) * (1 + is_hbd);
904
0
      }
905
0
    }
906
0
    ctx->img.d_w = AOMMIN(tile_width, cm->mi_params.mi_cols - mi_col) * MI_SIZE;
907
0
  }
908
909
44.0k
  ctx->img.fb_priv = output_frame_buf->raw_frame_buffer.priv;
910
44.0k
  img = &ctx->img;
911
44.0k
  img->temporal_id = output_frame_buf->temporal_id;
912
44.0k
  img->spatial_id = output_frame_buf->spatial_id;
913
44.0k
  if (pbi->skip_film_grain) grain_params->apply_grain = 0;
914
44.0k
  aom_image_t *res =
915
44.0k
      add_grain_if_needed(ctx, img, &ctx->image_with_grain, grain_params);
916
44.0k
  if (!res) {
917
0
    pbi->error.error_code = AOM_CODEC_CORRUPT_FRAME;
918
0
    pbi->error.has_detail = 1;
919
0
    snprintf(pbi->error.detail, sizeof(pbi->error.detail),
920
0
             "Grain synthesis failed\n");
921
0
    return res;
922
0
  }
923
44.0k
  *index += 1;  // Advance the iterator to point to the next image
924
44.0k
  return res;
925
44.0k
}
926
927
static aom_codec_err_t decoder_set_fb_fn(
928
    aom_codec_alg_priv_t *ctx, aom_get_frame_buffer_cb_fn_t cb_get,
929
0
    aom_release_frame_buffer_cb_fn_t cb_release, void *cb_priv) {
930
0
  if (cb_get == NULL || cb_release == NULL) {
931
0
    return AOM_CODEC_INVALID_PARAM;
932
0
  }
933
0
  if (ctx->frame_worker != NULL) {
934
    // If the decoder has already been initialized, do not accept changes to
935
    // the frame buffer functions.
936
0
    return AOM_CODEC_ERROR;
937
0
  }
938
939
0
  ctx->get_ext_fb_cb = cb_get;
940
0
  ctx->release_ext_fb_cb = cb_release;
941
0
  ctx->ext_priv = cb_priv;
942
0
  return AOM_CODEC_OK;
943
0
}
944
945
static aom_codec_err_t ctrl_set_reference(aom_codec_alg_priv_t *ctx,
946
0
                                          va_list args) {
947
0
  av1_ref_frame_t *const data = va_arg(args, av1_ref_frame_t *);
948
949
0
  if (data) {
950
0
    av1_ref_frame_t *const frame = data;
951
0
    YV12_BUFFER_CONFIG sd;
952
0
    AVxWorker *const worker = ctx->frame_worker;
953
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
954
0
    image2yuvconfig(&frame->img, &sd);
955
956
0
    struct aom_internal_error_info *const error =
957
0
        frame_worker_data->pbi->common.error;
958
0
    if (setjmp(error->jmp)) {
959
0
      error->setjmp = 0;
960
0
      return error->error_code;
961
0
    }
962
0
    error->setjmp = 1;
963
0
    av1_set_reference_dec(&frame_worker_data->pbi->common, frame->idx,
964
0
                          frame->use_external_ref, &sd);
965
0
    error->setjmp = 0;
966
0
    return AOM_CODEC_OK;
967
0
  } else {
968
0
    return AOM_CODEC_INVALID_PARAM;
969
0
  }
970
0
}
971
972
static aom_codec_err_t ctrl_copy_reference(aom_codec_alg_priv_t *ctx,
973
0
                                           va_list args) {
974
0
  const av1_ref_frame_t *const frame = va_arg(args, av1_ref_frame_t *);
975
0
  if (frame) {
976
0
    YV12_BUFFER_CONFIG sd;
977
0
    AVxWorker *const worker = ctx->frame_worker;
978
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
979
0
    image2yuvconfig(&frame->img, &sd);
980
0
    return av1_copy_reference_dec(frame_worker_data->pbi, frame->idx, &sd);
981
0
  } else {
982
0
    return AOM_CODEC_INVALID_PARAM;
983
0
  }
984
0
}
985
986
static aom_codec_err_t ctrl_get_reference(aom_codec_alg_priv_t *ctx,
987
0
                                          va_list args) {
988
0
  av1_ref_frame_t *data = va_arg(args, av1_ref_frame_t *);
989
0
  if (data) {
990
0
    YV12_BUFFER_CONFIG *fb;
991
0
    AVxWorker *const worker = ctx->frame_worker;
992
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
993
0
    fb = get_ref_frame(&frame_worker_data->pbi->common, data->idx);
994
0
    if (fb == NULL) return AOM_CODEC_ERROR;
995
0
    yuvconfig2image(&data->img, fb, NULL);
996
0
    return AOM_CODEC_OK;
997
0
  } else {
998
0
    return AOM_CODEC_INVALID_PARAM;
999
0
  }
1000
0
}
1001
1002
static aom_codec_err_t ctrl_get_new_frame_image(aom_codec_alg_priv_t *ctx,
1003
0
                                                va_list args) {
1004
0
  aom_image_t *new_img = va_arg(args, aom_image_t *);
1005
0
  if (new_img) {
1006
0
    YV12_BUFFER_CONFIG new_frame;
1007
0
    AVxWorker *const worker = ctx->frame_worker;
1008
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
1009
1010
0
    if (av1_get_frame_to_show(frame_worker_data->pbi, &new_frame) == 0) {
1011
0
      yuvconfig2image(new_img, &new_frame, NULL);
1012
0
      return AOM_CODEC_OK;
1013
0
    } else {
1014
0
      return AOM_CODEC_ERROR;
1015
0
    }
1016
0
  } else {
1017
0
    return AOM_CODEC_INVALID_PARAM;
1018
0
  }
1019
0
}
1020
1021
static aom_codec_err_t ctrl_copy_new_frame_image(aom_codec_alg_priv_t *ctx,
1022
0
                                                 va_list args) {
1023
0
  aom_image_t *img = va_arg(args, aom_image_t *);
1024
0
  if (img) {
1025
0
    YV12_BUFFER_CONFIG new_frame;
1026
0
    AVxWorker *const worker = ctx->frame_worker;
1027
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
1028
1029
0
    if (av1_get_frame_to_show(frame_worker_data->pbi, &new_frame) == 0) {
1030
0
      YV12_BUFFER_CONFIG sd;
1031
0
      image2yuvconfig(img, &sd);
1032
0
      return av1_copy_new_frame_dec(&frame_worker_data->pbi->common, &new_frame,
1033
0
                                    &sd);
1034
0
    } else {
1035
0
      return AOM_CODEC_ERROR;
1036
0
    }
1037
0
  } else {
1038
0
    return AOM_CODEC_INVALID_PARAM;
1039
0
  }
1040
0
}
1041
1042
static aom_codec_err_t ctrl_get_last_ref_updates(aom_codec_alg_priv_t *ctx,
1043
0
                                                 va_list args) {
1044
0
  int *const update_info = va_arg(args, int *);
1045
1046
0
  if (update_info) {
1047
0
    if (ctx->frame_worker) {
1048
0
      AVxWorker *const worker = ctx->frame_worker;
1049
0
      FrameWorkerData *const frame_worker_data =
1050
0
          (FrameWorkerData *)worker->data1;
1051
0
      *update_info =
1052
0
          frame_worker_data->pbi->common.current_frame.refresh_frame_flags;
1053
0
      return AOM_CODEC_OK;
1054
0
    } else {
1055
0
      return AOM_CODEC_ERROR;
1056
0
    }
1057
0
  }
1058
1059
0
  return AOM_CODEC_INVALID_PARAM;
1060
0
}
1061
1062
static aom_codec_err_t ctrl_get_last_quantizer(aom_codec_alg_priv_t *ctx,
1063
0
                                               va_list args) {
1064
0
  int *const arg = va_arg(args, int *);
1065
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1066
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1067
0
  *arg = ((FrameWorkerData *)ctx->frame_worker->data1)
1068
0
             ->pbi->common.quant_params.base_qindex;
1069
0
  return AOM_CODEC_OK;
1070
0
}
1071
1072
static aom_codec_err_t ctrl_get_fwd_kf_value(aom_codec_alg_priv_t *ctx,
1073
0
                                             va_list args) {
1074
0
  int *const arg = va_arg(args, int *);
1075
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1076
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1077
0
  *arg = ((FrameWorkerData *)ctx->frame_worker->data1)->pbi->is_fwd_kf_present;
1078
0
  return AOM_CODEC_OK;
1079
0
}
1080
1081
static aom_codec_err_t ctrl_get_altref_present(aom_codec_alg_priv_t *ctx,
1082
0
                                               va_list args) {
1083
0
  int *const arg = va_arg(args, int *);
1084
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1085
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1086
0
  *arg =
1087
0
      ((FrameWorkerData *)ctx->frame_worker->data1)->pbi->is_arf_frame_present;
1088
0
  return AOM_CODEC_OK;
1089
0
}
1090
1091
static aom_codec_err_t ctrl_get_frame_flags(aom_codec_alg_priv_t *ctx,
1092
0
                                            va_list args) {
1093
0
  int *const arg = va_arg(args, int *);
1094
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1095
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1096
0
  AV1Decoder *pbi = ((FrameWorkerData *)ctx->frame_worker->data1)->pbi;
1097
0
  *arg = 0;
1098
0
  switch (pbi->common.current_frame.frame_type) {
1099
0
    case KEY_FRAME:
1100
0
      *arg |= AOM_FRAME_IS_KEY;
1101
0
      *arg |= AOM_FRAME_IS_INTRAONLY;
1102
0
      if (!pbi->common.show_frame) {
1103
0
        *arg |= AOM_FRAME_IS_DELAYED_RANDOM_ACCESS_POINT;
1104
0
      }
1105
0
      break;
1106
0
    case INTRA_ONLY_FRAME: *arg |= AOM_FRAME_IS_INTRAONLY; break;
1107
0
    case S_FRAME: *arg |= AOM_FRAME_IS_SWITCH; break;
1108
0
  }
1109
0
  if (pbi->common.features.error_resilient_mode) {
1110
0
    *arg |= AOM_FRAME_IS_ERROR_RESILIENT;
1111
0
  }
1112
0
  return AOM_CODEC_OK;
1113
0
}
1114
1115
static aom_codec_err_t ctrl_get_tile_info(aom_codec_alg_priv_t *ctx,
1116
0
                                          va_list args) {
1117
0
  aom_tile_info *const tile_info = va_arg(args, aom_tile_info *);
1118
1119
0
  if (tile_info) {
1120
0
    if (ctx->frame_worker) {
1121
0
      AVxWorker *const worker = ctx->frame_worker;
1122
0
      FrameWorkerData *const frame_worker_data =
1123
0
          (FrameWorkerData *)worker->data1;
1124
0
      const AV1Decoder *pbi = frame_worker_data->pbi;
1125
0
      const CommonTileParams *tiles = &pbi->common.tiles;
1126
1127
0
      int tile_rows = tiles->rows;
1128
0
      int tile_cols = tiles->cols;
1129
1130
0
      if (tiles->uniform_spacing) {
1131
0
        tile_info->tile_rows = 1 << tiles->log2_rows;
1132
0
        tile_info->tile_columns = 1 << tiles->log2_cols;
1133
0
      } else {
1134
0
        tile_info->tile_rows = tile_rows;
1135
0
        tile_info->tile_columns = tile_cols;
1136
0
      }
1137
1138
0
      for (int tile_col = 1; tile_col <= tile_cols; tile_col++) {
1139
0
        tile_info->tile_widths[tile_col - 1] =
1140
0
            tiles->col_start_sb[tile_col] - tiles->col_start_sb[tile_col - 1];
1141
0
      }
1142
1143
0
      for (int tile_row = 1; tile_row <= tile_rows; tile_row++) {
1144
0
        tile_info->tile_heights[tile_row - 1] =
1145
0
            tiles->row_start_sb[tile_row] - tiles->row_start_sb[tile_row - 1];
1146
0
      }
1147
0
      tile_info->num_tile_groups = pbi->num_tile_groups;
1148
0
      return AOM_CODEC_OK;
1149
0
    } else {
1150
0
      return AOM_CODEC_ERROR;
1151
0
    }
1152
0
  }
1153
1154
0
  return AOM_CODEC_INVALID_PARAM;
1155
0
}
1156
1157
static aom_codec_err_t ctrl_get_screen_content_tools_info(
1158
0
    aom_codec_alg_priv_t *ctx, va_list args) {
1159
0
  aom_screen_content_tools_info *const sc_info =
1160
0
      va_arg(args, aom_screen_content_tools_info *);
1161
0
  if (sc_info) {
1162
0
    if (ctx->frame_worker) {
1163
0
      AVxWorker *const worker = ctx->frame_worker;
1164
0
      FrameWorkerData *const frame_worker_data =
1165
0
          (FrameWorkerData *)worker->data1;
1166
0
      const AV1Decoder *pbi = frame_worker_data->pbi;
1167
0
      sc_info->allow_screen_content_tools =
1168
0
          pbi->common.features.allow_screen_content_tools;
1169
0
      sc_info->allow_intrabc = pbi->common.features.allow_intrabc;
1170
0
      sc_info->force_integer_mv =
1171
0
          (int)pbi->common.features.cur_frame_force_integer_mv;
1172
0
      return AOM_CODEC_OK;
1173
0
    } else {
1174
0
      return AOM_CODEC_ERROR;
1175
0
    }
1176
0
  }
1177
0
  return AOM_CODEC_INVALID_PARAM;
1178
0
}
1179
1180
static aom_codec_err_t ctrl_get_still_picture(aom_codec_alg_priv_t *ctx,
1181
0
                                              va_list args) {
1182
0
  aom_still_picture_info *const still_picture_info =
1183
0
      va_arg(args, aom_still_picture_info *);
1184
0
  if (still_picture_info) {
1185
0
    if (ctx->frame_worker) {
1186
0
      AVxWorker *const worker = ctx->frame_worker;
1187
0
      FrameWorkerData *const frame_worker_data =
1188
0
          (FrameWorkerData *)worker->data1;
1189
0
      const AV1Decoder *pbi = frame_worker_data->pbi;
1190
0
      still_picture_info->is_still_picture = (int)pbi->seq_params.still_picture;
1191
0
      still_picture_info->is_reduced_still_picture_hdr =
1192
0
          (int)(pbi->seq_params.reduced_still_picture_hdr);
1193
0
      return AOM_CODEC_OK;
1194
0
    } else {
1195
0
      return AOM_CODEC_ERROR;
1196
0
    }
1197
0
  }
1198
0
  return AOM_CODEC_INVALID_PARAM;
1199
0
}
1200
1201
static aom_codec_err_t ctrl_get_sb_size(aom_codec_alg_priv_t *ctx,
1202
0
                                        va_list args) {
1203
0
  aom_superblock_size_t *const sb_size = va_arg(args, aom_superblock_size_t *);
1204
0
  if (sb_size) {
1205
0
    if (ctx->frame_worker) {
1206
0
      AVxWorker *const worker = ctx->frame_worker;
1207
0
      FrameWorkerData *const frame_worker_data =
1208
0
          (FrameWorkerData *)worker->data1;
1209
0
      const AV1Decoder *pbi = frame_worker_data->pbi;
1210
0
      if (pbi->seq_params.sb_size == BLOCK_128X128) {
1211
0
        *sb_size = AOM_SUPERBLOCK_SIZE_128X128;
1212
0
      } else {
1213
0
        *sb_size = AOM_SUPERBLOCK_SIZE_64X64;
1214
0
      }
1215
0
      return AOM_CODEC_OK;
1216
0
    } else {
1217
0
      return AOM_CODEC_ERROR;
1218
0
    }
1219
0
  }
1220
0
  return AOM_CODEC_INVALID_PARAM;
1221
0
}
1222
1223
static aom_codec_err_t ctrl_get_show_existing_frame_flag(
1224
0
    aom_codec_alg_priv_t *ctx, va_list args) {
1225
0
  int *const arg = va_arg(args, int *);
1226
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1227
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1228
0
  *arg = ((FrameWorkerData *)ctx->frame_worker->data1)
1229
0
             ->pbi->common.show_existing_frame;
1230
0
  return AOM_CODEC_OK;
1231
0
}
1232
1233
static aom_codec_err_t ctrl_get_s_frame_info(aom_codec_alg_priv_t *ctx,
1234
0
                                             va_list args) {
1235
0
  aom_s_frame_info *const s_frame_info = va_arg(args, aom_s_frame_info *);
1236
0
  if (s_frame_info) {
1237
0
    if (ctx->frame_worker) {
1238
0
      AVxWorker *const worker = ctx->frame_worker;
1239
0
      FrameWorkerData *const frame_worker_data =
1240
0
          (FrameWorkerData *)worker->data1;
1241
0
      const AV1Decoder *pbi = frame_worker_data->pbi;
1242
0
      s_frame_info->is_s_frame = pbi->sframe_info.is_s_frame;
1243
0
      s_frame_info->is_s_frame_at_altref =
1244
0
          pbi->sframe_info.is_s_frame_at_altref;
1245
0
      return AOM_CODEC_OK;
1246
0
    } else {
1247
0
      return AOM_CODEC_ERROR;
1248
0
    }
1249
0
  }
1250
0
  return AOM_CODEC_INVALID_PARAM;
1251
0
}
1252
1253
static aom_codec_err_t ctrl_get_frame_corrupted(aom_codec_alg_priv_t *ctx,
1254
0
                                                va_list args) {
1255
0
  int *corrupted = va_arg(args, int *);
1256
1257
0
  if (corrupted) {
1258
0
    if (ctx->frame_worker) {
1259
0
      AVxWorker *const worker = ctx->frame_worker;
1260
0
      FrameWorkerData *const frame_worker_data =
1261
0
          (FrameWorkerData *)worker->data1;
1262
0
      AV1Decoder *const pbi = frame_worker_data->pbi;
1263
0
      if (pbi->seen_frame_header && pbi->num_output_frames == 0)
1264
0
        return AOM_CODEC_ERROR;
1265
0
      if (ctx->last_show_frame != NULL)
1266
0
        *corrupted = ctx->last_show_frame->buf.corrupted;
1267
0
      return AOM_CODEC_OK;
1268
0
    } else {
1269
0
      return AOM_CODEC_ERROR;
1270
0
    }
1271
0
  }
1272
1273
0
  return AOM_CODEC_INVALID_PARAM;
1274
0
}
1275
1276
static aom_codec_err_t ctrl_get_frame_size(aom_codec_alg_priv_t *ctx,
1277
0
                                           va_list args) {
1278
0
  int *const frame_size = va_arg(args, int *);
1279
1280
0
  if (frame_size) {
1281
0
    if (ctx->frame_worker) {
1282
0
      AVxWorker *const worker = ctx->frame_worker;
1283
0
      FrameWorkerData *const frame_worker_data =
1284
0
          (FrameWorkerData *)worker->data1;
1285
0
      const AV1_COMMON *const cm = &frame_worker_data->pbi->common;
1286
0
      frame_size[0] = cm->width;
1287
0
      frame_size[1] = cm->height;
1288
0
      return AOM_CODEC_OK;
1289
0
    } else {
1290
0
      return AOM_CODEC_ERROR;
1291
0
    }
1292
0
  }
1293
1294
0
  return AOM_CODEC_INVALID_PARAM;
1295
0
}
1296
1297
static aom_codec_err_t ctrl_get_frame_header_info(aom_codec_alg_priv_t *ctx,
1298
0
                                                  va_list args) {
1299
0
  aom_tile_data *const frame_header_info = va_arg(args, aom_tile_data *);
1300
1301
0
  if (frame_header_info) {
1302
0
    if (ctx->frame_worker) {
1303
0
      AVxWorker *const worker = ctx->frame_worker;
1304
0
      FrameWorkerData *const frame_worker_data =
1305
0
          (FrameWorkerData *)worker->data1;
1306
0
      const AV1Decoder *pbi = frame_worker_data->pbi;
1307
0
      frame_header_info->coded_tile_data_size = pbi->obu_size_hdr.size;
1308
0
      frame_header_info->coded_tile_data = pbi->obu_size_hdr.data;
1309
0
      frame_header_info->extra_size = pbi->frame_header_size;
1310
0
      return AOM_CODEC_OK;
1311
0
    } else {
1312
0
      return AOM_CODEC_ERROR;
1313
0
    }
1314
0
  }
1315
1316
0
  return AOM_CODEC_INVALID_PARAM;
1317
0
}
1318
1319
static aom_codec_err_t ctrl_get_tile_data(aom_codec_alg_priv_t *ctx,
1320
0
                                          va_list args) {
1321
0
  aom_tile_data *const tile_data = va_arg(args, aom_tile_data *);
1322
1323
0
  if (tile_data) {
1324
0
    if (ctx->frame_worker) {
1325
0
      AVxWorker *const worker = ctx->frame_worker;
1326
0
      FrameWorkerData *const frame_worker_data =
1327
0
          (FrameWorkerData *)worker->data1;
1328
0
      const AV1Decoder *pbi = frame_worker_data->pbi;
1329
0
      tile_data->coded_tile_data_size =
1330
0
          pbi->tile_buffers[pbi->dec_tile_row][pbi->dec_tile_col].size;
1331
0
      tile_data->coded_tile_data =
1332
0
          pbi->tile_buffers[pbi->dec_tile_row][pbi->dec_tile_col].data;
1333
0
      return AOM_CODEC_OK;
1334
0
    } else {
1335
0
      return AOM_CODEC_ERROR;
1336
0
    }
1337
0
  }
1338
1339
0
  return AOM_CODEC_INVALID_PARAM;
1340
0
}
1341
1342
static aom_codec_err_t ctrl_set_ext_ref_ptr(aom_codec_alg_priv_t *ctx,
1343
0
                                            va_list args) {
1344
0
  av1_ext_ref_frame_t *const data = va_arg(args, av1_ext_ref_frame_t *);
1345
1346
0
  if (data) {
1347
0
    av1_ext_ref_frame_t *const ext_frames = data;
1348
0
    ctx->ext_refs.num = ext_frames->num;
1349
0
    for (int i = 0; i < ctx->ext_refs.num; i++) {
1350
0
      image2yuvconfig(ext_frames->img++, &ctx->ext_refs.refs[i]);
1351
0
    }
1352
0
    return AOM_CODEC_OK;
1353
0
  } else {
1354
0
    return AOM_CODEC_INVALID_PARAM;
1355
0
  }
1356
0
}
1357
1358
static aom_codec_err_t ctrl_get_render_size(aom_codec_alg_priv_t *ctx,
1359
0
                                            va_list args) {
1360
0
  int *const render_size = va_arg(args, int *);
1361
1362
0
  if (render_size) {
1363
0
    if (ctx->frame_worker) {
1364
0
      AVxWorker *const worker = ctx->frame_worker;
1365
0
      FrameWorkerData *const frame_worker_data =
1366
0
          (FrameWorkerData *)worker->data1;
1367
0
      const AV1_COMMON *const cm = &frame_worker_data->pbi->common;
1368
0
      render_size[0] = cm->render_width;
1369
0
      render_size[1] = cm->render_height;
1370
0
      return AOM_CODEC_OK;
1371
0
    } else {
1372
0
      return AOM_CODEC_ERROR;
1373
0
    }
1374
0
  }
1375
1376
0
  return AOM_CODEC_INVALID_PARAM;
1377
0
}
1378
1379
static aom_codec_err_t ctrl_get_bit_depth(aom_codec_alg_priv_t *ctx,
1380
0
                                          va_list args) {
1381
0
  unsigned int *const bit_depth = va_arg(args, unsigned int *);
1382
0
  AVxWorker *const worker = ctx->frame_worker;
1383
1384
0
  if (bit_depth) {
1385
0
    if (worker) {
1386
0
      FrameWorkerData *const frame_worker_data =
1387
0
          (FrameWorkerData *)worker->data1;
1388
0
      const AV1_COMMON *const cm = &frame_worker_data->pbi->common;
1389
0
      *bit_depth = cm->seq_params->bit_depth;
1390
0
      return AOM_CODEC_OK;
1391
0
    } else {
1392
0
      return AOM_CODEC_ERROR;
1393
0
    }
1394
0
  }
1395
1396
0
  return AOM_CODEC_INVALID_PARAM;
1397
0
}
1398
1399
static aom_img_fmt_t get_img_format(int subsampling_x, int subsampling_y,
1400
0
                                    int use_highbitdepth) {
1401
0
  aom_img_fmt_t fmt = 0;
1402
1403
0
  if (subsampling_x == 0 && subsampling_y == 0)
1404
0
    fmt = AOM_IMG_FMT_I444;
1405
0
  else if (subsampling_x == 1 && subsampling_y == 0)
1406
0
    fmt = AOM_IMG_FMT_I422;
1407
0
  else if (subsampling_x == 1 && subsampling_y == 1)
1408
0
    fmt = AOM_IMG_FMT_I420;
1409
1410
0
  if (use_highbitdepth) fmt |= AOM_IMG_FMT_HIGHBITDEPTH;
1411
0
  return fmt;
1412
0
}
1413
1414
static aom_codec_err_t ctrl_get_img_format(aom_codec_alg_priv_t *ctx,
1415
0
                                           va_list args) {
1416
0
  aom_img_fmt_t *const img_fmt = va_arg(args, aom_img_fmt_t *);
1417
0
  AVxWorker *const worker = ctx->frame_worker;
1418
1419
0
  if (img_fmt) {
1420
0
    if (worker) {
1421
0
      FrameWorkerData *const frame_worker_data =
1422
0
          (FrameWorkerData *)worker->data1;
1423
0
      const AV1_COMMON *const cm = &frame_worker_data->pbi->common;
1424
1425
0
      *img_fmt = get_img_format(cm->seq_params->subsampling_x,
1426
0
                                cm->seq_params->subsampling_y,
1427
0
                                cm->seq_params->use_highbitdepth);
1428
0
      return AOM_CODEC_OK;
1429
0
    } else {
1430
0
      return AOM_CODEC_ERROR;
1431
0
    }
1432
0
  }
1433
1434
0
  return AOM_CODEC_INVALID_PARAM;
1435
0
}
1436
1437
static aom_codec_err_t ctrl_get_tile_size(aom_codec_alg_priv_t *ctx,
1438
0
                                          va_list args) {
1439
0
  unsigned int *const tile_size = va_arg(args, unsigned int *);
1440
0
  AVxWorker *const worker = ctx->frame_worker;
1441
1442
0
  if (tile_size) {
1443
0
    if (worker) {
1444
0
      FrameWorkerData *const frame_worker_data =
1445
0
          (FrameWorkerData *)worker->data1;
1446
0
      const AV1_COMMON *const cm = &frame_worker_data->pbi->common;
1447
0
      int tile_width, tile_height;
1448
0
      if (!av1_get_uniform_tile_size(cm, &tile_width, &tile_height)) {
1449
0
        return AOM_CODEC_CORRUPT_FRAME;
1450
0
      }
1451
0
      *tile_size = ((tile_width * MI_SIZE) << 16) + tile_height * MI_SIZE;
1452
0
      return AOM_CODEC_OK;
1453
0
    } else {
1454
0
      return AOM_CODEC_ERROR;
1455
0
    }
1456
0
  }
1457
0
  return AOM_CODEC_INVALID_PARAM;
1458
0
}
1459
1460
static aom_codec_err_t ctrl_get_tile_count(aom_codec_alg_priv_t *ctx,
1461
0
                                           va_list args) {
1462
0
  unsigned int *const tile_count = va_arg(args, unsigned int *);
1463
1464
0
  if (tile_count) {
1465
0
    AVxWorker *const worker = ctx->frame_worker;
1466
0
    if (worker) {
1467
0
      FrameWorkerData *const frame_worker_data =
1468
0
          (FrameWorkerData *)worker->data1;
1469
0
      *tile_count = frame_worker_data->pbi->tile_count_minus_1 + 1;
1470
0
      return AOM_CODEC_OK;
1471
0
    } else {
1472
0
      return AOM_CODEC_ERROR;
1473
0
    }
1474
0
  }
1475
0
  return AOM_CODEC_INVALID_PARAM;
1476
0
}
1477
1478
static aom_codec_err_t ctrl_get_base_q_idx(aom_codec_alg_priv_t *ctx,
1479
0
                                           va_list args) {
1480
0
  int *const arg = va_arg(args, int *);
1481
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1482
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1483
0
  FrameWorkerData *const frame_worker_data =
1484
0
      (FrameWorkerData *)ctx->frame_worker->data1;
1485
0
  *arg = frame_worker_data->pbi->common.quant_params.base_qindex;
1486
0
  return AOM_CODEC_OK;
1487
0
}
1488
1489
static aom_codec_err_t ctrl_get_show_frame_flag(aom_codec_alg_priv_t *ctx,
1490
0
                                                va_list args) {
1491
0
  int *const arg = va_arg(args, int *);
1492
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1493
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1494
0
  FrameWorkerData *const frame_worker_data =
1495
0
      (FrameWorkerData *)ctx->frame_worker->data1;
1496
0
  *arg = frame_worker_data->pbi->common.show_frame;
1497
0
  return AOM_CODEC_OK;
1498
0
}
1499
1500
static aom_codec_err_t ctrl_get_order_hint(aom_codec_alg_priv_t *ctx,
1501
0
                                           va_list args) {
1502
0
  unsigned int *const arg = va_arg(args, unsigned int *);
1503
0
  if (arg == NULL) return AOM_CODEC_INVALID_PARAM;
1504
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1505
0
  FrameWorkerData *const frame_worker_data =
1506
0
      (FrameWorkerData *)ctx->frame_worker->data1;
1507
0
  *arg = frame_worker_data->pbi->common.current_frame.order_hint;
1508
0
  return AOM_CODEC_OK;
1509
0
}
1510
1511
static aom_codec_err_t ctrl_get_mi_info(aom_codec_alg_priv_t *ctx,
1512
0
                                        va_list args) {
1513
0
  int mi_row = va_arg(args, int);
1514
0
  int mi_col = va_arg(args, int);
1515
0
  MB_MODE_INFO *mi = va_arg(args, MB_MODE_INFO *);
1516
0
  if (mi == NULL) return AOM_CODEC_INVALID_PARAM;
1517
0
  if (ctx->frame_worker == NULL) return AOM_CODEC_ERROR;
1518
0
  FrameWorkerData *const frame_worker_data =
1519
0
      (FrameWorkerData *)ctx->frame_worker->data1;
1520
0
  if (frame_worker_data == NULL) return AOM_CODEC_ERROR;
1521
1522
0
  AV1_COMMON *cm = &frame_worker_data->pbi->common;
1523
0
  const int mi_rows = cm->mi_params.mi_rows;
1524
0
  const int mi_cols = cm->mi_params.mi_cols;
1525
0
  const int mi_stride = cm->mi_params.mi_stride;
1526
0
  const int offset = mi_row * mi_stride + mi_col;
1527
1528
0
  if (mi_row < 0 || mi_row >= mi_rows || mi_col < 0 || mi_col >= mi_cols) {
1529
0
    return AOM_CODEC_INVALID_PARAM;
1530
0
  }
1531
1532
0
  *mi = *cm->mi_params.mi_grid_base[offset];
1533
1534
0
  return AOM_CODEC_OK;
1535
0
}
1536
1537
static aom_codec_err_t ctrl_set_invert_tile_order(aom_codec_alg_priv_t *ctx,
1538
0
                                                  va_list args) {
1539
0
  ctx->invert_tile_order = va_arg(args, int);
1540
0
  return AOM_CODEC_OK;
1541
0
}
1542
1543
static aom_codec_err_t ctrl_set_byte_alignment(aom_codec_alg_priv_t *ctx,
1544
0
                                               va_list args) {
1545
0
  const int legacy_byte_alignment = 0;
1546
0
  const int min_byte_alignment = 32;
1547
0
  const int max_byte_alignment = 1024;
1548
0
  const int byte_alignment = va_arg(args, int);
1549
1550
0
  if (byte_alignment != legacy_byte_alignment &&
1551
0
      (byte_alignment < min_byte_alignment ||
1552
0
       byte_alignment > max_byte_alignment ||
1553
0
       (byte_alignment & (byte_alignment - 1)) != 0))
1554
0
    return AOM_CODEC_INVALID_PARAM;
1555
1556
0
  ctx->byte_alignment = byte_alignment;
1557
0
  if (ctx->frame_worker) {
1558
0
    AVxWorker *const worker = ctx->frame_worker;
1559
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
1560
0
    frame_worker_data->pbi->common.features.byte_alignment = byte_alignment;
1561
0
  }
1562
0
  return AOM_CODEC_OK;
1563
0
}
1564
1565
static aom_codec_err_t ctrl_set_skip_loop_filter(aom_codec_alg_priv_t *ctx,
1566
0
                                                 va_list args) {
1567
0
  ctx->skip_loop_filter = va_arg(args, int);
1568
1569
0
  if (ctx->frame_worker) {
1570
0
    AVxWorker *const worker = ctx->frame_worker;
1571
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
1572
0
    frame_worker_data->pbi->skip_loop_filter = ctx->skip_loop_filter;
1573
0
  }
1574
1575
0
  return AOM_CODEC_OK;
1576
0
}
1577
1578
static aom_codec_err_t ctrl_set_skip_film_grain(aom_codec_alg_priv_t *ctx,
1579
0
                                                va_list args) {
1580
0
  ctx->skip_film_grain = va_arg(args, int);
1581
1582
0
  if (ctx->frame_worker) {
1583
0
    AVxWorker *const worker = ctx->frame_worker;
1584
0
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
1585
0
    frame_worker_data->pbi->skip_film_grain = ctx->skip_film_grain;
1586
0
  }
1587
1588
0
  return AOM_CODEC_OK;
1589
0
}
1590
1591
static aom_codec_err_t ctrl_get_accounting(aom_codec_alg_priv_t *ctx,
1592
0
                                           va_list args) {
1593
0
#if !CONFIG_ACCOUNTING
1594
0
  (void)ctx;
1595
0
  (void)args;
1596
0
  return AOM_CODEC_INCAPABLE;
1597
#else
1598
  Accounting **acct = va_arg(args, Accounting **);
1599
1600
  if (acct) {
1601
    if (ctx->frame_worker) {
1602
      AVxWorker *const worker = ctx->frame_worker;
1603
      FrameWorkerData *const frame_worker_data =
1604
          (FrameWorkerData *)worker->data1;
1605
      AV1Decoder *pbi = frame_worker_data->pbi;
1606
      *acct = &pbi->accounting;
1607
      return AOM_CODEC_OK;
1608
    } else {
1609
      return AOM_CODEC_ERROR;
1610
    }
1611
  }
1612
1613
  return AOM_CODEC_INVALID_PARAM;
1614
#endif
1615
0
}
1616
1617
static aom_codec_err_t ctrl_set_decode_tile_row(aom_codec_alg_priv_t *ctx,
1618
0
                                                va_list args) {
1619
0
  ctx->decode_tile_row = va_arg(args, int);
1620
0
  return AOM_CODEC_OK;
1621
0
}
1622
1623
static aom_codec_err_t ctrl_set_decode_tile_col(aom_codec_alg_priv_t *ctx,
1624
0
                                                va_list args) {
1625
0
  ctx->decode_tile_col = va_arg(args, int);
1626
0
  return AOM_CODEC_OK;
1627
0
}
1628
1629
static aom_codec_err_t ctrl_set_tile_mode(aom_codec_alg_priv_t *ctx,
1630
15.8k
                                          va_list args) {
1631
15.8k
  ctx->tile_mode = va_arg(args, unsigned int);
1632
15.8k
  return AOM_CODEC_OK;
1633
15.8k
}
1634
1635
static aom_codec_err_t ctrl_set_is_annexb(aom_codec_alg_priv_t *ctx,
1636
15.8k
                                          va_list args) {
1637
15.8k
  ctx->is_annexb = va_arg(args, unsigned int);
1638
15.8k
  return AOM_CODEC_OK;
1639
15.8k
}
1640
1641
static aom_codec_err_t ctrl_set_operating_point(aom_codec_alg_priv_t *ctx,
1642
15.8k
                                                va_list args) {
1643
15.8k
  ctx->operating_point = va_arg(args, int);
1644
15.8k
  return AOM_CODEC_OK;
1645
15.8k
}
1646
1647
static aom_codec_err_t ctrl_set_output_all_layers(aom_codec_alg_priv_t *ctx,
1648
15.8k
                                                  va_list args) {
1649
15.8k
  ctx->output_all_layers = va_arg(args, int);
1650
15.8k
  return AOM_CODEC_OK;
1651
15.8k
}
1652
1653
static aom_codec_err_t ctrl_set_inspection_callback(aom_codec_alg_priv_t *ctx,
1654
0
                                                    va_list args) {
1655
0
#if !CONFIG_INSPECTION
1656
0
  (void)ctx;
1657
0
  (void)args;
1658
0
  return AOM_CODEC_INCAPABLE;
1659
#else
1660
  aom_inspect_init *init = va_arg(args, aom_inspect_init *);
1661
  ctx->inspect_cb = init->inspect_cb;
1662
  ctx->inspect_ctx = init->inspect_ctx;
1663
  return AOM_CODEC_OK;
1664
#endif
1665
0
}
1666
1667
static aom_codec_err_t ctrl_ext_tile_debug(aom_codec_alg_priv_t *ctx,
1668
15.8k
                                           va_list args) {
1669
15.8k
  ctx->ext_tile_debug = va_arg(args, int);
1670
15.8k
  return AOM_CODEC_OK;
1671
15.8k
}
1672
1673
static aom_codec_err_t ctrl_set_row_mt(aom_codec_alg_priv_t *ctx,
1674
0
                                       va_list args) {
1675
0
  ctx->row_mt = va_arg(args, unsigned int);
1676
0
  return AOM_CODEC_OK;
1677
0
}
1678
1679
static aom_codec_ctrl_fn_map_t decoder_ctrl_maps[] = {
1680
  { AV1_COPY_REFERENCE, ctrl_copy_reference },
1681
1682
  // Setters
1683
  { AV1_SET_REFERENCE, ctrl_set_reference },
1684
  { AV1_INVERT_TILE_DECODE_ORDER, ctrl_set_invert_tile_order },
1685
  { AV1_SET_BYTE_ALIGNMENT, ctrl_set_byte_alignment },
1686
  { AV1_SET_SKIP_LOOP_FILTER, ctrl_set_skip_loop_filter },
1687
  { AV1_SET_DECODE_TILE_ROW, ctrl_set_decode_tile_row },
1688
  { AV1_SET_DECODE_TILE_COL, ctrl_set_decode_tile_col },
1689
  { AV1_SET_TILE_MODE, ctrl_set_tile_mode },
1690
  { AV1D_SET_IS_ANNEXB, ctrl_set_is_annexb },
1691
  { AV1D_SET_OPERATING_POINT, ctrl_set_operating_point },
1692
  { AV1D_SET_OUTPUT_ALL_LAYERS, ctrl_set_output_all_layers },
1693
  { AV1_SET_INSPECTION_CALLBACK, ctrl_set_inspection_callback },
1694
  { AV1D_EXT_TILE_DEBUG, ctrl_ext_tile_debug },
1695
  { AV1D_SET_ROW_MT, ctrl_set_row_mt },
1696
  { AV1D_SET_EXT_REF_PTR, ctrl_set_ext_ref_ptr },
1697
  { AV1D_SET_SKIP_FILM_GRAIN, ctrl_set_skip_film_grain },
1698
1699
  // Getters
1700
  { AOMD_GET_FRAME_CORRUPTED, ctrl_get_frame_corrupted },
1701
  { AOMD_GET_LAST_QUANTIZER, ctrl_get_last_quantizer },
1702
  { AOMD_GET_LAST_REF_UPDATES, ctrl_get_last_ref_updates },
1703
  { AV1D_GET_BIT_DEPTH, ctrl_get_bit_depth },
1704
  { AV1D_GET_IMG_FORMAT, ctrl_get_img_format },
1705
  { AV1D_GET_TILE_SIZE, ctrl_get_tile_size },
1706
  { AV1D_GET_TILE_COUNT, ctrl_get_tile_count },
1707
  { AV1D_GET_DISPLAY_SIZE, ctrl_get_render_size },
1708
  { AV1D_GET_FRAME_SIZE, ctrl_get_frame_size },
1709
  { AV1_GET_ACCOUNTING, ctrl_get_accounting },
1710
  { AV1_GET_NEW_FRAME_IMAGE, ctrl_get_new_frame_image },
1711
  { AV1_COPY_NEW_FRAME_IMAGE, ctrl_copy_new_frame_image },
1712
  { AV1_GET_REFERENCE, ctrl_get_reference },
1713
  { AV1D_GET_FRAME_HEADER_INFO, ctrl_get_frame_header_info },
1714
  { AV1D_GET_TILE_DATA, ctrl_get_tile_data },
1715
  { AOMD_GET_FWD_KF_PRESENT, ctrl_get_fwd_kf_value },
1716
  { AOMD_GET_ALTREF_PRESENT, ctrl_get_altref_present },
1717
  { AOMD_GET_FRAME_FLAGS, ctrl_get_frame_flags },
1718
  { AOMD_GET_TILE_INFO, ctrl_get_tile_info },
1719
  { AOMD_GET_SCREEN_CONTENT_TOOLS_INFO, ctrl_get_screen_content_tools_info },
1720
  { AOMD_GET_STILL_PICTURE, ctrl_get_still_picture },
1721
  { AOMD_GET_SB_SIZE, ctrl_get_sb_size },
1722
  { AOMD_GET_SHOW_EXISTING_FRAME_FLAG, ctrl_get_show_existing_frame_flag },
1723
  { AOMD_GET_S_FRAME_INFO, ctrl_get_s_frame_info },
1724
  { AOMD_GET_SHOW_FRAME_FLAG, ctrl_get_show_frame_flag },
1725
  { AOMD_GET_BASE_Q_IDX, ctrl_get_base_q_idx },
1726
  { AOMD_GET_ORDER_HINT, ctrl_get_order_hint },
1727
  { AV1D_GET_MI_INFO, ctrl_get_mi_info },
1728
  CTRL_MAP_END,
1729
};
1730
1731
// This data structure and function are exported in aom/aomdx.h
1732
#ifndef VERSION_STRING
1733
#define VERSION_STRING
1734
#endif
1735
aom_codec_iface_t aom_codec_av1_dx_algo = {
1736
  "AOMedia Project AV1 Decoder" VERSION_STRING,
1737
  AOM_CODEC_INTERNAL_ABI_VERSION,
1738
  AOM_CODEC_CAP_DECODER |
1739
      AOM_CODEC_CAP_EXTERNAL_FRAME_BUFFER,  // aom_codec_caps_t
1740
  decoder_init,                             // aom_codec_init_fn_t
1741
  decoder_destroy,                          // aom_codec_destroy_fn_t
1742
  decoder_ctrl_maps,                        // aom_codec_ctrl_fn_map_t
1743
  {
1744
      // NOLINT
1745
      decoder_peek_si,    // aom_codec_peek_si_fn_t
1746
      decoder_get_si,     // aom_codec_get_si_fn_t
1747
      decoder_decode,     // aom_codec_decode_fn_t
1748
      decoder_get_frame,  // aom_codec_get_frame_fn_t
1749
      decoder_set_fb_fn,  // aom_codec_set_fb_fn_t
1750
  },
1751
  {
1752
      // NOLINT
1753
      0,
1754
      NULL,  // aom_codec_enc_cfg_t
1755
      NULL,  // aom_codec_encode_fn_t
1756
      NULL,  // aom_codec_get_cx_data_fn_t
1757
      NULL,  // aom_codec_enc_config_set_fn_t
1758
      NULL,  // aom_codec_get_global_headers_fn_t
1759
      NULL   // aom_codec_get_preview_frame_fn_t
1760
  },
1761
  NULL  // aom_codec_set_option_fn_t
1762
};
1763
1764
// Decoder interface for inspecting frame data. It uses decoder_inspect instead
1765
// of decoder_decode so it only decodes one frame at a time, whether the frame
1766
// is shown or not.
1767
aom_codec_iface_t aom_codec_av1_inspect_algo = {
1768
  "AOMedia Project AV1 Decoder Inspector" VERSION_STRING,
1769
  AOM_CODEC_INTERNAL_ABI_VERSION,
1770
  AOM_CODEC_CAP_DECODER |
1771
      AOM_CODEC_CAP_EXTERNAL_FRAME_BUFFER,  // aom_codec_caps_t
1772
  decoder_init,                             // aom_codec_init_fn_t
1773
  decoder_destroy,                          // aom_codec_destroy_fn_t
1774
  decoder_ctrl_maps,                        // aom_codec_ctrl_fn_map_t
1775
  {
1776
      // NOLINT
1777
      decoder_peek_si,    // aom_codec_peek_si_fn_t
1778
      decoder_get_si,     // aom_codec_get_si_fn_t
1779
      decoder_inspect,    // aom_codec_decode_fn_t
1780
      decoder_get_frame,  // aom_codec_get_frame_fn_t
1781
      decoder_set_fb_fn,  // aom_codec_set_fb_fn_t
1782
  },
1783
  {
1784
      // NOLINT
1785
      0,
1786
      NULL,  // aom_codec_enc_cfg_t
1787
      NULL,  // aom_codec_encode_fn_t
1788
      NULL,  // aom_codec_get_cx_data_fn_t
1789
      NULL,  // aom_codec_enc_config_set_fn_t
1790
      NULL,  // aom_codec_get_global_headers_fn_t
1791
      NULL   // aom_codec_get_preview_frame_fn_t
1792
  },
1793
  NULL  // aom_codec_set_option_fn_t
1794
};
1795
1796
15.8k
aom_codec_iface_t *aom_codec_av1_dx(void) { return &aom_codec_av1_dx_algo; }