av1_dx_iface.c 46.1 KB
Newer Older
Jingning Han's avatar
Jingning Han committed
1
/*
Yaowu Xu's avatar
Yaowu Xu committed
2
 * Copyright (c) 2016, Alliance for Open Media. All rights reserved
Jingning Han's avatar
Jingning Han committed
3
 *
Yaowu Xu's avatar
Yaowu Xu committed
4
5
6
7
8
9
 * This source code is subject to the terms of the BSD 2 Clause License and
 * the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License
 * was not distributed with this source code in the LICENSE file, you can
 * obtain it at www.aomedia.org/license/software. If the Alliance for Open
 * Media Patent License 1.0 was not distributed with this source code in the
 * PATENTS file, you can obtain it at www.aomedia.org/license/patent.
Jingning Han's avatar
Jingning Han committed
10
11
12
13
14
 */

#include <stdlib.h>
#include <string.h>

Yaowu Xu's avatar
Yaowu Xu committed
15
16
#include "./aom_config.h"
#include "./aom_version.h"
Jingning Han's avatar
Jingning Han committed
17

Yaowu Xu's avatar
Yaowu Xu committed
18
19
20
#include "aom/internal/aom_codec_internal.h"
#include "aom/aomdx.h"
#include "aom/aom_decoder.h"
21
#include "aom_dsp/bitreader_buffer.h"
Yaowu Xu's avatar
Yaowu Xu committed
22
23
#include "aom_dsp/aom_dsp_common.h"
#include "aom_util/aom_thread.h"
Jingning Han's avatar
Jingning Han committed
24

25
26
27
#include "av1/common/alloccommon.h"
#include "av1/common/frame_buffers.h"
#include "av1/common/enums.h"
Jingning Han's avatar
Jingning Han committed
28

29
30
#include "av1/decoder/decoder.h"
#include "av1/decoder/decodeframe.h"
Jingning Han's avatar
Jingning Han committed
31

Yaowu Xu's avatar
Yaowu Xu committed
32
#include "av1/av1_iface_common.h"
Jingning Han's avatar
Jingning Han committed
33
34
35

// This limit is due to framebuffer numbers.
// TODO(hkuang): Remove this limit after implementing ondemand framebuffers.
36
#define FRAME_CACHE_SIZE 6  // Cache maximum 6 decoded frames.
Jingning Han's avatar
Jingning Han committed
37
38
39

typedef struct cache_frame {
  int fb_idx;
Yaowu Xu's avatar
Yaowu Xu committed
40
  aom_image_t img;
Jingning Han's avatar
Jingning Han committed
41
42
} cache_frame;

Yaowu Xu's avatar
Yaowu Xu committed
43
44
45
struct aom_codec_alg_priv {
  aom_codec_priv_t base;
  aom_codec_dec_cfg_t cfg;
46
  aom_codec_stream_info_t si;
47
  int postproc_cfg_set;
Yaowu Xu's avatar
Yaowu Xu committed
48
49
  aom_postproc_cfg_t postproc_cfg;
  aom_image_t img;
50
51
52
53
54
55
56
57
  int img_avail;
  int flushed;
  int invert_tile_order;
  int last_show_frame;  // Index of last output frame.
  int byte_alignment;
  int skip_loop_filter;
  int decode_tile_row;
  int decode_tile_col;
Jingning Han's avatar
Jingning Han committed
58
59

  // Frame parallel related.
60
  int frame_parallel_decode;  // frame-based threading.
Yaowu Xu's avatar
Yaowu Xu committed
61
  AVxWorker *frame_workers;
62
63
64
65
66
67
68
69
70
71
  int num_frame_workers;
  int next_submit_worker_id;
  int last_submit_worker_id;
  int next_output_worker_id;
  int available_threads;
  cache_frame frame_cache[FRAME_CACHE_SIZE];
  int frame_cache_write;
  int frame_cache_read;
  int num_cache_frames;
  int need_resync;  // wait for key/intra-only frame
Jingning Han's avatar
Jingning Han committed
72
  // BufferPool that holds all reference frames. Shared by all the FrameWorkers.
73
  BufferPool *buffer_pool;
Jingning Han's avatar
Jingning Han committed
74

Yaowu Xu's avatar
Yaowu Xu committed
75
  // External frame buffer info to save for AV1 common.
Jingning Han's avatar
Jingning Han committed
76
  void *ext_priv;  // Private data associated with the external frame buffers.
Yaowu Xu's avatar
Yaowu Xu committed
77
78
  aom_get_frame_buffer_cb_fn_t get_ext_fb_cb;
  aom_release_frame_buffer_cb_fn_t release_ext_fb_cb;
79
80
81
82
83

#if CONFIG_INSPECTION
  aom_inspect_cb inspect_cb;
  void *inspect_ctx;
#endif
Jingning Han's avatar
Jingning Han committed
84
85
};

Yaowu Xu's avatar
Yaowu Xu committed
86
87
88
static aom_codec_err_t decoder_init(aom_codec_ctx_t *ctx,
                                    aom_codec_priv_enc_mr_cfg_t *data) {
  // This function only allocates space for the aom_codec_alg_priv_t
Jingning Han's avatar
Jingning Han committed
89
90
91
92
93
  // structure. More memory may be required at the time the stream
  // information becomes known.
  (void)data;

  if (!ctx->priv) {
Yaowu Xu's avatar
Yaowu Xu committed
94
95
96
    aom_codec_alg_priv_t *const priv =
        (aom_codec_alg_priv_t *)aom_calloc(1, sizeof(*priv));
    if (priv == NULL) return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
97

Yaowu Xu's avatar
Yaowu Xu committed
98
    ctx->priv = (aom_codec_priv_t *)priv;
Jingning Han's avatar
Jingning Han committed
99
100
101
102
103
    ctx->priv->init_flags = ctx->init_flags;
    priv->flushed = 0;
    // Only do frame parallel decode when threads > 1.
    priv->frame_parallel_decode =
        (ctx->config.dec && (ctx->config.dec->threads > 1) &&
Yaowu Xu's avatar
Yaowu Xu committed
104
         (ctx->init_flags & AOM_CODEC_USE_FRAME_THREADING))
105
106
            ? 1
            : 0;
107
108
    // TODO(tdaede): this should not be exposed to the API
    priv->cfg.allow_lowbitdepth = CONFIG_LOWBITDEPTH;
Jingning Han's avatar
Jingning Han committed
109
110
111
112
113
114
    if (ctx->config.dec) {
      priv->cfg = *ctx->config.dec;
      ctx->config.dec = &priv->cfg;
    }
  }

Yaowu Xu's avatar
Yaowu Xu committed
115
  return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
116
117
}

