2010-09-03 Chris Rogers <crogers@google.com>
authorcrogers@google.com <crogers@google.com@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Fri, 3 Sep 2010 19:19:03 +0000 (19:19 +0000)
committercrogers@google.com <crogers@google.com@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Fri, 3 Sep 2010 19:19:03 +0000 (19:19 +0000)
        Reviewed by Kenneth Russell.

        audio engine: add AudioChannel files
        https://bugs.webkit.org/show_bug.cgi?id=44921

        No new tests since audio API is not yet implemented.

        * platform/audio/AudioChannel.cpp: Added.
        (WebCore::AudioChannel::scale):
        (WebCore::AudioChannel::copyFrom):
        (WebCore::AudioChannel::copyFromRange):
        (WebCore::AudioChannel::sumFrom):
        (WebCore::AudioChannel::maxAbsValue):
        * platform/audio/AudioChannel.h: Added.
        (WebCore::AudioChannel::AudioChannel):
        (WebCore::AudioChannel::set):
        (WebCore::AudioChannel::length):
        (WebCore::AudioChannel::data):
        (WebCore::AudioChannel::zero):

git-svn-id: https://svn.webkit.org/repository/webkit/trunk@66758 268f45cc-cd09-0410-ab3c-d52691b4dbfc

WebCore/ChangeLog
WebCore/platform/audio/AudioChannel.cpp [new file with mode: 0644]
WebCore/platform/audio/AudioChannel.h [new file with mode: 0644]

index 9dffc9f6f2eab293516c80568da05293bc3f938a..0c44b525fcb15b7ee7643a88db35910b7c47d856 100644 (file)
@@ -1,3 +1,25 @@
+2010-09-03  Chris Rogers  <crogers@google.com>
+
+        Reviewed by Kenneth Russell.
+
+        audio engine: add AudioChannel files
+        https://bugs.webkit.org/show_bug.cgi?id=44921
+
+        No new tests since audio API is not yet implemented.
+
+        * platform/audio/AudioChannel.cpp: Added.
+        (WebCore::AudioChannel::scale):
+        (WebCore::AudioChannel::copyFrom):
+        (WebCore::AudioChannel::copyFromRange):
+        (WebCore::AudioChannel::sumFrom):
+        (WebCore::AudioChannel::maxAbsValue):
+        * platform/audio/AudioChannel.h: Added.
+        (WebCore::AudioChannel::AudioChannel):
+        (WebCore::AudioChannel::set):
+        (WebCore::AudioChannel::length):
+        (WebCore::AudioChannel::data):
+        (WebCore::AudioChannel::zero):
+
 2010-09-03  Patrick Gansterer  <paroga@paroga.com>
 
         Reviewed by Adam Roben.
