video_source.h 5.12 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11
/*
 *  Copyright (c) 2012 The WebM project authors. All Rights Reserved.
 *
 *  Use of this source code is governed by a BSD-style license
 *  that can be found in the LICENSE file in the root of the source
 *  tree. An additional intellectual property rights grant can be found
 *  in the file PATENTS.  All contributing project authors may
 *  be found in the AUTHORS file in the root of the source tree.
 */
#ifndef TEST_VIDEO_SOURCE_H_
#define TEST_VIDEO_SOURCE_H_
Johann's avatar
Johann committed
12

13 14 15
#include <cstdio>
#include <cstdlib>
#include <string>
Johann's avatar
Johann committed
16
#include "test/acm_random.h"
17 18 19 20
#include "vpx/vpx_encoder.h"

namespace libvpx_test {

21 22 23 24 25 26
// Helper macros to ensure LIBVPX_TEST_DATA_PATH is a quoted string.
// These are undefined right below GetDataPath
// NOTE: LIBVPX_TEST_DATA_PATH MUST NOT be a quoted string before
// Stringification or the GetDataPath will fail at runtime
#define TO_STRING(S) #S
#define STRINGIFY(S) TO_STRING(S)
27

28 29 30 31 32 33 34 35 36 37 38 39
// A simple function to encapsulate cross platform retrieval of test data path
static std::string GetDataPath() {
  const char *const data_path = getenv("LIBVPX_TEST_DATA_PATH");
  if (data_path == NULL) {
#ifdef LIBVPX_TEST_DATA_PATH
    // In some environments, we cannot set environment variables
    // Instead, we set the data path by using a preprocessor symbol
    // which can be set from make files
    return STRINGIFY(LIBVPX_TEST_DATA_PATH);
#else
    return ".";
#endif
40
  }
41 42
  return data_path;
}
43

44 45 46 47 48 49
// Undefining stringification macros because they are not used elsewhere
#undef TO_STRING
#undef STRINGIFY

static FILE *OpenTestDataFile(const std::string& file_name) {
  const std::string path_to_source = GetDataPath() + "/" + file_name;
50 51 52
  return fopen(path_to_source.c_str(), "rb");
}

53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
// Abstract base class for test video sources, which provide a stream of
// vpx_image_t images with associated timestamps and duration.
class VideoSource {
 public:
  virtual ~VideoSource() {}

  // Prepare the stream for reading, rewind/open as necessary.
  virtual void Begin() = 0;

  // Advance the cursor to the next frame
  virtual void Next() = 0;

  // Get the current video frame, or NULL on End-Of-Stream.
  virtual vpx_image_t *img() const = 0;

  // Get the presentation timestamp of the current frame.
  virtual vpx_codec_pts_t pts() const = 0;

  // Get the current frame's duration
  virtual unsigned long duration() const = 0;

  // Get the timebase for the stream
  virtual vpx_rational_t timebase() const = 0;

  // Get the current frame counter, starting at 0.
  virtual unsigned int frame() const = 0;
79 80 81

  // Get the current file limit.
  virtual unsigned int limit() const = 0;
82 83 84 85 86
};


class DummyVideoSource : public VideoSource {
 public:
87 88 89
  DummyVideoSource() : img_(NULL), limit_(100), width_(0), height_(0) {
    SetSize(80, 64);
  }
90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118

  virtual ~DummyVideoSource() { vpx_img_free(img_); }

  virtual void Begin() {
    frame_ = 0;
    FillFrame();
  }

  virtual void Next() {
    ++frame_;
    FillFrame();
  }

  virtual vpx_image_t *img() const {
    return (frame_ < limit_) ? img_ : NULL;
  }

  // Models a stream where Timebase = 1/FPS, so pts == frame.
  virtual vpx_codec_pts_t pts() const { return frame_; }

  virtual unsigned long duration() const { return 1; }

  virtual vpx_rational_t timebase() const {
    const vpx_rational_t t = {1, 30};
    return t;
  }

  virtual unsigned int frame() const { return frame_; }

119 120
  virtual unsigned int limit() const { return limit_; }

121
  void SetSize(unsigned int width, unsigned int height) {
122 123 124
    if (width != width_ || height != height_) {
      vpx_img_free(img_);
      raw_sz_ = ((width + 31)&~31) * height * 3 / 2;
125
      img_ = vpx_img_alloc(NULL, VPX_IMG_FMT_I420, width, height, 32);
126 127 128
      width_ = width;
      height_ = height;
    }
129 130 131 132 133 134 135 136 137
  }

 protected:
  virtual void FillFrame() { memset(img_->img_data, 0, raw_sz_); }

  vpx_image_t *img_;
  size_t       raw_sz_;
  unsigned int limit_;
  unsigned int frame_;
138 139
  unsigned int width_;
  unsigned int height_;
140 141 142 143
};


class RandomVideoSource : public DummyVideoSource {
Johann's avatar
Johann committed
144
 public:
Johann's avatar
Johann committed
145 146 147
  RandomVideoSource(int seed = ACMRandom::DeterministicSeed())
      : rnd_(seed),
        seed_(seed) { }
Johann's avatar
Johann committed
148

149
 protected:
Johann's avatar
Johann committed
150 151 152
  // Reset the RNG to get a matching stream for the second pass
  virtual void Begin() {
    frame_ = 0;
Johann's avatar
Johann committed
153
    rnd_.Reset(seed_);
Johann's avatar
Johann committed
154 155 156
    FillFrame();
  }

157 158 159 160 161
  // 15 frames of noise, followed by 15 static frames. Reset to 0 rather
  // than holding previous frames to encourage keyframes to be thrown.
  virtual void FillFrame() {
    if (frame_ % 30 < 15)
      for (size_t i = 0; i < raw_sz_; ++i)
Johann's avatar
Johann committed
162
        img_->img_data[i] = rnd_.Rand8();
163 164 165
    else
      memset(img_->img_data, 0, raw_sz_);
  }
Johann's avatar
Johann committed
166 167

  ACMRandom rnd_;
Johann's avatar
Johann committed
168
  int seed_;
169 170
};

171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186
// Abstract base class for test video sources, which provide a stream of
// decompressed images to the decoder.
class CompressedVideoSource {
 public:
  virtual ~CompressedVideoSource() {}

  virtual void Init() = 0;

  // Prepare the stream for reading, rewind/open as necessary.
  virtual void Begin() = 0;

  // Advance the cursor to the next frame
  virtual void Next() = 0;

  virtual const uint8_t *cxdata() const = 0;

187
  virtual size_t frame_size() const = 0;
188

189
  virtual unsigned int frame_number() const = 0;
190 191
};

192 193 194
}  // namespace libvpx_test

#endif  // TEST_VIDEO_SOURCE_H_