1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
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
79
80
81
82
83
84
85
86
87
88
89
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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
/*
Copyright 2018 Google Inc. All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS-IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
#ifndef RESONANCE_AUDIO_UTILS_BUFFER_UNPARTITIONER_H_
#define RESONANCE_AUDIO_UTILS_BUFFER_UNPARTITIONER_H_
#include <functional>
#include <memory>
#include "base/audio_buffer.h"
#include "base/logging.h"
namespace vraudio {
// Unpackages |AudioBuffer| into output buffers of arbitrary sizes.
class BufferUnpartitioner {
public:
// Callback to obtain input |AudioBuffer|s. Returns a nullptr if no buffers
// are available.
typedef std::function<const AudioBuffer*()> GetBufferCallback;
// Constructor.
//
// @param num_channels Number of audio channels in input and output buffers.
// @param frames_per_buffer Number of frames per input buffer.
// @param buffer_callback Callback to receive output |AudioBuffer|s.
BufferUnpartitioner(size_t num_channels, size_t frames_per_buffer,
GetBufferCallback buffer_callback);
// Returns the number of input buffers required for a given number of output
// frames and based on the current fill state of the internal |temp_buffer_|.
//
// @param num_output_frames Number of output frames.
// @return Number of required input |AudioBuffer|s.
size_t GetNumBuffersRequestedForNumInputFrames(
size_t num_output_frames) const;
// Returns the number of buffered frames in internal |temp_buffer_|.
size_t GetNumBufferedFrames() const;
// Requests an interleaved int16 output buffer. This method triggers
// |GetBufferCallback|.
//
// @param output_buffer Interleaved output buffer to write to.
// @param num_channels Number of channels in output buffer.
// @param num_frames Number of frames in output buffer.
// @return Number of frames actually written.
size_t GetBuffer(int16* output_buffer, size_t num_channels,
size_t num_frames);
// Requests an interleaved float output buffer. This method triggers
// |GetBufferCallback|.
//
// @param output_buffer Interleaved output buffer to write to.
// @param num_channels Number of channels in output buffer.
// @param num_frames Number of frames in output buffer.
// @return Number of frames actually written.
size_t GetBuffer(float* output_buffer, size_t num_channels,
size_t num_frames);
// Requests a planar int16 output buffer. This method triggers
// |GetBufferCallback|.
//
// @param output_buffer Planar output buffer to write to.
// @param num_channels Number of channels in output buffer.
// @param num_frames Number of frames in output buffer.
// @return Number of frames actually written.
size_t GetBuffer(int16** output_buffer, size_t num_channels,
size_t num_frames);
// Requests a planar float output buffer. This method triggers
// |GetBufferCallback|.
//
// @param output_buffer Planar output buffer to write to.
// @param num_channels Number of channels in output buffer.
// @param num_frames Number of frames in output buffer.
// @return Number of frames actually written.
size_t GetBuffer(float** output_buffer, size_t num_channels,
size_t num_frames);
// Clears internal temporary buffer that holds remaining audio frames.
void Clear();
private:
// Returns the number of frames that are buffered in |current_input_buffer_|.
//
// @return Number of frames in |current_input_buffer_|. If
// |current_input_buffer_| is undefined, it returns 0.
size_t GetNumFramesAvailableInBuffer() const;
// Writes output buffer into target buffer. Supported buffer types are planar
// and interleaved floating point abd interleaved int16 output. This method
// triggers |GetBufferCallback|.
//
// @tparam BufferType Output buffer type.
// @param buffer Output buffer to write to.
// @param num_channels Number of channels in output buffer.
// @param num_frames Number of frames in output buffer.
// @return Number of frames actually written.
template <typename BufferType>
size_t GetBufferTemplated(BufferType buffer, size_t num_channels,
size_t num_frames);
// Number of channels in output buffers.
const size_t num_channels_;
// Number of frames per buffer in output buffers.
const size_t frames_per_buffer_;
// Callback to request input |AudioBuffer|s.
const GetBufferCallback buffer_callback_;
// Temporary buffer containing remaining audio frames.
const AudioBuffer* current_input_buffer_; // Not owned.
// Current read position in |current_input_buffer_|.
size_t current_buffer_read_offset_frames_;
};
} // namespace vraudio
#endif // RESONANCE_AUDIO_UTILS_BUFFER_UNPARTITIONER_H_
|
