15abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick/* 25abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * Copyright (C) 2010 Google Inc. All rights reserved. 35abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * 45abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * Redistribution and use in source and binary forms, with or without 55abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * modification, are permitted provided that the following conditions 65abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * are met: 75abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * 85abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * 1. Redistributions of source code must retain the above copyright 95abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * notice, this list of conditions and the following disclaimer. 105abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * 2. Redistributions in binary form must reproduce the above copyright 115abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * notice, this list of conditions and the following disclaimer in the 125abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * documentation and/or other materials provided with the distribution. 135abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of 145abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * its contributors may be used to endorse or promote products derived 155abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * from this software without specific prior written permission. 165abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * 175abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY 185abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 195abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 205abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY 215abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 225abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 235abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 245abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 255abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 265abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 275abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick */ 285abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 295abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#ifndef AudioBuffer_h 305abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#define AudioBuffer_h 315abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 325abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#include "Float32Array.h" 335abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#include <wtf/PassRefPtr.h> 345abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#include <wtf/RefCounted.h> 355abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#include <wtf/RefPtr.h> 365abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#include <wtf/Vector.h> 375abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 385abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merricknamespace WebCore { 395abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 405abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrickclass AudioBus; 415abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 425abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrickclass AudioBuffer : public RefCounted<AudioBuffer> { 435abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrickpublic: 445abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick static PassRefPtr<AudioBuffer> create(unsigned numberOfChannels, size_t numberOfFrames, double sampleRate); 455abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 465abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick // Returns 0 if data is not a valid audio file. 475abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick static PassRefPtr<AudioBuffer> createFromAudioFileData(const void* data, size_t dataSize, bool mixToMono, double sampleRate); 485abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 495abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick // Format 505abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick size_t length() const { return m_length; } 515abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick double duration() const { return length() / sampleRate(); } 525abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick double sampleRate() const { return m_sampleRate; } 535abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 545abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick // Channel data access 555abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick unsigned numberOfChannels() const { return m_channels.size(); } 565abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick Float32Array* getChannelData(unsigned channelIndex); 575abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick void zero(); 585abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 595abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick // Scalar gain 605abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick double gain() const { return m_gain; } 615abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick void setGain(double gain) { m_gain = gain; } 625abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 635abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick // Because an AudioBuffer has a JavaScript wrapper, which will be garbage collected, it may take awhile for this object to be deleted. 645abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick // releaseMemory() can be called when the AudioContext goes away, so we can release the memory earlier than when the garbage collection happens. 655abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick // Careful! Only call this when the page unloads, after the AudioContext is no longer processing. 665abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick void releaseMemory(); 675abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 685abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrickprotected: 695abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick AudioBuffer(unsigned numberOfChannels, size_t numberOfFrames, double sampleRate); 705abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick AudioBuffer(AudioBus* bus); 715abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 725abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick double m_gain; // scalar gain 735abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick double m_sampleRate; 745abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick size_t m_length; 755abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 765abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick Vector<RefPtr<Float32Array> > m_channels; 775abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick}; 785abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 795abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick} // namespace WebCore 805abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick 815abb8606fa57c3ebfc8b3c3dbc3fa4a25d2ae306Iain Merrick#endif // AudioBuffer_h 82