diff --git a/WebCore/platform/audio/AudioChannel.cpp b/WebCore/platform/audio/AudioChannel.cpp
new file mode 100644 (file)
index 0000000..ad38219
--- /dev/null
@@ -0,0 +1,102 @@
+/*
+ * 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.
+ */
+
+#include "config.h"
+
+#if ENABLE(WEB_AUDIO)
+
+#include "AudioChannel.h"
+
+#include "Accelerate.h"
+#include <algorithm>
+#include <math.h>
+#include <wtf/OwnPtr.h>
+
+namespace WebCore {
+
+void AudioChannel::scale(double scale)
+{
+    float s = static_cast<float>(scale);
+    vsmul(data(), 1, &s, data(), 1, length());
+}
+
+void AudioChannel::copyFrom(const AudioChannel* sourceChannel)
+{
+    bool isSafe = (sourceChannel && sourceChannel->length() >= length());
+    ASSERT(isSafe);
+    if (!isSafe)
+        return;
+
+    memcpy(data(), sourceChannel->data(), sizeof(float) * length());
+}
+
+void AudioChannel::copyFromRange(const AudioChannel* sourceChannel, unsigned startFrame, unsigned endFrame)
+{
+    // Check that range is safe for reading from sourceChannel.
+    bool isRangeSafe = sourceChannel && startFrame < endFrame && endFrame <= sourceChannel->length();
+    ASSERT(isRangeSafe);
+    if (!isRangeSafe)
+        return;
+
+    // Check that this channel has enough space.
+    size_t rangeLength = endFrame - startFrame;
+    bool isRangeLengthSafe = rangeLength <= length();
+    ASSERT(isRangeLengthSafe);
+    if (!isRangeLengthSafe)
+        return;
+
+    const float* source = sourceChannel->data();
+    float* destination = data();
+    memcpy(destination, source + startFrame, sizeof(float) * rangeLength);
+}
+
+void AudioChannel::sumFrom(const AudioChannel* sourceChannel)
+{
+    bool isSafe = sourceChannel && sourceChannel->length() >= length();
+    ASSERT(isSafe);
+    if (!isSafe)
+        return;
+
+    vadd(data(), 1, sourceChannel->data(), 1, data(), 1, length());
+}
+
+float AudioChannel::maxAbsValue() const
+{
+    const float* p = data();
+    int n = length();
+
+    float max = 0.0f;
+    while (n--)
+        max = std::max(max, fabsf(*p++));
+
+    return max;
+}
+
+} // WebCore
+
+#endif // ENABLE(WEB_AUDIO)
diff --git a/WebCore/platform/audio/AudioChannel.h b/WebCore/platform/audio/AudioChannel.h
new file mode 100644 (file)
index 0000000..511048c
--- /dev/null
@@ -0,0 +1,112 @@
+/*
+ * 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 AudioChannel_h
+#define AudioChannel_h
+
+#include "AudioFloatArray.h"
+#include <wtf/Noncopyable.h>
+#include <wtf/PassOwnPtr.h>
+
+namespace WebCore {
+
+// An AudioChannel represents a buffer of non-interleaved floating-point audio samples.
+// The PCM samples are normally assumed to be in a nominal range -1.0 -> +1.0
+class AudioChannel : public Noncopyable {
+public:
+    // Memory can be externally referenced, or can be internally allocated with an AudioFloatArray.
+
+    // Reference an external buffer.
+    AudioChannel(float* storage, size_t length)
+        : m_length(length), m_rawPointer(storage) { }
+
+    // Manage storage for us.
+    explicit AudioChannel(size_t length)
+        : m_length(length)
+        , m_rawPointer(0)
+    {
+        m_memBuffer = adoptPtr(new AudioFloatArray(length));
+    }
+
+    // A "blank" audio channel -- must call set() before it's useful...
+    AudioChannel()
+        : m_length(0)
+        , m_rawPointer(0)
+    {
+    }
+
+    // Redefine the memory for this channel.
+    // storage represents external memory not managed by this object.
+    void set(float* storage, size_t length)
+    {
+        m_memBuffer.clear(); // cleanup managed storage
+        m_rawPointer = storage;
+        m_length = length;
+    }
+
+    // How many sample-frames do we contain?
+    size_t length() const { return m_length; }
+
+    // Direct access to PCM sample data
+    float* data() { return m_rawPointer ? m_rawPointer : m_memBuffer->data(); }
+    const float* data() const { return m_rawPointer ? m_rawPointer : m_memBuffer->data(); }
+
+    // Zeroes out all sample values in buffer.
+    void zero()
+    {
+        if (m_memBuffer.get())
+            m_memBuffer->zero();
+        else
+            memset(m_rawPointer, 0, sizeof(float) * m_length);
+    }
+
+    // Scales all samples by the same amount.
+    void scale(double scale);
+
+    // A simple memcpy() from the source channel
+    void copyFrom(const AudioChannel* sourceChannel);
+
+    // Copies the given range from the source channel.
+    void copyFromRange(const AudioChannel* sourceChannel, unsigned startFrame, unsigned endFrame);
+
+    // Sums (with unity gain) from the source channel.
+    void sumFrom(const AudioChannel* sourceChannel);
+
+    // Returns maximum absolute value (useful for normalization).
+    float maxAbsValue() const;
+
+private:
+    size_t m_length;
+
+    float* m_rawPointer;
+    OwnPtr<AudioFloatArray> m_memBuffer;
+};
+
+} // WebCore
+
+#endif // AudioChannel_h