video_reader.h 1.96 KB
Newer Older
1
/*
2
 * Copyright (c) 2016, Alliance for Open Media. All rights reserved
3
 *
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.
10 11 12 13 14 15 16 17 18 19
 */

#ifndef VIDEO_READER_H_
#define VIDEO_READER_H_

#include "./video_common.h"

// The following code is work in progress. It is going to  support transparent
// reading of input files. Right now only IVF format is supported for
// simplicity. The main goal the API is to be simple and easy to use in example
20
// code and in aomenc/aomdec later. All low-level details like memory
21
// buffer management are hidden from API users.
22 23
struct AvxVideoReaderStruct;
typedef struct AvxVideoReaderStruct AvxVideoReader;
24 25 26 27 28 29

#ifdef __cplusplus
extern "C" {
#endif

// Opens the input file for reading and inspects it to determine file type.
30
// Returns an opaque AvxVideoReader* upon success, or NULL upon failure.
31
// Right now only IVF format is supported.
32
AvxVideoReader *aom_video_reader_open(const char *filename);
33

34 35 36
// Frees all resources associated with AvxVideoReader* returned from
// aom_video_reader_open() call.
void aom_video_reader_close(AvxVideoReader *reader);
37 38

// Reads frame from the file and stores it in internal buffer.
39
int aom_video_reader_read_frame(AvxVideoReader *reader);
40 41

// Returns the pointer to memory buffer with frame data read by last call to
42 43
// aom_video_reader_read_frame().
const uint8_t *aom_video_reader_get_frame(AvxVideoReader *reader, size_t *size);
44

45 46
// Fills AvxVideoInfo with information from opened video file.
const AvxVideoInfo *aom_video_reader_get_info(AvxVideoReader *reader);
47 48 49 50 51 52

#ifdef __cplusplus
}  // extern "C"
#endif

#endif  // VIDEO_READER_H_