| /* |
| * Copyright (C) 2010 Google Inc. All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in the |
| * documentation and/or other materials provided with the distribution. |
| * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of |
| * its contributors may be used to endorse or promote products derived |
| * from this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY |
| * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED |
| * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
| * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY |
| * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES |
| * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
| * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND |
| * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
| * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| #ifndef THIRD_PARTY_BLINK_RENDERER_MODULES_WEBAUDIO_AUDIO_BUFFER_H_ |
| #define THIRD_PARTY_BLINK_RENDERER_MODULES_WEBAUDIO_AUDIO_BUFFER_H_ |
| |
| #include "base/memory/scoped_refptr.h" |
| #include "third_party/blink/renderer/core/typed_arrays/array_buffer_view_helpers.h" |
| #include "third_party/blink/renderer/core/typed_arrays/dom_typed_array.h" |
| #include "third_party/blink/renderer/modules/modules_export.h" |
| #include "third_party/blink/renderer/platform/bindings/script_wrappable.h" |
| #include "third_party/blink/renderer/platform/wtf/allocator/allocator.h" |
| #include "third_party/blink/renderer/platform/wtf/vector.h" |
| |
| namespace blink { |
| |
| class AudioBus; |
| class AudioBufferOptions; |
| class ExceptionState; |
| class SharedAudioBuffer; |
| |
| class MODULES_EXPORT AudioBuffer final : public ScriptWrappable { |
| DEFINE_WRAPPERTYPEINFO(); |
| |
| public: |
| static AudioBuffer* Create(unsigned number_of_channels, |
| uint32_t number_of_frames, |
| float sample_rate); |
| static AudioBuffer* Create(unsigned number_of_channels, |
| uint32_t number_of_frames, |
| float sample_rate, |
| ExceptionState&); |
| static AudioBuffer* Create(const AudioBufferOptions*, ExceptionState&); |
| |
| // Creates an AudioBuffer with uninitialized contents. This should |
| // only be used where we are guaranteed to initialize the contents |
| // with valid data and where JS cannot access until initializations |
| // is done. |OfflineAudioContext::startRendering()| is one such |
| // place. |
| static AudioBuffer* CreateUninitialized(unsigned number_of_channels, |
| uint32_t number_of_frames, |
| float sample_rate); |
| |
| static AudioBuffer* CreateFromAudioBus(AudioBus*); |
| |
| explicit AudioBuffer(AudioBus*); |
| // How to initialize the contents of an AudioBuffer. Default is to |
| // zero-initialize (|kZeroInitialize|). Otherwise, leave the array |
| // uninitialized (|kDontInitialize|). |
| enum InitializationPolicy { kZeroInitialize, kDontInitialize }; |
| AudioBuffer(unsigned number_of_channels, |
| uint32_t number_of_frames, |
| float sample_rate, |
| InitializationPolicy allocation_policy = kZeroInitialize); |
| |
| // Format |
| uint32_t length() const { return length_; } |
| double duration() const { |
| return length() / static_cast<double>(sampleRate()); |
| } |
| float sampleRate() const { return sample_rate_; } |
| |
| // Channel data access |
| unsigned numberOfChannels() const { return channels_.size(); } |
| NotShared<DOMFloat32Array> getChannelData(unsigned channel_index, |
| ExceptionState&); |
| NotShared<DOMFloat32Array> getChannelData(unsigned channel_index); |
| void copyFromChannel(NotShared<DOMFloat32Array>, |
| int32_t channel_number, |
| ExceptionState&); |
| void copyFromChannel(NotShared<DOMFloat32Array>, |
| int32_t channel_number, |
| size_t buffer_offset, |
| ExceptionState&); |
| void copyToChannel(NotShared<DOMFloat32Array>, |
| int32_t channel_number, |
| ExceptionState&); |
| void copyToChannel(NotShared<DOMFloat32Array>, |
| int32_t channel_number, |
| size_t buffer_offset, |
| ExceptionState&); |
| |
| void Zero(); |
| |
| void Trace(Visitor* visitor) const override { |
| visitor->Trace(channels_); |
| ScriptWrappable::Trace(visitor); |
| } |
| |
| std::unique_ptr<SharedAudioBuffer> CreateSharedAudioBuffer(); |
| |
| private: |
| static DOMFloat32Array* CreateFloat32ArrayOrNull( |
| uint32_t length, |
| InitializationPolicy allocation_policy = kZeroInitialize); |
| |
| bool CreatedSuccessfully(unsigned desired_number_of_channels) const; |
| |
| float sample_rate_; |
| uint32_t length_; |
| |
| HeapVector<Member<DOMFloat32Array>> channels_; |
| }; |
| |
| // Shared data that audio threads can hold onto. |
| class SharedAudioBuffer final { |
| USING_FAST_MALLOC(SharedAudioBuffer); |
| |
| public: |
| explicit SharedAudioBuffer(AudioBuffer*); |
| |
| unsigned numberOfChannels() const { return channels_.size(); } |
| uint32_t length() const { return length_; } |
| double duration() const { |
| return length() / static_cast<double>(sampleRate()); |
| } |
| float sampleRate() const { return sample_rate_; } |
| |
| const Vector<ArrayBufferContents>& channels() { return channels_; } |
| |
| void Zero(); |
| |
| private: |
| float sample_rate_; |
| uint32_t length_; |
| Vector<ArrayBufferContents> channels_; |
| }; |
| |
| } // namespace blink |
| |
| #endif // THIRD_PARTY_BLINK_RENDERER_MODULES_WEBAUDIO_AUDIO_BUFFER_H_ |