AOMedia AV1 Codec: lightfield_tile_list_decoder

| 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
40enum {
41 YUV1D, // 1D tile output for conformance test.
42 YUV, // Tile output in YUV format.
43 NV12, // Tile output in NV12 format.
44} UENUM1BYTE(OUTPUT_FORMAT);
45
46static const char *exec_name;
47
48void usage_exit(void) {
49 fprintf(stderr,
50 "Usage: %s <infile> <outfile> <num_references> <num_tile_lists> "
51 "<output format(optional)>\n",
52 exec_name);
53 exit(EXIT_FAILURE);
54}
55
56static void write_tile_yuv1d(aom_codec_ctx_t *codec, const aom_image_t *img,
57 FILE *file) {
58 // read out the tile size.
59 unsigned int tile_size = 0;
60 if (AOM_CODEC_CONTROL_TYPECHECKED(codec, AV1D_GET_TILE_SIZE, &tile_size))
61 die_codec(codec, "Failed to get the tile size");
62 const unsigned int tile_width = tile_size >> 16;
63 const unsigned int tile_height = tile_size & 65535;
64 const uint32_t output_frame_width_in_tiles = img->d_w / tile_width;
65
66 unsigned int tile_count = 0;
67 if (AOM_CODEC_CONTROL_TYPECHECKED(codec, AV1D_GET_TILE_COUNT, &tile_count))
68 die_codec(codec, "Failed to get the tile size");
69
70 // Write tile to file.
71 const int shift = (img->fmt & AOM_IMG_FMT_HIGHBITDEPTH) ? 1 : 0;
72 unsigned int tile_idx;
73
74 for (tile_idx = 0; tile_idx < tile_count; ++tile_idx) {
75 const int row_offset =
76 (tile_idx / output_frame_width_in_tiles) * tile_height;
77 const int col_offset =
78 (tile_idx % output_frame_width_in_tiles) * tile_width;
79 int plane;
80
81 for (plane = 0; plane < 3; ++plane) {
82 const unsigned char *buf = img->planes[plane];
83 const int stride = img->stride[plane];
84 const int roffset =
85 (plane > 0) ? row_offset >> img->y_chroma_shift : row_offset;
86 const int coffset =
87 (plane > 0) ? col_offset >> img->x_chroma_shift : col_offset;
88 const int w = (plane > 0) ? ((tile_width >> img->x_chroma_shift) << shift)
89 : (tile_width << shift);
90 const int h =
91 (plane > 0) ? (tile_height >> img->y_chroma_shift) : tile_height;
92 int y;
93
94 // col offset needs to be adjusted for HBD.
95 buf += roffset * stride + (coffset << shift);
96
97 for (y = 0; y < h; ++y) {
98 fwrite(buf, 1, w, file);
99 buf += stride;
100 }
101 }
102 }
103}
104
105int main(int argc, char **argv) {
106 FILE *outfile = NULL;
107 AvxVideoReader *reader = NULL;
108 const AvxVideoInfo *info = NULL;
109 int num_references;
110 int num_tile_lists;
111 aom_image_t reference_images[MAX_EXTERNAL_REFERENCES];
112 size_t frame_size = 0;
113 const unsigned char *frame = NULL;
114 int output_format = YUV1D;
115 int i, j, n;
116
117 exec_name = argv[0];
118
119 if (argc < 5) die("Invalid number of arguments.");
120
121 reader = aom_video_reader_open(argv[1]);
122 if (!reader) die("Failed to open %s for reading.", argv[1]);
123
124 if (!(outfile = fopen(argv[2], "wb")))
125 die("Failed to open %s for writing.", argv[2]);
126
127 num_references = (int)strtol(argv[3], NULL, 0);
128 num_tile_lists = (int)strtol(argv[4], NULL, 0);
129
130 if (argc > 5) output_format = (int)strtol(argv[5], NULL, 0);
131 if (output_format < YUV1D || output_format > NV12)
132 die("Output format out of range [0, 2]");
133
134 info = aom_video_reader_get_info(reader);
135
136 aom_codec_iface_t *decoder = get_aom_decoder_by_fourcc(info->codec_fourcc);
137 if (!decoder) die("Unknown input codec.");
138 printf("Using %s\n", aom_codec_iface_name(decoder));
139
140 aom_codec_ctx_t codec;
141 if (aom_codec_dec_init(&codec, decoder, NULL, 0))
142 die("Failed to initialize decoder.");
143
144 if (AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1D_SET_IS_ANNEXB,
145 info->is_annexb)) {
146 die_codec(&codec, "Failed to set annex b status");
147 }
148
149 // Decode anchor frames.
150 AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1_SET_TILE_MODE, 0);
151 for (i = 0; i < num_references; ++i) {
152 aom_video_reader_read_frame(reader);
153 frame = aom_video_reader_get_frame(reader, &frame_size);
154 if (aom_codec_decode(&codec, frame, frame_size, NULL))
155 die_codec(&codec, "Failed to decode frame.");
156
157 if (i == 0) {
158 aom_img_fmt_t ref_fmt = 0;
159 if (AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1D_GET_IMG_FORMAT, &ref_fmt))
160 die_codec(&codec, "Failed to get the image format");
161
162 int frame_res[2];
163 if (AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1D_GET_FRAME_SIZE, frame_res))
164 die_codec(&codec, "Failed to get the image frame size");
165
166 // Allocate memory to store decoded references. Allocate memory with the
167 // border so that it can be used as a reference.
168 for (j = 0; j < num_references; j++) {
169 unsigned int border = AOM_DEC_BORDER_IN_PIXELS;
170 if (!aom_img_alloc_with_border(&reference_images[j], ref_fmt,
171 frame_res[0], frame_res[1], 32, 8,
172 border)) {
173 fatal("Failed to allocate references.");
174 }
175 }
176 }
177
178 if (AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1_COPY_NEW_FRAME_IMAGE,
179 &reference_images[i]))
180 die_codec(&codec, "Failed to copy decoded reference frame");
181
182 aom_codec_iter_t iter = NULL;
183 aom_image_t *img = NULL;
184 while ((img = aom_codec_get_frame(&codec, &iter)) != NULL) {
185 char name[1024];
186 snprintf(name, sizeof(name), "ref_%d.yuv", i);
187 printf("writing ref image to %s, %u, %u\n", name, img->d_w, img->d_h);
188 FILE *ref_file = fopen(name, "wb");
189 if (!ref_file) {
190 fprintf(stderr, "Unable to open ref_file '%s'\n", name);
191 continue;
192 }
193 aom_img_write(img, ref_file);
194 fclose(ref_file);
195 }
196 }
197
198 // Decode the lightfield.
199 AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1_SET_TILE_MODE, 1);
200
201 // Set external references.
202 av1_ext_ref_frame_t set_ext_ref = { &reference_images[0], num_references };
203 AOM_CODEC_CONTROL_TYPECHECKED(&codec, AV1D_SET_EXT_REF_PTR, &set_ext_ref);
204 // Must decode the camera frame header first.
205 aom_video_reader_read_frame(reader);
206 frame = aom_video_reader_get_frame(reader, &frame_size);
207 if (aom_codec_decode(&codec, frame, frame_size, NULL))
208 die_codec(&codec, "Failed to decode the frame.");
209 // Decode tile lists one by one.
210 for (n = 0; n < num_tile_lists; n++) {
211 aom_video_reader_read_frame(reader);
212 frame = aom_video_reader_get_frame(reader, &frame_size);
213
214 if (aom_codec_decode(&codec, frame, frame_size, NULL))
215 die_codec(&codec, "Failed to decode the tile list.");
216 aom_codec_iter_t iter = NULL;
217 aom_image_t *img = aom_codec_get_frame(&codec, &iter);
218 if (!img) die_codec(&codec, "Failed to get frame.");
219
220 if (output_format == YUV1D)
221 // write the tile to the output file in 1D format.
222 write_tile_yuv1d(&codec, img, outfile);
223 else if (output_format == YUV)
224 aom_img_write(img, outfile);
225 else
226 // NV12 output format
227 aom_img_write_nv12(img, outfile);
228 }
229
230 for (i = 0; i < num_references; i++) aom_img_free(&reference_images[i]);
231 if (aom_codec_destroy(&codec)) die_codec(&codec, "Failed to destroy codec");
232 aom_video_reader_close(reader);
233 fclose(outfile);
234
235 return EXIT_SUCCESS;
236}
aom_decoder.h
Describes the decoder algorithm interface to applications.
aom_img_alloc_with_border
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.
AOM_IMG_FMT_HIGHBITDEPTH
#define AOM_IMG_FMT_HIGHBITDEPTH
Definition aom_image.h:38
aom_img_fmt_t
enum aom_img_fmt aom_img_fmt_t
List of supported image formats.
aom_image_t
struct aom_image aom_image_t
Image Descriptor.
aom_img_free
void aom_img_free(aom_image_t *img)
Close an image descriptor.
aomdx.h
Provides definitions for using AOM or AV1 within the aom Decoder interface.
enums.h
av1_ext_ref_frame_t
struct av1_ext_ref_frame av1_ext_ref_frame_t
Structure to hold the external reference frame pointer.
AV1_SET_TILE_MODE
@ AV1_SET_TILE_MODE
Codec control function to set the tile coding mode, unsigned int parameter.
Definition aomdx.h:316
AV1D_GET_FRAME_SIZE
@ AV1D_GET_FRAME_SIZE
Codec control function to get the dimensions that the current frame is decoded at,...
Definition aomdx.h:217
AV1D_SET_IS_ANNEXB
@ AV1D_SET_IS_ANNEXB
Codec control function to indicate whether bitstream is in Annex-B format, unsigned int parameter.
Definition aomdx.h:352
AV1D_GET_TILE_COUNT
@ AV1D_GET_TILE_COUNT
Codec control function to get the tile count in a tile list, unsigned int* parameter.
Definition aomdx.h:248
AV1D_GET_TILE_SIZE
@ AV1D_GET_TILE_SIZE
Codec control function to get the width and height (in pixels) of the tiles in a tile list,...
Definition aomdx.h:243
AV1D_GET_IMG_FORMAT
@ AV1D_GET_IMG_FORMAT
Codec control function to get the image format of the stream, aom_img_fmt_t* parameter.
Definition aomdx.h:235
AV1D_SET_EXT_REF_PTR
@ AV1D_SET_EXT_REF_PTR
Codec control function to set the external references' pointers in the decoder, av1_ext_ref_frame_t* ...
Definition aomdx.h:334
AV1_COPY_NEW_FRAME_IMAGE
@ AV1_COPY_NEW_FRAME_IMAGE
Codec control function to copy the new frame to an external buffer.
Definition aom.h:76
aom_codec_iface_name
const char * aom_codec_iface_name(aom_codec_iface_t *iface)
Return the name for a given interface.
aom_codec_ctx_t
struct aom_codec_ctx aom_codec_ctx_t
Codec context structure.
aom_codec_iface_t
const struct aom_codec_iface aom_codec_iface_t
Codec interface structure.
Definition aom_codec.h:271
aom_codec_destroy
aom_codec_err_t aom_codec_destroy(aom_codec_ctx_t *ctx)
Destroy a codec instance.
AOM_CODEC_CONTROL_TYPECHECKED
#define AOM_CODEC_CONTROL_TYPECHECKED(ctx, id, data)
aom_codec_control wrapper macro (adds type-checking, less flexible)
Definition aom_codec.h:542
aom_codec_iter_t
const void * aom_codec_iter_t
Iterator.
Definition aom_codec.h:305
aom_codec_get_frame
aom_image_t * aom_codec_get_frame(aom_codec_ctx_t *ctx, aom_codec_iter_t *iter)
Decoded frames iterator.
aom_codec_decode
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.
aom_codec_dec_init
#define aom_codec_dec_init(ctx, iface, cfg, flags)
Convenience macro for aom_codec_dec_init_ver().
Definition aom_decoder.h:133
aom_image::y_chroma_shift
unsigned int y_chroma_shift
Definition aom_image.h:277
aom_image::fmt
aom_img_fmt_t fmt
Definition aom_image.h:212
aom_image::stride
int stride[3]
Definition aom_image.h:292
aom_image::x_chroma_shift
unsigned int x_chroma_shift
Definition aom_image.h:276
aom_image::d_w
unsigned int d_w
Definition aom_image.h:268
aom_image::d_h
unsigned int d_h
Definition aom_image.h:269
aom_image::planes
unsigned char * planes[3]
Definition aom_image.h:286