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_NETEQ_TOOLS_AUDIO_LOOP_H_
12#define WEBRTC_MODULES_AUDIO_CODING_NETEQ_TOOLS_AUDIO_LOOP_H_
13
14#include <string>
15
16#include "webrtc/base/array_view.h"
17#include "webrtc/base/constructormagic.h"
18#include "webrtc/base/scoped_ptr.h"
19#include "webrtc/typedefs.h"
20
21namespace webrtc {
22namespace test {
23
24// Class serving as an infinite source of audio, realized by looping an audio
25// clip.
26class AudioLoop {
27 public:
28  AudioLoop()
29      : next_index_(0),
30        loop_length_samples_(0),
31        block_length_samples_(0) {
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,size) pair for the next block of audio. The size is
45  // equal to the |block_length_samples| Init() argument.
46  rtc::ArrayView<const int16_t> GetNextBlock();
47
48 private:
49  size_t next_index_;
50  size_t loop_length_samples_;
51  size_t block_length_samples_;
52  rtc::scoped_ptr<int16_t[]> audio_array_;
53
54  RTC_DISALLOW_COPY_AND_ASSIGN(AudioLoop);
55};
56
57}  // namespace test
58}  // namespace webrtc
59#endif  // WEBRTC_MODULES_AUDIO_CODING_NETEQ_TOOLS_AUDIO_LOOP_H_
60