src/third_party/webrtc/modules/audio_coding/neteq4/tools/audio_loop.h

   1 /*
   2  *  Copyright (c) 2013 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_MODULES_AUDIO_CODING_NETEQ4_TOOLS_AUDIO_LOOP_H_
  12 #define WEBRTC_MODULES_AUDIO_CODING_NETEQ4_TOOLS_AUDIO_LOOP_H_
  13
  14 #include <string>
  15
  16 #include "webrtc/system_wrappers/interface/constructor_magic.h"
  17 #include "webrtc/system_wrappers/interface/scoped_ptr.h"
  18 #include "webrtc/typedefs.h"
  19
  20 namespace webrtc {
  21 namespace test {
  22
  23 // Class serving as an infinite source of audio, realized by looping an audio
  24 // clip.
  25 class AudioLoop {
  26  public:
  27   AudioLoop()
  28       : next_index_(0),
  29         loop_length_samples_(0),
  30         block_length_samples_(0),
  31         audio_array_(NULL) {
  32   }
  33
  34   virtual ~AudioLoop() {}
  35
  36   // Initializes the AudioLoop by reading from |file_name|. The loop will be no
  37   // longer than |max_loop_length_samples|, if the length of the file is
  38   // greater. Otherwise, the loop length is the same as the file length.
  39   // The audio will be delivered in blocks of |block_length_samples|.
  40   // Returns false if the initialization failed, otherwise true.
  41   bool Init(const std::string file_name, size_t max_loop_length_samples,
  42             size_t block_length_samples);
  43
  44   // Returns a pointer to the next block of audio. The number given as
  45   // |block_length_samples| to the Init() function determines how many samples
  46   // that can be safely read from the pointer.
  47   const int16_t* GetNextBlock();
  48
  49  private:
  50   size_t next_index_;
  51   size_t loop_length_samples_;
  52   size_t block_length_samples_;
  53   scoped_array<int16_t> audio_array_;
  54
  55   DISALLOW_COPY_AND_ASSIGN(AudioLoop);
  56 };
  57
  58 }  // namespace test
  59 }  // namespace webrtc
  60 #endif  // WEBRTC_MODULES_AUDIO_CODING_NETEQ4_TOOLS_AUDIO_LOOP_H_