Yaowu Xu's avatar
Yaowu Xu committed
118
static aom_codec_err_t decoder_destroy(aom_codec_alg_priv_t *ctx) {
Jingning Han's avatar
Jingning Han committed
119
120
121
  if (ctx->frame_workers != NULL) {
    int i;
    for (i = 0; i < ctx->num_frame_workers; ++i) {
Yaowu Xu's avatar
Yaowu Xu committed
122
      AVxWorker *const worker = &ctx->frame_workers[i];
Jingning Han's avatar
Jingning Han committed
123
124
      FrameWorkerData *const frame_worker_data =
          (FrameWorkerData *)worker->data1;
Yaowu Xu's avatar
Yaowu Xu committed
125
      aom_get_worker_interface()->end(worker);
Yaowu Xu's avatar
Yaowu Xu committed
126
127
128
129
#if CONFIG_MFMV
      aom_free(frame_worker_data->pbi->common.tpl_mvs);
      frame_worker_data->pbi->common.tpl_mvs = NULL;
#endif
Yaowu Xu's avatar
Yaowu Xu committed
130
      av1_remove_common(&frame_worker_data->pbi->common);
Debargha Mukherjee's avatar
Debargha Mukherjee committed
131
#if CONFIG_LOOP_RESTORATION
Yaowu Xu's avatar
Yaowu Xu committed
132
      av1_free_restoration_buffers(&frame_worker_data->pbi->common);
Debargha Mukherjee's avatar
Debargha Mukherjee committed
133
#endif  // CONFIG_LOOP_RESTORATION
Yaowu Xu's avatar
Yaowu Xu committed
134
135
      av1_decoder_remove(frame_worker_data->pbi);
      aom_free(frame_worker_data->scratch_buffer);
Jingning Han's avatar
Jingning Han committed
136
137
138
139
#if CONFIG_MULTITHREAD
      pthread_mutex_destroy(&frame_worker_data->stats_mutex);
      pthread_cond_destroy(&frame_worker_data->stats_cond);
#endif
Yaowu Xu's avatar
Yaowu Xu committed
140
      aom_free(frame_worker_data);
Jingning Han's avatar
Jingning Han committed
141
142
143
144
145
146
147
    }
#if CONFIG_MULTITHREAD
    pthread_mutex_destroy(&ctx->buffer_pool->pool_mutex);
#endif
  }

  if (ctx->buffer_pool) {
Yaowu Xu's avatar
Yaowu Xu committed
148
149
    av1_free_ref_frame_buffers(ctx->buffer_pool);
    av1_free_internal_frame_buffers(&ctx->buffer_pool->int_frame_buffers);
Jingning Han's avatar
Jingning Han committed
150
151
  }

Yaowu Xu's avatar
Yaowu Xu committed
152
153
154
155
  aom_free(ctx->frame_workers);
  aom_free(ctx->buffer_pool);
  aom_free(ctx);
  return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
156
157
}

158
#if !CONFIG_OBU
159
160
161
162
163
164
165
166
167
168
static aom_bit_depth_t parse_bitdepth(BITSTREAM_PROFILE profile,
                                      struct aom_read_bit_buffer *rb) {
  aom_bit_depth_t bit_depth = aom_rb_read_bit(rb) ? AOM_BITS_10 : AOM_BITS_8;
  if (profile < PROFILE_2 || bit_depth == AOM_BITS_8) {
    return bit_depth;
  }
  bit_depth = aom_rb_read_bit(rb) ? AOM_BITS_12 : AOM_BITS_10;
  return bit_depth;
}

