Home | History | Annotate | Download | only in testsupport
      1 /*
      2  *  Copyright (c) 2011 The WebRTC 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 WEBRTC_TEST_TESTSUPPORT_FRAME_READER_H_
     12 #define WEBRTC_TEST_TESTSUPPORT_FRAME_READER_H_
     13 
     14 #include <cstdio>
     15 #include <string>
     16 
     17 #include "typedefs.h"
     18 
     19 namespace webrtc {
     20 namespace test {
     21 
     22 // Handles reading of frames from video files.
     23 class FrameReader {
     24  public:
     25   virtual ~FrameReader() {}
     26 
     27   // Initializes the frame reader, i.e. opens the input file.
     28   // This must be called before reading of frames has started.
     29   // Returns false if an error has occurred, in addition to printing to stderr.
     30   virtual bool Init() = 0;
     31 
     32   // Reads a frame into the supplied buffer, which must contain enough space
     33   // for the frame size.
     34   // Returns true if there are more frames to read, false if we've already
     35   // read the last frame (in the previous call).
     36   virtual bool ReadFrame(WebRtc_UWord8* source_buffer) = 0;
     37 
     38   // Closes the input file if open. Essentially makes this class impossible
     39   // to use anymore. Will also be invoked by the destructor.
     40   virtual void Close() = 0;
     41 
     42   // Frame length in bytes of a single frame image.
     43   virtual int FrameLength() = 0;
     44   // Total number of frames in the input video source.
     45   virtual int NumberOfFrames() = 0;
     46 };
     47 
     48 class FrameReaderImpl : public FrameReader {
     49  public:
     50   // Creates a file handler. The input file is assumed to exist and be readable.
     51   // Parameters:
     52   //   input_filename          The file to read from.
     53   //   frame_length_in_bytes   The size of each frame.
     54   //                           For YUV this is 3 * width * height / 2
     55   FrameReaderImpl(std::string input_filename, int frame_length_in_bytes);
     56   virtual ~FrameReaderImpl();
     57   bool Init();
     58   bool ReadFrame(WebRtc_UWord8* source_buffer);
     59   void Close();
     60   int FrameLength() { return frame_length_in_bytes_; }
     61   int NumberOfFrames() { return number_of_frames_; }
     62 
     63  private:
     64   std::string input_filename_;
     65   int frame_length_in_bytes_;
     66   int number_of_frames_;
     67   FILE* input_file_;
     68 };
     69 
     70 }  // namespace test
     71 }  // namespace webrtc
     72 
     73 #endif  // WEBRTC_TEST_TESTSUPPORT_FRAME_READER_H_
     74