1 /* 2 * Copyright (c) 2014 The WebM project authors. All Rights Reserved. 3 * 4 * Use of this source code is governed by a BSD-style license 5 * that can be found in the LICENSE file in the root of the source 6 * tree. An additional intellectual property rights grant can be found 7 * in the file PATENTS. All contributing project authors may 8 * be found in the AUTHORS file in the root of the source tree. 9 */ 10 11 #ifndef VIDEO_READER_H_ 12 #define VIDEO_READER_H_ 13 14 #include "./video_common.h" 15 16 // The following code is work in progress. It is going to support transparent 17 // reading of input files. Right now only IVF format is supported for 18 // simplicity. The main goal the API is to be simple and easy to use in example 19 // code and in vpxenc/vpxdec later. All low-level details like memory 20 // buffer management are hidden from API users. 21 struct VpxVideoReaderStruct; 22 typedef struct VpxVideoReaderStruct VpxVideoReader; 23 24 #ifdef __cplusplus 25 extern "C" { 26 #endif 27 28 // Opens the input file for reading and inspects it to determine file type. 29 // Returns an opaque VpxVideoReader* upon success, or NULL upon failure. 30 // Right now only IVF format is supported. 31 VpxVideoReader *vpx_video_reader_open(const char *filename); 32 33 // Frees all resources associated with VpxVideoReader* returned from 34 // vpx_video_reader_open() call. 35 void vpx_video_reader_close(VpxVideoReader *reader); 36 37 // Reads frame from the file and stores it in internal buffer. 38 int vpx_video_reader_read_frame(VpxVideoReader *reader); 39 40 // Returns the pointer to memory buffer with frame data read by last call to 41 // vpx_video_reader_read_frame(). 42 const uint8_t *vpx_video_reader_get_frame(VpxVideoReader *reader, 43 size_t *size); 44 45 // Fills VpxVideoInfo with information from opened video file. 46 const VpxVideoInfo *vpx_video_reader_get_info(VpxVideoReader *reader); 47 48 #ifdef __cplusplus 49 } // extern "C" 50 #endif 51 52 #endif // VIDEO_READER_H_ 53