AOMedia AV1 Codec
lightfield_tile_list_decoder
1 /*
2  * Copyright (c) 2018, 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 // Lightfield Tile List Decoder
13 // ============================
14 //
15 // This is a lightfield tile list decoder example. It takes an input file that
16 // contains the anchor frames that are references of the coded tiles, the camera
17 // frame header, and tile list OBUs that include the tile information and the
18 // compressed tile data. This input file is reconstructed from the encoded
19 // lightfield ivf file, and is decodable by AV1 decoder. num_references is
20 // the number of anchor frames coded at the beginning of the light field file.
21 // num_tile_lists is the number of tile lists need to be decoded. There is an
22 // optional parameter allowing to choose the output format, and the supported
23 // formats are YUV1D(default), YUV, and NV12.
24 // Run lightfield tile list decoder to decode an AV1 tile list file:
25 // examples/lightfield_tile_list_decoder vase_tile_list.ivf vase_tile_list.yuv
26 // 4 2 0(optional)
27 
28 #include <stdio.h>
29 #include <stdlib.h>
30 #include <string.h>
31 #include <assert.h>
32 
33 #include "aom/aom_decoder.h"
34 #include "aom/aomdx.h"
35 #include "aom_scale/yv12config.h"
36 #include "av1/common/enums.h"
37 #include "common/tools_common.h"
38 #include "common/video_reader.h"
39 
40 static const char *exec_name;
41 
42 void usage_exit(void) {
43  fprintf(stderr,
44  "Usage: %s <infile> <outfile> <num_references> <num_tile_lists> "
45  "<output format(optional)>\n",
46  exec_name);
47  exit(EXIT_FAILURE);
48 }
49 
50 static void write_tile_yuv1d(aom_codec_ctx_t *codec, const aom_image_t *img,
51  FILE *file) {
52  // read out the tile size.
53  unsigned int tile_size = 0;
54  if (AOM_CODEC_CONTROL_TYPECHECKED(codec, AV1D_GET_TILE_SIZE, &tile_size))
55  die_codec(codec, "Failed to get the tile size");
56  const unsigned int tile_width = tile_size >> 16;
57  const unsigned int tile_height = tile_size & 65535;
58  const uint32_t output_frame_width_in_tiles = img->d_w / tile_width;
59 
60  unsigned int tile_count = 0;
61  if (AOM_CODEC_CONTROL_TYPECHECKED(codec, AV1D_GET_TILE_COUNT, &tile_count))
62  die_codec(codec, "Failed to get the tile size");
63 
64  // Write tile to file.
65  const int shift = (img->fmt & AOM_IMG_FMT_HIGHBITDEPTH) ? 1 : 0;
66  unsigned int tile_idx;
67 
68  for (tile_idx = 0; tile_idx < tile_count; ++tile_idx) {
69  const int row_offset =
70  (tile_idx / output_frame_width_in_tiles) * tile_height;
71  const int col_offset =
72  (tile_idx % output_frame_width_in_tiles) * tile_width;
73  int plane;
74 
75  for (plane = 0; plane < 3; ++plane) {
76  const unsigned char *buf = img->planes[plane];
77  const int stride = img->stride[plane];
78  const int roffset =
79  (plane > 0) ? row_offset >> img->y_chroma_shift : row_offset;
80  const int coffset =
81  (plane > 0) ? col_offset >> img->x_chroma_shift : col_offset;
82  const int w = (plane > 0) ? ((tile_width >> img->x_chroma_shift) << shift)
83  : (tile_width << shift);
84  const int h =
85  (plane > 0) ? (tile_height >> img->y_chroma_shift) : tile_height;
86  int y;
87 
88  // col offset needs to be adjusted for HBD.
89  buf += roffset * stride + (coffset << shift);
90 
91  for (y = 0; y < h; ++y) {
92  fwrite(buf, 1, w, file);
93  buf += stride;
94  }
95  }
96  }
97 }
98 
99 int main(int argc, char **argv) {
100  FILE *outfile = NULL;
101  AvxVideoReader *reader = NULL;
102  const AvxVideoInfo *info = NULL;
103  int num_references;
104  int num_tile_lists;
105  aom_image_t reference_images[MAX_EXTERNAL_REFERENCES];
106  size_t frame_size = 0;
107  const unsigned char *frame = NULL;
108  int output_format = YUV1D;
109  int i, j, n;
110 
111  exec_name = argv[0];
112 
113  if (argc < 5) die("Invalid number of arguments.");
114 
115  reader = aom_video_reader_open(argv[1]);
116  if (!reader) die("Failed to open %s for reading.", argv[1]);
117 
118  if (!(outfile = fopen(argv[2], "wb")))
119  die("Failed to open %s for writing.", argv[2]);
120 
121  num_references = (int)strtol(argv[3], NULL, 0);
122  num_tile_lists = (int)strtol(argv[4], NULL, 0);
123 
124  if (argc > 5) output_format = (int)strtol(argv[5], NULL, 0);
125  if (output_format < YUV1D || output_format > NV12)
126  die("Output format out of range [0, 2]");
127 
128  info = aom_video_reader_get_info(reader);
129 
130  aom_codec_iface_t *decoder = get_aom_decoder_by_fourcc(info->codec_fourcc);
131  if (!decoder) die("Unknown input codec.");
132  printf("Using %s\n", aom_codec_iface_name(decoder));
133 
134  aom_codec_ctx_t codec;
135  if (aom_codec_dec_init(&codec, decoder, NULL, 0))
136  die("Failed to initialize decoder.");
137 
139  info->is_annexb)) {
140  die_codec(&codec, "Failed to set annex b status");
141  }
142 
143  // Decode anchor frames.
145  for (i = 0; i < num_references; ++i) {
146  aom_video_reader_read_frame(reader);
147  frame = aom_video_reader_get_frame(reader, &frame_size);
148  if (aom_codec_decode(&codec, frame, frame_size, NULL))
149  die_codec(&codec, "Failed to decode frame.");
150 
151  if (i == 0) {
152  aom_img_fmt_t ref_fmt = 0;
153  if (AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1D_GET_IMG_FORMAT, &ref_fmt))
154  die_codec(&codec, "Failed to get the image format");
155 
156  int frame_res[2];
157  if (AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1D_GET_FRAME_SIZE, frame_res))
158  die_codec(&codec, "Failed to get the image frame size");
159 
160  // Allocate memory to store decoded references. Allocate memory with the
161  // border so that it can be used as a reference.
162  for (j = 0; j < num_references; j++) {
163  unsigned int border = AOM_DEC_BORDER_IN_PIXELS;
164  if (!aom_img_alloc_with_border(&reference_images[j], ref_fmt,
165  frame_res[0], frame_res[1], 32, 8,
166  border)) {
167  die("Failed to allocate references.");
168  }
169  }
170  }
171 
173  &reference_images[i]))
174  die_codec(&codec, "Failed to copy decoded reference frame");
175 
176  aom_codec_iter_t iter = NULL;
177  aom_image_t *img = NULL;
178  while ((img = aom_codec_get_frame(&codec, &iter)) != NULL) {
179  char name[1024];
180  snprintf(name, sizeof(name), "ref_%d.yuv", i);
181  printf("writing ref image to %s, %u, %u\n", name, img->d_w, img->d_h);
182  FILE *ref_file = fopen(name, "wb");
183  aom_img_write(img, ref_file);
184  fclose(ref_file);
185  }
186  }
187 
188  // Decode the lightfield.
190 
191  // Set external references.
192  av1_ext_ref_frame_t set_ext_ref = { &reference_images[0], num_references };
194  // Must decode the camera frame header first.
195  aom_video_reader_read_frame(reader);
196  frame = aom_video_reader_get_frame(reader, &frame_size);
197  if (aom_codec_decode(&codec, frame, frame_size, NULL))
198  die_codec(&codec, "Failed to decode the frame.");
199  // Decode tile lists one by one.
200  for (n = 0; n < num_tile_lists; n++) {
201  aom_video_reader_read_frame(reader);
202  frame = aom_video_reader_get_frame(reader, &frame_size);
203 
204  if (aom_codec_decode(&codec, frame, frame_size, NULL))
205  die_codec(&codec, "Failed to decode the tile list.");
206  aom_codec_iter_t iter = NULL;
207  aom_image_t *img = aom_codec_get_frame(&codec, &iter);
208  if (!img) die_codec(&codec, "Failed to get frame.");
209 
210  if (output_format == YUV1D)
211  // write the tile to the output file in 1D format.
212  write_tile_yuv1d(&codec, img, outfile);
213  else if (output_format == YUV)
214  aom_img_write(img, outfile);
215  else
216  // NV12 output format
217  aom_img_write_nv12(img, outfile);
218  }
219 
220  for (i = 0; i < num_references; i++) aom_img_free(&reference_images[i]);
221  if (aom_codec_destroy(&codec)) die_codec(&codec, "Failed to destroy codec");
222  aom_video_reader_close(reader);
223  fclose(outfile);
224 
225  return EXIT_SUCCESS;
226 }
unsigned int d_h
Definition: aom_image.h:187
#define AOM_CODEC_CONTROL_TYPECHECKED(ctx, id, data)
aom_codec_control wrapper macro (adds type-checking, less flexible)
Definition: aom_codec.h:520
aom_image_t * aom_codec_get_frame(aom_codec_ctx_t *ctx, aom_codec_iter_t *iter)
Decoded frames iterator.
Codec control function to get the tile count in a tile list, int* parameter.
Definition: aomdx.h:242
enum aom_img_fmt aom_img_fmt_t
List of supported image formats.
unsigned char * planes[3]
Definition: aom_image.h:202
Codec control function to indicate whether bitstream is in Annex-B format, unsigned int parameter...
Definition: aomdx.h:345
Codec context structure.
Definition: aom_codec.h:298
Codec control function to get the size of the tile, unsigned int parameter.
Definition: aomdx.h:237
#define AOM_IMG_FMT_HIGHBITDEPTH
Definition: aom_image.h:38
unsigned int y_chroma_shift
Definition: aom_image.h:195
Describes the decoder algorithm interface to applications.
Codec control function to set the external references&#39; pointers in the decoder, av1_ext_ref_frame_t* ...
Definition: aomdx.h:327
Codec control function to get the dimensions that the current frame is decoded at, int* parameter. This may be different to the intended display size for the frame as specified in the wrapper or frame header (see AV1D_GET_DISPLAY_SIZE).
Definition: aomdx.h:216
Image Descriptor.
Definition: aom_image.h:171
aom_codec_err_t aom_codec_decode(aom_codec_ctx_t *ctx, const uint8_t *data, size_t data_sz, void *user_priv)
Decode data.
const struct aom_codec_iface aom_codec_iface_t
Codec interface structure.
Definition: aom_codec.h:254
#define aom_codec_dec_init(ctx, iface, cfg, flags)
Convenience macro for aom_codec_dec_init_ver()
Definition: aom_decoder.h:129
const char * aom_codec_iface_name(aom_codec_iface_t *iface)
Return the name for a given interface.
aom_codec_err_t aom_codec_destroy(aom_codec_ctx_t *ctx)
Destroy a codec instance.
aom_image_t * aom_img_alloc_with_border(aom_image_t *img, aom_img_fmt_t fmt, unsigned int d_w, unsigned int d_h, unsigned int align, unsigned int size_align, unsigned int border)
Open a descriptor, allocating storage for the underlying image with a border.
Codec control function to get the image format of the stream, aom_img_fmt_t* parameter.
Definition: aomdx.h:233
void aom_img_free(aom_image_t *img)
Close an image descriptor.
Codec control function to copy the new frame to an external buffer.
Definition: aom.h:76
const void * aom_codec_iter_t
Iterator.
Definition: aom_codec.h:288
unsigned int x_chroma_shift
Definition: aom_image.h:194
Codec control function to set the tile coding mode, int parameter.
Definition: aomdx.h:309
Structure to hold the external reference frame pointer.
Definition: aomdx.h:179
Provides definitions for using AOM or AV1 within the aom Decoder interface.
int stride[3]
Definition: aom_image.h:203
unsigned int d_w
Definition: aom_image.h:186
aom_img_fmt_t fmt
Definition: aom_image.h:172