AOMedia AV1 Codec: aom/aom_frame_buffer.h File Reference

| AOMedia AV1 Codec

aom_frame_buffer.h File Reference

Describes the decoder external frame buffer interface. More...

`#include "aom/aom_integer.h"`

Go to the source code of this file.

## Data Structures
struct | aom_codec_frame_buffer
| External frame buffer. More...

## Macros
#define | AOM_MAXIMUM_WORK_BUFFERS 8
| The maximum number of work buffers used by libaom. Support maximum 4 threads to decode video in parallel. Each thread will use one work buffer. TODO(hkuang): Add support to set number of worker threads dynamically.
#define | AOM_MAXIMUM_REF_BUFFERS 8
| The maximum number of reference buffers that a AV1 encoder may use.

## Typedefs
typedef struct aom_codec_frame_buffer | aom_codec_frame_buffer_t
| External frame buffer.
typedef int(* | aom_get_frame_buffer_cb_fn_t) (void *priv, size_t min_size, aom_codec_frame_buffer_t *fb)
| get frame buffer callback prototype
typedef int(* | aom_release_frame_buffer_cb_fn_t) (void *priv, aom_codec_frame_buffer_t *fb)
| release frame buffer callback prototype

## Detailed Description

Describes the decoder external frame buffer interface.

## Typedef Documentation

## ◆ aom_codec_frame_buffer_t

typedef struct aom_codec_frame_buffer aom_codec_frame_buffer_t

External frame buffer.

This structure holds allocated frame buffers used by the decoder.

## ◆ aom_get_frame_buffer_cb_fn_t

typedef int(* aom_get_frame_buffer_cb_fn_t) (void *priv, size_t min_size, aom_codec_frame_buffer_t *fb)

get frame buffer callback prototype

This callback is invoked by the decoder to retrieve data for the frame buffer in order for the decode call to complete. The callback must allocate at least min_size in bytes and assign it to fb->data. The callback must zero out all the data allocated. Then the callback must set fb->size to the allocated size. The application does not need to align the allocated data. The callback is triggered when the decoder needs a frame buffer to decode a compressed image into. This function may be called more than once for every call to aom_codec_decode. The application may set fb->priv to some data which will be passed back in the aom_image_t and the release function call. |fb| is guaranteed to not be NULL. On success the callback must return 0. Any failure the callback must return a value less than 0.

Parameters

  [in] | priv | Callback's private data
  [in] | min_size | Size in bytes needed by the buffer
  [in,out] | fb | Pointer to aom_codec_frame_buffer_t

## ◆ aom_release_frame_buffer_cb_fn_t

typedef int(* aom_release_frame_buffer_cb_fn_t) (void *priv, aom_codec_frame_buffer_t *fb)

release frame buffer callback prototype

This callback is invoked by the decoder when the frame buffer is not referenced by any other buffers. |fb| is guaranteed to not be NULL. On success the callback must return 0. Any failure the callback must return a value less than 0.

Parameters

  [in] | priv | Callback's private data
  [in] | fb | Pointer to aom_codec_frame_buffer_t