169
static int parse_bitdepth_colorspace_sampling(BITSTREAM_PROFILE profile,
Yaowu Xu's avatar
Yaowu Xu committed
170
                                              struct aom_read_bit_buffer *rb) {
Andrey Norkin's avatar
Andrey Norkin committed
171
172
173
174
#if CONFIG_CICP
  aom_color_primaries_t color_primaries;
  aom_transfer_characteristics_t transfer_characteristics;
  aom_matrix_coefficients_t matrix_coefficients;
175
176
#else
  aom_color_space_t color_space = AOM_CS_UNKNOWN;
177
#endif  // CONFIG_CICP
178
179
  int subsampling_x = 0;
  int subsampling_y = 0;
180
181
  (void)subsampling_x;
  (void)subsampling_y;
182
183
184
185
186
187
188
189

  aom_bit_depth_t bit_depth = parse_bitdepth(profile, rb);
#if CONFIG_MONO_VIDEO
  // Monochrome bit
  const int is_monochrome = profile != PROFILE_1 ? aom_rb_read_bit(rb) : 0;
#else
  const int is_monochrome = 0;
#endif  // CONFIG_MONO_VIDEO
190

Andrey Norkin's avatar
Andrey Norkin committed
191
192
193
194
195
196
197
198
199
200
201
202
203
#if CONFIG_CICP
  int color_description_present_flag = aom_rb_read_bit(rb);
  if (color_description_present_flag) {
    color_primaries = (aom_color_primaries_t)aom_rb_read_literal(rb, 8);
    transfer_characteristics =
        (aom_transfer_characteristics_t)aom_rb_read_literal(rb, 8);
    matrix_coefficients = (aom_matrix_coefficients_t)aom_rb_read_literal(rb, 8);
  } else {
    color_primaries = AOM_CICP_CP_UNSPECIFIED;
    transfer_characteristics = AOM_CICP_TC_UNSPECIFIED;
    matrix_coefficients = AOM_CICP_MC_UNSPECIFIED;
  }
#else
204
#if CONFIG_COLORSPACE_HEADERS
205
206
207
  if (!is_monochrome) {
    color_space = (aom_color_space_t)aom_rb_read_literal(rb, 5);
  }
208
209
  rb->bit_offset += 5;  // Transfer function
#else
210
211
212
213
214
  if (!is_monochrome) {
    color_space = (aom_color_space_t)aom_rb_read_literal(rb, 4);
  }
#endif  // CONFIG_COLORSPACE_HEADERS
#endif  // CONFIG_CICP
215
216
217
#if CONFIG_MONO_VIDEO
  if (is_monochrome) return 1;
#endif  // CONFIG_MONO_VIDEO
Andrey Norkin's avatar
Andrey Norkin committed
218
219
220
221
222
223
224
#if CONFIG_CICP
  if (color_primaries == AOM_CICP_CP_BT_709 &&
      transfer_characteristics == AOM_CICP_TC_SRGB &&
      matrix_coefficients == AOM_CICP_MC_IDENTITY) {  // it would be better to
                                                      // remove this dependency
                                                      // too
#else
225
  if (color_space == AOM_CS_SRGB) {
226
227
228
#endif  // CONFIG_CICP
    if (!(profile == PROFILE_1 ||
          (profile == PROFILE_2 && bit_depth == AOM_BITS_12))) {
229
230
231
      return 0;
    }
  } else {
Jingning Han's avatar
Jingning Han committed
232
    rb->bit_offset += 1;  // [16,235] (including xvycc) vs [0,255] range.
233

234
    if (profile == PROFILE_0) {
235
236
      subsampling_x = 1;
      subsampling_y = 1;
237
238
239
240
241
242
243
244
245
246
247
    } else if (profile == PROFILE_1) {
      subsampling_x = 0;
      subsampling_y = 0;
    } else if (profile == PROFILE_2) {
      if (bit_depth == AOM_BITS_12) {
        subsampling_x = aom_rb_read_bit(rb);
        subsampling_y = aom_rb_read_bit(rb);
      } else {
        subsampling_x = 1;
        subsampling_y = 0;
      }
248
    }
249
#if CONFIG_COLORSPACE_HEADERS
250
    if (subsampling_x == 1 && subsampling_y == 1) {
251
      rb->bit_offset += 2;  // chroma_sample_position
Jingning Han's avatar
Jingning Han committed
252
    }
253
#endif  // CONFIG_COLORSPACE_HEADERS
Jingning Han's avatar
Jingning Han committed
254
  }
255
256
257
#if CONFIG_EXT_QM
  rb->bit_offset += 1;  // separate_uv_delta_q
#endif                  // CONFIG_EXT_QM
Jingning Han's avatar
Jingning Han committed
258
259
  return 1;
}
260
#endif
Jingning Han's avatar
Jingning Han committed
261

262
263
264
265
static aom_codec_err_t decoder_peek_si_internal(const uint8_t *data,
                                                unsigned int data_sz,
                                                aom_codec_stream_info_t *si,
                                                int *is_intra_only) {
Jingning Han's avatar
Jingning Han committed
266
267
  int intra_only_flag = 0;

Yaowu Xu's avatar
Yaowu Xu committed
268
  if (data + data_sz <= data) return AOM_CODEC_INVALID_PARAM;
Jingning Han's avatar
Jingning Han committed
269
270
271
272

  si->is_kf = 0;
  si->w = si->h = 0;

Sebastien Alaiwan's avatar
Sebastien Alaiwan committed
273
274
275
276
277
  // skip a potential superframe index
  {
    uint32_t frame_sizes[8];
    int frame_count;
    int index_size = 0;
278
279
    aom_codec_err_t res = av1_parse_superframe_index(data, data_sz, frame_sizes,
                                                     &frame_count, &index_size);
Sebastien Alaiwan's avatar
Sebastien Alaiwan committed
280
281
282
283
    if (res != AOM_CODEC_OK) return res;

    data += index_size;
    data_sz -= index_size;
284
285
286
#if CONFIG_OBU
    if (data + data_sz <= data) return AOM_CODEC_INVALID_PARAM;
#endif
Sebastien Alaiwan's avatar
Sebastien Alaiwan committed
287
288
  }

Jingning Han's avatar
Jingning Han committed
289
  {
290
291
292
293
294
295
#if CONFIG_OBU
    // Proper fix needed
    si->is_kf = 1;
    intra_only_flag = 1;
    si->h = 1;
#else
Jingning Han's avatar
Jingning Han committed
296
297
    int show_frame;
    int error_resilient;
Yaowu Xu's avatar
Yaowu Xu committed
298
299
300
    struct aom_read_bit_buffer rb = { data, data + data_sz, 0, NULL, NULL };
    const int frame_marker = aom_rb_read_literal(&rb, 2);
    const BITSTREAM_PROFILE profile = av1_read_profile(&rb);
301
302
303
#if CONFIG_EXT_TILE
    unsigned int large_scale_tile;
#endif  // CONFIG_EXT_TILE
Jingning Han's avatar
Jingning Han committed
304

Yaowu Xu's avatar
Yaowu Xu committed
305
    if (frame_marker != AOM_FRAME_MARKER) return AOM_CODEC_UNSUP_BITSTREAM;
Jingning Han's avatar
Jingning Han committed
306

Yaowu Xu's avatar
Yaowu Xu committed
307
    if (profile >= MAX_PROFILES) return AOM_CODEC_UNSUP_BITSTREAM;
Jingning Han's avatar
Jingning Han committed
308
309

    if ((profile >= 2 && data_sz <= 1) || data_sz < 1)
Yaowu Xu's avatar
Yaowu Xu committed
310
      return AOM_CODEC_UNSUP_BITSTREAM;
Jingning Han's avatar
Jingning Han committed
311

312
313
314
315
#if CONFIG_EXT_TILE
    large_scale_tile = aom_rb_read_literal(&rb, 1);
#endif  // CONFIG_EXT_TILE

Yaowu Xu's avatar
Yaowu Xu committed
316
317
318
    if (aom_rb_read_bit(&rb)) {     // show an existing frame
      aom_rb_read_literal(&rb, 3);  // Frame buffer to show.
      return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
319
320
    }

Yaowu Xu's avatar
Yaowu Xu committed
321
    if (data_sz <= 8) return AOM_CODEC_UNSUP_BITSTREAM;
Jingning Han's avatar
Jingning Han committed
322

Yaowu Xu's avatar
Yaowu Xu committed
323
324
    si->is_kf = !aom_rb_read_bit(&rb);
    show_frame = aom_rb_read_bit(&rb);
325
326
327
    if (!si->is_kf) {
      if (!show_frame) intra_only_flag = show_frame ? 0 : aom_rb_read_bit(&rb);
    }
Yaowu Xu's avatar
Yaowu Xu committed
328
    error_resilient = aom_rb_read_bit(&rb);
329
#if CONFIG_REFERENCE_BUFFER
330
331
    SequenceHeader seq_params;
    memset(&seq_params, 0, sizeof(seq_params));
332
    if (si->is_kf) {
333
      /* TODO: Move outside frame loop or inside key-frame branch */
334
      read_sequence_header(&seq_params, &rb);
335
#if CONFIG_EXT_TILE
336
      if (large_scale_tile) seq_params.frame_id_numbers_present_flag = 0;
337
#endif  // CONFIG_EXT_TILE
338
339
    }
#endif  // CONFIG_REFERENCE_BUFFER
340

341
#if CONFIG_REFERENCE_BUFFER
342
    if (seq_params.frame_id_numbers_present_flag) {
343
      aom_rb_read_literal(&rb, seq_params.frame_id_length);
344
    }
345
#endif  // CONFIG_REFERENCE_BUFFER
346
347
348
349
350

#if CONFIG_FRAME_SIZE
    int frame_size_override_flag = aom_rb_read_bit(&rb);
#endif

Jingning Han's avatar
Jingning Han committed
351
352
    if (si->is_kf) {
      if (!parse_bitdepth_colorspace_sampling(profile, &rb))
Yaowu Xu's avatar
Yaowu Xu committed
353
        return AOM_CODEC_UNSUP_BITSTREAM;
354
355
356
357
358
359
360
361
362
363
364
#if CONFIG_FRAME_SIZE
      if (frame_size_override_flag) {
        int num_bits_width = seq_params.num_bits_width;
        int num_bits_height = seq_params.num_bits_height;
        av1_read_frame_size(&rb, num_bits_width, num_bits_height, (int *)&si->w,
                            (int *)&si->h);
      } else {
        si->w = seq_params.max_frame_width;
        si->h = seq_params.max_frame_height;
      }
#else
Yaowu Xu's avatar
Yaowu Xu committed
365
      av1_read_frame_size(&rb, (int *)&si->w, (int *)&si->h);
366
#endif
Jingning Han's avatar
Jingning Han committed
367
368
369
370
371
372
    } else {
      rb.bit_offset += error_resilient ? 0 : 2;  // reset_frame_context

      if (intra_only_flag) {
        if (profile > PROFILE_0) {
          if (!parse_bitdepth_colorspace_sampling(profile, &rb))
Yaowu Xu's avatar
Yaowu Xu committed
373
            return AOM_CODEC_UNSUP_BITSTREAM;
Jingning Han's avatar
Jingning Han committed
374
375
        }
        rb.bit_offset += REF_FRAMES;  // refresh_frame_flags
376
377
378
379
380
381
382
383
384
385
386
#if CONFIG_FRAME_SIZE
        if (frame_size_override_flag) {
          int num_bits_width = seq_params.num_bits_width;
          int num_bits_height = seq_params.num_bits_height;
          av1_read_frame_size(&rb, num_bits_width, num_bits_height,
                              (int *)&si->w, (int *)&si->h);
        } else {
          si->w = seq_params.max_frame_width;
          si->h = seq_params.max_frame_height;
        }
#else
Yaowu Xu's avatar
Yaowu Xu committed
387
        av1_read_frame_size(&rb, (int *)&si->w, (int *)&si->h);
388
#endif
Jingning Han's avatar
Jingning Han committed
389
390
      }
    }
391
#endif  // CONFIG_OBU
Jingning Han's avatar
Jingning Han committed
392
  }
393
  if (is_intra_only != NULL) *is_intra_only = intra_only_flag;
Yaowu Xu's avatar
Yaowu Xu committed
394
  return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
395
396
}

Yaowu Xu's avatar
Yaowu Xu committed
397
static aom_codec_err_t decoder_peek_si(const uint8_t *data,
Jingning Han's avatar
Jingning Han committed
398
                                       unsigned int data_sz,
Yaowu Xu's avatar
Yaowu Xu committed
399
                                       aom_codec_stream_info_t *si) {
400
  return decoder_peek_si_internal(data, data_sz, si, NULL);
Jingning Han's avatar
Jingning Han committed
401
402
}

Yaowu Xu's avatar
Yaowu Xu committed
403
404
static aom_codec_err_t decoder_get_si(aom_codec_alg_priv_t *ctx,
                                      aom_codec_stream_info_t *si) {
405
  memcpy(si, &ctx->si, sizeof(*si));
Jingning Han's avatar
Jingning Han committed
406

Yaowu Xu's avatar
Yaowu Xu committed
407
  return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
408
409
}

Yaowu Xu's avatar
Yaowu Xu committed
410
static void set_error_detail(aom_codec_alg_priv_t *ctx,
Jingning Han's avatar
Jingning Han committed
411
412
413
414
                             const char *const error) {
  ctx->base.err_detail = error;
}

Yaowu Xu's avatar
Yaowu Xu committed
415
416
static aom_codec_err_t update_error_state(
    aom_codec_alg_priv_t *ctx, const struct aom_internal_error_info *error) {
Jingning Han's avatar
Jingning Han committed
417
418
419
420
421
422
  if (error->error_code)
    set_error_detail(ctx, error->has_detail ? error->detail : NULL);

  return error->error_code;
}

Yaowu Xu's avatar
Yaowu Xu committed
423
static void init_buffer_callbacks(aom_codec_alg_priv_t *ctx) {
Jingning Han's avatar
Jingning Han committed
424
425
426
  int i;

  for (i = 0; i < ctx->num_frame_workers; ++i) {
Yaowu Xu's avatar
Yaowu Xu committed
427
    AVxWorker *const worker = &ctx->frame_workers[i];
Jingning Han's avatar
Jingning Han committed
428
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
Yaowu Xu's avatar
Yaowu Xu committed
429
    AV1_COMMON *const cm = &frame_worker_data->pbi->common;
Jingning Han's avatar
Jingning Han committed
430
431
432
433
434
435
436
437
438
439
440
    BufferPool *const pool = cm->buffer_pool;

    cm->new_fb_idx = INVALID_IDX;
    cm->byte_alignment = ctx->byte_alignment;
    cm->skip_loop_filter = ctx->skip_loop_filter;

    if (ctx->get_ext_fb_cb != NULL && ctx->release_ext_fb_cb != NULL) {
      pool->get_fb_cb = ctx->get_ext_fb_cb;
      pool->release_fb_cb = ctx->release_ext_fb_cb;
      pool->cb_priv = ctx->ext_priv;
    } else {
Yaowu Xu's avatar
Yaowu Xu committed
441
442
      pool->get_fb_cb = av1_get_frame_buffer;
      pool->release_fb_cb = av1_release_frame_buffer;
Jingning Han's avatar
Jingning Han committed
443

Yaowu Xu's avatar
Yaowu Xu committed
444
445
      if (av1_alloc_internal_frame_buffers(&pool->int_frame_buffers))
        aom_internal_error(&cm->error, AOM_CODEC_MEM_ERROR,
Jingning Han's avatar
Jingning Han committed
446
447
448
449
450
451
452
                           "Failed to initialize internal frame buffers");

      pool->cb_priv = &pool->int_frame_buffers;
    }
  }
}

Yaowu Xu's avatar
Yaowu Xu committed
453
454
static void set_default_ppflags(aom_postproc_cfg_t *cfg) {
  cfg->post_proc_flag = AOM_DEBLOCK | AOM_DEMACROBLOCK;
Jingning Han's avatar
Jingning Han committed
455
456
457
458
459
460
461
462
463
  cfg->deblocking_level = 4;
  cfg->noise_level = 0;
}

static int frame_worker_hook(void *arg1, void *arg2) {
  FrameWorkerData *const frame_worker_data = (FrameWorkerData *)arg1;
  const uint8_t *data = frame_worker_data->data;
  (void)arg2;

Yaowu Xu's avatar
Yaowu Xu committed
464
  frame_worker_data->result = av1_receive_compressed_data(
465
      frame_worker_data->pbi, frame_worker_data->data_size, &data);
Jingning Han's avatar
Jingning Han committed
466
467
  frame_worker_data->data_end = data;

468
  if (frame_worker_data->pbi->common.frame_parallel_decode) {
Jingning Han's avatar
Jingning Han committed
469
470
471
472
    // In frame parallel decoding, a worker thread must successfully decode all
    // the compressed data.
    if (frame_worker_data->result != 0 ||
        frame_worker_data->data + frame_worker_data->data_size - 1 > data) {
Yaowu Xu's avatar
Yaowu Xu committed
473
      AVxWorker *const worker = frame_worker_data->pbi->frame_worker_owner;
Jingning Han's avatar
Jingning Han committed
474
475
      BufferPool *const pool = frame_worker_data->pbi->common.buffer_pool;
      // Signal all the other threads that are waiting for this frame.
Yaowu Xu's avatar
Yaowu Xu committed
476
      av1_frameworker_lock_stats(worker);
Jingning Han's avatar
Jingning Han committed
477
478
479
480
481
      frame_worker_data->frame_context_ready = 1;
      lock_buffer_pool(pool);
      frame_worker_data->pbi->cur_buf->buf.corrupted = 1;
      unlock_buffer_pool(pool);
      frame_worker_data->pbi->need_resync = 1;
Yaowu Xu's avatar
Yaowu Xu committed
482
483
      av1_frameworker_signal_stats(worker);
      av1_frameworker_unlock_stats(worker);
Jingning Han's avatar
Jingning Han committed
484
485
486
487
488
489
490
491
492
493
      return 0;
    }
  } else if (frame_worker_data->result != 0) {
    // Check decode result in serial decode.
    frame_worker_data->pbi->cur_buf->buf.corrupted = 1;
    frame_worker_data->pbi->need_resync = 1;
  }
  return !frame_worker_data->result;
}

Yaowu Xu's avatar
Yaowu Xu committed
494
static aom_codec_err_t init_decoder(aom_codec_alg_priv_t *ctx) {
Jingning Han's avatar
Jingning Han committed
495
  int i;
Yaowu Xu's avatar
Yaowu Xu committed
496
  const AVxWorkerInterface *const winterface = aom_get_worker_interface();
Jingning Han's avatar
Jingning Han committed
497
498
499
500
501
502
503
504
505
506

  ctx->last_show_frame = -1;
  ctx->next_submit_worker_id = 0;
  ctx->last_submit_worker_id = 0;
  ctx->next_output_worker_id = 0;
  ctx->frame_cache_read = 0;
  ctx->frame_cache_write = 0;
  ctx->num_cache_frames = 0;
  ctx->need_resync = 1;
  ctx->num_frame_workers =
507
      (ctx->frame_parallel_decode == 1) ? ctx->cfg.threads : 1;
Jingning Han's avatar
Jingning Han committed
508
509
510
511
512
  if (ctx->num_frame_workers > MAX_DECODE_THREADS)
    ctx->num_frame_workers = MAX_DECODE_THREADS;
  ctx->available_threads = ctx->num_frame_workers;
  ctx->flushed = 0;

Yaowu Xu's avatar
Yaowu Xu committed
513
514
  ctx->buffer_pool = (BufferPool *)aom_calloc(1, sizeof(BufferPool));
  if (ctx->buffer_pool == NULL) return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
515
516

#if CONFIG_MULTITHREAD
517
518
  if (pthread_mutex_init(&ctx->buffer_pool->pool_mutex, NULL)) {
    set_error_detail(ctx, "Failed to allocate buffer pool mutex");
Yaowu Xu's avatar
Yaowu Xu committed
519
    return AOM_CODEC_MEM_ERROR;
520
  }
Jingning Han's avatar
Jingning Han committed
521
522
#endif

Yaowu Xu's avatar
Yaowu Xu committed
523
  ctx->frame_workers = (AVxWorker *)aom_malloc(ctx->num_frame_workers *
524
                                               sizeof(*ctx->frame_workers));
Jingning Han's avatar
Jingning Han committed
525
526
  if (ctx->frame_workers == NULL) {
    set_error_detail(ctx, "Failed to allocate frame_workers");
Yaowu Xu's avatar
Yaowu Xu committed
527
    return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
528
529
530
  }

  for (i = 0; i < ctx->num_frame_workers; ++i) {
Yaowu Xu's avatar
Yaowu Xu committed
531
    AVxWorker *const worker = &ctx->frame_workers[i];
Jingning Han's avatar
Jingning Han committed
532
533
    FrameWorkerData *frame_worker_data = NULL;
    winterface->init(worker);
Yaowu Xu's avatar
Yaowu Xu committed
534
    worker->data1 = aom_memalign(32, sizeof(FrameWorkerData));
Jingning Han's avatar
Jingning Han committed
535
536
    if (worker->data1 == NULL) {
      set_error_detail(ctx, "Failed to allocate frame_worker_data");
Yaowu Xu's avatar
Yaowu Xu committed
537
      return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
538
539
    }
    frame_worker_data = (FrameWorkerData *)worker->data1;
Yaowu Xu's avatar
Yaowu Xu committed
540
    frame_worker_data->pbi = av1_decoder_create(ctx->buffer_pool);
Jingning Han's avatar
Jingning Han committed
541
542
    if (frame_worker_data->pbi == NULL) {
      set_error_detail(ctx, "Failed to allocate frame_worker_data");
Yaowu Xu's avatar
Yaowu Xu committed
543
      return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
544
545
546
547
548
549
550
551
552
553
    }
    frame_worker_data->pbi->frame_worker_owner = worker;
    frame_worker_data->worker_id = i;
    frame_worker_data->scratch_buffer = NULL;
    frame_worker_data->scratch_buffer_size = 0;
    frame_worker_data->frame_context_ready = 0;
    frame_worker_data->received_frame = 0;
#if CONFIG_MULTITHREAD
    if (pthread_mutex_init(&frame_worker_data->stats_mutex, NULL)) {
      set_error_detail(ctx, "Failed to allocate frame_worker_data mutex");
Yaowu Xu's avatar
Yaowu Xu committed
554
      return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
555
556
557
558
    }

    if (pthread_cond_init(&frame_worker_data->stats_cond, NULL)) {
      set_error_detail(ctx, "Failed to allocate frame_worker_data cond");
Yaowu Xu's avatar
Yaowu Xu committed
559
      return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
560
561
    }
#endif
562
563
    frame_worker_data->pbi->allow_lowbitdepth = ctx->cfg.allow_lowbitdepth;

Jingning Han's avatar
Jingning Han committed
564
565
566
567
568
569
570
571
    // If decoding in serial mode, FrameWorker thread could create tile worker
    // thread or loopfilter thread.
    frame_worker_data->pbi->max_threads =
        (ctx->frame_parallel_decode == 0) ? ctx->cfg.threads : 0;

    frame_worker_data->pbi->inv_tile_order = ctx->invert_tile_order;
    frame_worker_data->pbi->common.frame_parallel_decode =
        ctx->frame_parallel_decode;
Yaowu Xu's avatar
Yaowu Xu committed
572
    worker->hook = (AVxWorkerHook)frame_worker_hook;
Jingning Han's avatar
Jingning Han committed
573
574
    if (!winterface->reset(worker)) {
      set_error_detail(ctx, "Frame Worker thread creation failed");
Yaowu Xu's avatar
Yaowu Xu committed
575
      return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
576
577
578
579
580
    }
  }

  // If postprocessing was enabled by the application and a
  // configuration has not been provided, default it.
Yaowu Xu's avatar
Yaowu Xu committed
581
  if (!ctx->postproc_cfg_set && (ctx->base.init_flags & AOM_CODEC_USE_POSTPROC))
Jingning Han's avatar
Jingning Han committed
582
583
584
585
    set_default_ppflags(&ctx->postproc_cfg);

  init_buffer_callbacks(ctx);

Yaowu Xu's avatar
Yaowu Xu committed
586
  return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
587
588
}

Yaowu Xu's avatar
Yaowu Xu committed
589
590
static INLINE void check_resync(aom_codec_alg_priv_t *const ctx,
                                const AV1Decoder *const pbi) {
Jingning Han's avatar
Jingning Han committed
591
592
593
594
595
596
  // Clear resync flag if worker got a key frame or intra only frame.
  if (ctx->need_resync == 1 && pbi->need_resync == 0 &&
      (pbi->common.intra_only || pbi->common.frame_type == KEY_FRAME))
    ctx->need_resync = 0;
}

Yaowu Xu's avatar
Yaowu Xu committed
597
static aom_codec_err_t decode_one(aom_codec_alg_priv_t *ctx,
Jingning Han's avatar
Jingning Han committed
598
599
                                  const uint8_t **data, unsigned int data_sz,
                                  void *user_priv, int64_t deadline) {
Yaowu Xu's avatar
Yaowu Xu committed
600
  const AVxWorkerInterface *const winterface = aom_get_worker_interface();
Jingning Han's avatar
Jingning Han committed
601
602
603
604
605
606
607
  (void)deadline;

  // Determine the stream parameters. Note that we rely on peek_si to
  // validate that we have a buffer that does not wrap around the top
  // of the heap.
  if (!ctx->si.h) {
    int is_intra_only = 0;
Yaowu Xu's avatar
Yaowu Xu committed
608
    const aom_codec_err_t res =
609
        decoder_peek_si_internal(*data, data_sz, &ctx->si, &is_intra_only);
Yaowu Xu's avatar
Yaowu Xu committed
610
    if (res != AOM_CODEC_OK) return res;
Jingning Han's avatar
Jingning Han committed
611

Yaowu Xu's avatar
Yaowu Xu committed
612
    if (!ctx->si.is_kf && !is_intra_only) return AOM_CODEC_ERROR;
Jingning Han's avatar
Jingning Han committed
613
614
615
  }

  if (!ctx->frame_parallel_decode) {
Yaowu Xu's avatar
Yaowu Xu committed
616
    AVxWorker *const worker = ctx->frame_workers;
Jingning Han's avatar
Jingning Han committed
617
618
619
620
621
622
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
    frame_worker_data->data = *data;
    frame_worker_data->data_size = data_sz;
    frame_worker_data->user_priv = user_priv;
    frame_worker_data->received_frame = 1;

623
624
625
626
#if CONFIG_INSPECTION
    frame_worker_data->pbi->inspect_cb = ctx->inspect_cb;
    frame_worker_data->pbi->inspect_ctx = ctx->inspect_ctx;
#endif
Jingning Han's avatar
Jingning Han committed
627

628
#if CONFIG_EXT_TILE
629
630
    frame_worker_data->pbi->dec_tile_row = ctx->decode_tile_row;
    frame_worker_data->pbi->dec_tile_col = ctx->decode_tile_col;
631
632
#endif  // CONFIG_EXT_TILE

Jingning Han's avatar
Jingning Han committed
633
634
635
636
637
638
639
640
641
642
643
    worker->had_error = 0;
    winterface->execute(worker);

    // Update data pointer after decode.
    *data = frame_worker_data->data_end;

    if (worker->had_error)
      return update_error_state(ctx, &frame_worker_data->pbi->common.error);

    check_resync(ctx, frame_worker_data->pbi);
  } else {
Yaowu Xu's avatar
Yaowu Xu committed
644
    AVxWorker *const worker = &ctx->frame_workers[ctx->next_submit_worker_id];
Jingning Han's avatar
Jingning Han committed
645
646
647
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
    // Copy context from last worker thread to next worker thread.
    if (ctx->next_submit_worker_id != ctx->last_submit_worker_id)
Yaowu Xu's avatar
Yaowu Xu committed
648
      av1_frameworker_copy_context(
Jingning Han's avatar
Jingning Han committed
649
650
651
652
653
654
655
656
657
          &ctx->frame_workers[ctx->next_submit_worker_id],
          &ctx->frame_workers[ctx->last_submit_worker_id]);

    frame_worker_data->pbi->ready_for_new_data = 0;
    // Copy the compressed data into worker's internal buffer.
    // TODO(hkuang): Will all the workers allocate the same size
    // as the size of the first intra frame be better? This will
    // avoid too many deallocate and allocate.
    if (frame_worker_data->scratch_buffer_size < data_sz) {
Alex Converse's avatar
Alex Converse committed
658
659
      aom_free(frame_worker_data->scratch_buffer);
      frame_worker_data->scratch_buffer = (uint8_t *)aom_malloc(data_sz);
Jingning Han's avatar
Jingning Han committed
660
661
      if (frame_worker_data->scratch_buffer == NULL) {
        set_error_detail(ctx, "Failed to reallocate scratch buffer");
Yaowu Xu's avatar
Yaowu Xu committed
662
        return AOM_CODEC_MEM_ERROR;
Jingning Han's avatar
Jingning Han committed
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
      }
      frame_worker_data->scratch_buffer_size = data_sz;
    }
    frame_worker_data->data_size = data_sz;
    memcpy(frame_worker_data->scratch_buffer, *data, data_sz);

    frame_worker_data->frame_decoded = 0;
    frame_worker_data->frame_context_ready = 0;
    frame_worker_data->received_frame = 1;
    frame_worker_data->data = frame_worker_data->scratch_buffer;
    frame_worker_data->user_priv = user_priv;

    if (ctx->next_submit_worker_id != ctx->last_submit_worker_id)
      ctx->last_submit_worker_id =
          (ctx->last_submit_worker_id + 1) % ctx->num_frame_workers;

    ctx->next_submit_worker_id =
        (ctx->next_submit_worker_id + 1) % ctx->num_frame_workers;
    --ctx->available_threads;
    worker->had_error = 0;
    winterface->launch(worker);
  }

Yaowu Xu's avatar
Yaowu Xu committed
686
  return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
687
688
}

Yaowu Xu's avatar
Yaowu Xu committed
689
static void wait_worker_and_cache_frame(aom_codec_alg_priv_t *ctx) {
Jingning Han's avatar
Jingning Han committed
690
  YV12_BUFFER_CONFIG sd;
Yaowu Xu's avatar
Yaowu Xu committed
691
692
  const AVxWorkerInterface *const winterface = aom_get_worker_interface();
  AVxWorker *const worker = &ctx->frame_workers[ctx->next_output_worker_id];
Jingning Han's avatar
Jingning Han committed
693
694
695
696
697
698
699
700
701
702
  FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
  ctx->next_output_worker_id =
      (ctx->next_output_worker_id + 1) % ctx->num_frame_workers;
  // TODO(hkuang): Add worker error handling here.
  winterface->sync(worker);
  frame_worker_data->received_frame = 0;
  ++ctx->available_threads;

  check_resync(ctx, frame_worker_data->pbi);

Yaowu Xu's avatar
Yaowu Xu committed
703
704
  if (av1_get_raw_frame(frame_worker_data->pbi, &sd) == 0) {
    AV1_COMMON *const cm = &frame_worker_data->pbi->common;
Jingning Han's avatar
Jingning Han committed
705
706
707
708
709
710
    RefCntBuffer *const frame_bufs = cm->buffer_pool->frame_bufs;
    ctx->frame_cache[ctx->frame_cache_write].fb_idx = cm->new_fb_idx;
    yuvconfig2image(&ctx->frame_cache[ctx->frame_cache_write].img, &sd,
                    frame_worker_data->user_priv);
    ctx->frame_cache[ctx->frame_cache_write].img.fb_priv =
        frame_bufs[cm->new_fb_idx].raw_frame_buffer.priv;
711
    ctx->frame_cache_write = (ctx->frame_cache_write + 1) % FRAME_CACHE_SIZE;
Jingning Han's avatar
Jingning Han committed
712
713
714
715
    ++ctx->num_cache_frames;
  }
}

Yaowu Xu's avatar
Yaowu Xu committed
716
static aom_codec_err_t decoder_decode(aom_codec_alg_priv_t *ctx,
Jingning Han's avatar
Jingning Han committed
717
718
719
                                      const uint8_t *data, unsigned int data_sz,
                                      void *user_priv, long deadline) {
  const uint8_t *data_start = data;
720
  const uint8_t *const data_end = data + data_sz;
Yaowu Xu's avatar
Yaowu Xu committed
721
  aom_codec_err_t res = AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
722
  uint32_t frame_sizes[8];
723
  int frame_count = 0;
Jingning Han's avatar
Jingning Han committed
724
725
726

  if (data == NULL && data_sz == 0) {
    ctx->flushed = 1;
Yaowu Xu's avatar
Yaowu Xu committed
727
    return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
728
729
730
731
732
733
734
  }

  // Reset flushed when receiving a valid frame.
  ctx->flushed = 0;

  // Initialize the decoder workers on the first frame.
  if (ctx->frame_workers == NULL) {
735
    res = init_decoder(ctx);
Yaowu Xu's avatar
Yaowu Xu committed
736
    if (res != AOM_CODEC_OK) return res;
Jingning Han's avatar
Jingning Han committed
737
  }
738
#if !CONFIG_OBU
739
  int index_size = 0;
Yaowu Xu's avatar
Yaowu Xu committed
740
  res = av1_parse_superframe_index(data, data_sz, frame_sizes, &frame_count,
741
                                   &index_size);
Yaowu Xu's avatar
Yaowu Xu committed
742
  if (res != AOM_CODEC_OK) return res;
Jingning Han's avatar
Jingning Han committed
743

744
  data_start += index_size;
745
#endif
Jingning Han's avatar
Jingning Han committed
746
747
748
749
750
751
752
753
754
755
756
  if (ctx->frame_parallel_decode) {
    // Decode in frame parallel mode. When decoding in this mode, the frame
    // passed to the decoder must be either a normal frame or a superframe with
    // superframe index so the decoder could get each frame's start position
    // in the superframe.
    if (frame_count > 0) {
      int i;

      for (i = 0; i < frame_count; ++i) {
        const uint8_t *data_start_copy = data_start;
        const uint32_t frame_size = frame_sizes[i];
757
758
        if (data_start < data ||
            frame_size > (uint32_t)(data_end - data_start)) {
Jingning Han's avatar
Jingning Han committed
759
          set_error_detail(ctx, "Invalid frame size in index");
Yaowu Xu's avatar
Yaowu Xu committed
760
          return AOM_CODEC_CORRUPT_FRAME;
Jingning Han's avatar
Jingning Han committed
761
762
763
764
765
766
767
768
769
770
        }

        if (ctx->available_threads == 0) {
          // No more threads for decoding. Wait until the next output worker
          // finishes decoding. Then copy the decoded frame into cache.
          if (ctx->num_cache_frames < FRAME_CACHE_SIZE) {
            wait_worker_and_cache_frame(ctx);
          } else {
            // TODO(hkuang): Add unit test to test this path.
            set_error_detail(ctx, "Frame output cache is full.");
Yaowu Xu's avatar
Yaowu Xu committed
771
            return AOM_CODEC_ERROR;
Jingning Han's avatar
Jingning Han committed
772
773
774
          }
        }

775
776
        res =
            decode_one(ctx, &data_start_copy, frame_size, user_priv, deadline);
Yaowu Xu's avatar
Yaowu Xu committed
777
        if (res != AOM_CODEC_OK) return res;
Jingning Han's avatar
Jingning Han committed
778
779
780
781
782
783
784
785
786
787
788
        data_start += frame_size;
      }
    } else {
      if (ctx->available_threads == 0) {
        // No more threads for decoding. Wait until the next output worker
        // finishes decoding. Then copy the decoded frame into cache.
        if (ctx->num_cache_frames < FRAME_CACHE_SIZE) {
          wait_worker_and_cache_frame(ctx);
        } else {
          // TODO(hkuang): Add unit test to test this path.
          set_error_detail(ctx, "Frame output cache is full.");
Yaowu Xu's avatar
Yaowu Xu committed
789
          return AOM_CODEC_ERROR;
Jingning Han's avatar
Jingning Han committed
790
791
792
793
        }
      }

      res = decode_one(ctx, &data, data_sz, user_priv, deadline);
Yaowu Xu's avatar
Yaowu Xu committed
794
      if (res != AOM_CODEC_OK) return res;
Jingning Han's avatar
Jingning Han committed
795
796
797
798
799
800
801
802
803
    }
  } else {
    // Decode in serial mode.
    if (frame_count > 0) {
      int i;

      for (i = 0; i < frame_count; ++i) {
        const uint8_t *data_start_copy = data_start;
        const uint32_t frame_size = frame_sizes[i];
804
805
        if (data_start < data ||
            frame_size > (uint32_t)(data_end - data_start)) {
Jingning Han's avatar
Jingning Han committed
806
          set_error_detail(ctx, "Invalid frame size in index");
Yaowu Xu's avatar
Yaowu Xu committed
807
          return AOM_CODEC_CORRUPT_FRAME;
Jingning Han's avatar
Jingning Han committed
808
809
        }

810
811
        res =
            decode_one(ctx, &data_start_copy, frame_size, user_priv, deadline);
Yaowu Xu's avatar
Yaowu Xu committed
812
        if (res != AOM_CODEC_OK) return res;
Jingning Han's avatar
Jingning Han committed
813
814
815
816
817

        data_start += frame_size;
      }
    } else {
      while (data_start < data_end) {
818
        const uint32_t frame_size = (uint32_t)(data_end - data_start);
819
        res = decode_one(ctx, &data_start, frame_size, user_priv, deadline);
Yaowu Xu's avatar
Yaowu Xu committed
820
        if (res != AOM_CODEC_OK) return res;
Jingning Han's avatar
Jingning Han committed
821
822
823

        // Account for suboptimal termination by the encoder.
        while (data_start < data_end) {
824
          const uint8_t marker = data_start[0];
825
          if (marker) break;
Jingning Han's avatar
Jingning Han committed
826
827
828
829
830
831
832
833
834
          ++data_start;
        }
      }
    }
  }

  return res;
}

Yaowu Xu's avatar
Yaowu Xu committed
835
static void release_last_output_frame(aom_codec_alg_priv_t *ctx) {
Jingning Han's avatar
Jingning Han committed
836
837
838
839
840
841
842
843
844
845
  RefCntBuffer *const frame_bufs = ctx->buffer_pool->frame_bufs;
  // Decrease reference count of last output frame in frame parallel mode.
  if (ctx->frame_parallel_decode && ctx->last_show_frame >= 0) {
    BufferPool *const pool = ctx->buffer_pool;
    lock_buffer_pool(pool);
    decrease_ref_count(ctx->last_show_frame, frame_bufs, pool);
    unlock_buffer_pool(pool);
  }
}

Yaowu Xu's avatar
Yaowu Xu committed
846
847
848
static aom_image_t *decoder_get_frame(aom_codec_alg_priv_t *ctx,
                                      aom_codec_iter_t *iter) {
  aom_image_t *img = NULL;
Jingning Han's avatar
Jingning Han committed
849
850
851
852
853
854
855
856
857
858
859

  // Only return frame when all the cpu are busy or
  // application fluhsed the decoder in frame parallel decode.
  if (ctx->frame_parallel_decode && ctx->available_threads > 0 &&
      !ctx->flushed) {
    return NULL;
  }

  // Output the frames in the cache first.
  if (ctx->num_cache_frames > 0) {
    release_last_output_frame(ctx);
860
861
    ctx->last_show_frame = ctx->frame_cache[ctx->frame_cache_read].fb_idx;
    if (ctx->need_resync) return NULL;
Jingning Han's avatar
Jingning Han committed
862
863
864
865
866
867
868
869
870
871
872
    img = &ctx->frame_cache[ctx->frame_cache_read].img;
    ctx->frame_cache_read = (ctx->frame_cache_read + 1) % FRAME_CACHE_SIZE;
    --ctx->num_cache_frames;
    return img;
  }

  // iter acts as a flip flop, so an image is only returned on the first
  // call to get_frame.
  if (*iter == NULL && ctx->frame_workers != NULL) {
    do {
      YV12_BUFFER_CONFIG sd;
Yaowu Xu's avatar
Yaowu Xu committed
873
874
      const AVxWorkerInterface *const winterface = aom_get_worker_interface();
      AVxWorker *const worker = &ctx->frame_workers[ctx->next_output_worker_id];
Jingning Han's avatar
Jingning Han committed
875
876
877
878
879
880
881
882
883
884
885
886
      FrameWorkerData *const frame_worker_data =
          (FrameWorkerData *)worker->data1;
      ctx->next_output_worker_id =
          (ctx->next_output_worker_id + 1) % ctx->num_frame_workers;
      // Wait for the frame from worker thread.
      if (winterface->sync(worker)) {
        // Check if worker has received any frames.
        if (frame_worker_data->received_frame == 1) {
          ++ctx->available_threads;
          frame_worker_data->received_frame = 0;
          check_resync(ctx, frame_worker_data->pbi);
        }
Yaowu Xu's avatar
Yaowu Xu committed
887
888
        if (av1_get_raw_frame(frame_worker_data->pbi, &sd) == 0) {
          AV1_COMMON *const cm = &frame_worker_data->pbi->common;
Jingning Han's avatar
Jingning Han committed
889
890
891
          RefCntBuffer *const frame_bufs = cm->buffer_pool->frame_bufs;
          release_last_output_frame(ctx);
          ctx->last_show_frame = frame_worker_data->pbi->common.new_fb_idx;
892
          if (ctx->need_resync) return NULL;
Jingning Han's avatar
Jingning Han committed
893
          yuvconfig2image(&ctx->img, &sd, frame_worker_data->user_priv);
894
895

#if CONFIG_EXT_TILE
896
          if (cm->single_tile_decoding &&
897
              frame_worker_data->pbi->dec_tile_row >= 0) {
898
            const int tile_row =
Yaowu Xu's avatar
Yaowu Xu committed
899
                AOMMIN(frame_worker_data->pbi->dec_tile_row, cm->tile_rows - 1);
900
901
902
903
904
            const int mi_row = tile_row * cm->tile_height;
            const int ssy = ctx->img.y_chroma_shift;
            int plane;
            ctx->img.planes[0] += mi_row * MI_SIZE * ctx->img.stride[0];
            for (plane = 1; plane < MAX_MB_PLANE; ++plane) {
905
906
              ctx->img.planes[plane] +=
                  mi_row * (MI_SIZE >> ssy) * ctx->img.stride[plane];
907
            }
908
            ctx->img.d_h =
Yaowu Xu's avatar
Yaowu Xu committed
909
                AOMMIN(cm->tile_height, cm->mi_rows - mi_row) * MI_SIZE;
910
911
          }

912
          if (cm->single_tile_decoding &&
913
              frame_worker_data->pbi->dec_tile_col >= 0) {
914
            const int tile_col =
Yaowu Xu's avatar
Yaowu Xu committed
915
                AOMMIN(frame_worker_data->pbi->dec_tile_col, cm->tile_cols - 1);
916
917
918
919
920
921
922
            const int mi_col = tile_col * cm->tile_width;
            const int ssx = ctx->img.x_chroma_shift;
            int plane;
            ctx->img.planes[0] += mi_col * MI_SIZE;
            for (plane = 1; plane < MAX_MB_PLANE; ++plane) {
              ctx->img.planes[plane] += mi_col * (MI_SIZE >> ssx);
            }
923
            ctx->img.d_w =
Yaowu Xu's avatar
Yaowu Xu committed
924
                AOMMIN(cm->tile_width, cm->mi_cols - mi_col) * MI_SIZE;
925
926
927
          }
#endif  // CONFIG_EXT_TILE

Jingning Han's avatar
Jingning Han committed
928
929
930
931
932
933
934
935
936
          ctx->img.fb_priv = frame_bufs[cm->new_fb_idx].raw_frame_buffer.priv;
          img = &ctx->img;
          return img;
        }
      } else {
        // Decoding failed. Release the worker thread.
        frame_worker_data->received_frame = 0;
        ++ctx->available_threads;
        ctx->need_resync = 1;
937
        if (ctx->flushed != 1) return NULL;
Jingning Han's avatar
Jingning Han committed
938
939
940
941
942
943
      }
    } while (ctx->next_output_worker_id != ctx->next_submit_worker_id);
  }
  return NULL;
}

Yaowu Xu's avatar
Yaowu Xu committed
944
945
946
static aom_codec_err_t decoder_set_fb_fn(
    aom_codec_alg_priv_t *ctx, aom_get_frame_buffer_cb_fn_t cb_get,
    aom_release_frame_buffer_cb_fn_t cb_release, void *cb_priv) {
Jingning Han's avatar
Jingning Han committed
947
  if (cb_get == NULL || cb_release == NULL) {
Yaowu Xu's avatar
Yaowu Xu committed
948
    return AOM_CODEC_INVALID_PARAM;
Jingning Han's avatar
Jingning Han committed
949
950
951
952
953
954
  } else if (ctx->frame_workers == NULL) {
    // If the decoder has already been initialized, do not accept changes to
    // the frame buffer functions.
    ctx->get_ext_fb_cb = cb_get;
    ctx->release_ext_fb_cb = cb_release;
    ctx->ext_priv = cb_priv;
Yaowu Xu's avatar
Yaowu Xu committed
955
    return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
956
957
  }

Yaowu Xu's avatar
Yaowu Xu committed
958
  return AOM_CODEC_ERROR;
Jingning Han's avatar
Jingning Han committed
959
960
}

Yaowu Xu's avatar
Yaowu Xu committed
961
static aom_codec_err_t ctrl_set_reference(aom_codec_alg_priv_t *ctx,
Jingning Han's avatar
Jingning Han committed
962
                                          va_list args) {
963
  av1_ref_frame_t *const data = va_arg(args, av1_ref_frame_t *);
Jingning Han's avatar
Jingning Han committed
964
965
966
967

  // Only support this function in serial decode.
  if (ctx->frame_parallel_decode) {
    set_error_detail(ctx, "Not supported in frame parallel decode");
Yaowu Xu's avatar
Yaowu Xu committed
968
    return AOM_CODEC_INCAPABLE;
Jingning Han's avatar
Jingning Han committed
969
970
971
  }

  if (data) {
972
    av1_ref_frame_t *const frame = data;
Jingning Han's avatar
Jingning Han committed
973
    YV12_BUFFER_CONFIG sd;
Yaowu Xu's avatar
Yaowu Xu committed
974
    AVxWorker *const worker = ctx->frame_workers;
Jingning Han's avatar
Jingning Han committed
975
976
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
    image2yuvconfig(&frame->img, &sd);
977
    return av1_set_reference_dec(&frame_worker_data->pbi->common, frame->idx,
Yaowu Xu's avatar
Yaowu Xu committed
978
                                 &sd);
Jingning Han's avatar
Jingning Han committed
979
  } else {
Yaowu Xu's avatar
Yaowu Xu committed
980
    return AOM_CODEC_INVALID_PARAM;
Jingning Han's avatar
Jingning Han committed
981
982
983
  }
}

Yaowu Xu's avatar
Yaowu Xu committed
984
static aom_codec_err_t ctrl_copy_reference(aom_codec_alg_priv_t *ctx,
Jingning Han's avatar
Jingning Han committed
985
                                           va_list args) {
986
  const av1_ref_frame_t *const frame = va_arg(args, av1_ref_frame_t *);
Jingning Han's avatar
Jingning Han committed
987
988
989
990

  // Only support this function in serial decode.
  if (ctx->frame_parallel_decode) {
    set_error_detail(ctx, "Not supported in frame parallel decode");
Yaowu Xu's avatar
Yaowu Xu committed
991
    return AOM_CODEC_INCAPABLE;
Jingning Han's avatar
Jingning Han committed
992
993
  }

Urvang Joshi's avatar
Urvang Joshi committed
994
  if (frame) {
Jingning Han's avatar
Jingning Han committed
995
    YV12_BUFFER_CONFIG sd;
Yaowu Xu's avatar
Yaowu Xu committed
996
    AVxWorker *const worker = ctx->frame_workers;
Jingning Han's avatar
Jingning Han committed
997
998
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
    image2yuvconfig(&frame->img, &sd);
999
    return av1_copy_reference_dec(frame_worker_data->pbi, frame->idx, &sd);
Jingning Han's avatar
Jingning Han committed
1000
  } else {
Yaowu Xu's avatar
Yaowu Xu committed
1001
    return AOM_CODEC_INVALID_PARAM;
Jingning Han's avatar
Jingning Han committed
1002
1003
1004
  }
}

Yaowu Xu's avatar
Yaowu Xu committed
1005
static aom_codec_err_t ctrl_get_reference(aom_codec_alg_priv_t *ctx,
Jingning Han's avatar
Jingning Han committed
1006
                                          va_list args) {
Yaowu Xu's avatar
Yaowu Xu committed
1007
  av1_ref_frame_t *data = va_arg(args, av1_ref_frame_t *);
Jingning Han's avatar
Jingning Han committed
1008
1009
1010
1011

  // Only support this function in serial decode.
  if (ctx->frame_parallel_decode) {
    set_error_detail(ctx, "Not supported in frame parallel decode");
Yaowu Xu's avatar
Yaowu Xu committed
1012
    return AOM_CODEC_INCAPABLE;
Jingning Han's avatar
Jingning Han committed
1013
1014
1015
  }

  if (data) {
1016
    YV12_BUFFER_CONFIG *fb;
Yaowu Xu's avatar
Yaowu Xu committed
1017
    AVxWorker *const worker = ctx->frame_workers;
Jingning Han's avatar
Jingning Han committed
1018
1019
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;
    fb = get_ref_frame(&frame_worker_data->pbi->common, data->idx);
Yaowu Xu's avatar
Yaowu Xu committed
1020
    if (fb == NULL) return AOM_CODEC_ERROR;
Jingning Han's avatar
Jingning Han committed
1021
    yuvconfig2image(&data->img, fb, NULL);
Yaowu Xu's avatar
Yaowu Xu committed
1022
    return AOM_CODEC_OK;
Jingning Han's avatar
Jingning Han committed
1023
  } else {
Yaowu Xu's avatar
Yaowu Xu committed
1024
    return AOM_CODEC_INVALID_PARAM;
Jingning Han's avatar
Jingning Han committed
1025
1026
1027
  }
}

Yaowu Xu's avatar
Yaowu Xu committed
1028
static aom_codec_err_t ctrl_get_new_frame_image(aom_codec_alg_priv_t *ctx,
1029
                                                va_list args) {
Yaowu Xu's avatar
Yaowu Xu committed
1030
  aom_image_t *new_img = va_arg(args, aom_image_t *);
1031
1032
1033
1034

  // Only support this function in serial decode.
  if (ctx->frame_parallel_decode) {
    set_error_detail(ctx, "Not supported in frame parallel decode");
Yaowu Xu's avatar
Yaowu Xu committed
1035
    return AOM_CODEC_INCAPABLE;
1036
1037
1038
1039
  }

  if (new_img) {
    YV12_BUFFER_CONFIG new_frame;
Yaowu Xu's avatar
Yaowu Xu committed
1040
    AVxWorker *const worker = ctx->frame_workers;
1041
1042
    FrameWorkerData *const frame_worker_data = (FrameWorkerData *)worker->data1;

Yaowu Xu's avatar
Yaowu Xu committed
1043
    if (av1_get_frame_to_show(frame_worker_data->pbi, &new_frame) == 0) {
1044
      yuvconfig2image(new_img, &new_frame, NULL);
Yaowu Xu's avatar
Yaowu Xu committed
1045
      return AOM_CODEC_OK;
1046
    } else {
Yaowu Xu's avatar
Yaowu Xu committed
1047
      return AOM_CODEC_ERROR;
1048
1049
    }
  } else {
Yaowu Xu's avatar
Yaowu Xu committed
1050
    return AOM_CODEC_INVALID_PARAM;
1051
1052
1053
  }
}