1/*
2 * Copyright (C) 2010, Google Inc. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 * 1.  Redistributions of source code must retain the above copyright
8 *    notice, this list of conditions and the following disclaimer.
9 * 2.  Redistributions in binary form must reproduce the above copyright
10 *    notice, this list of conditions and the following disclaimer in the
11 *    documentation and/or other materials provided with the distribution.
12 *
13 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY
14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
16 * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY
17 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
19 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
20 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
22 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23 */
24
25#ifndef ConvolverNode_h
26#define ConvolverNode_h
27
28#include "modules/webaudio/AudioNode.h"
29#include "wtf/OwnPtr.h"
30#include "wtf/RefPtr.h"
31#include "wtf/ThreadingPrimitives.h"
32
33namespace blink {
34
35class AudioBuffer;
36class ExceptionState;
37class Reverb;
38
39class ConvolverNode FINAL : public AudioNode {
40    DEFINE_WRAPPERTYPEINFO();
41public:
42    static ConvolverNode* create(AudioContext* context, float sampleRate)
43    {
44        return adoptRefCountedGarbageCollectedWillBeNoop(new ConvolverNode(context, sampleRate));
45    }
46
47    virtual ~ConvolverNode();
48
49    // AudioNode
50    virtual void dispose() OVERRIDE;
51    virtual void process(size_t framesToProcess) OVERRIDE;
52    virtual void initialize() OVERRIDE;
53    virtual void uninitialize() OVERRIDE;
54
55    // Impulse responses
56    void setBuffer(AudioBuffer*, ExceptionState&);
57    AudioBuffer* buffer();
58
59    bool normalize() const { return m_normalize; }
60    void setNormalize(bool normalize) { m_normalize = normalize; }
61
62    virtual void trace(Visitor*) OVERRIDE;
63
64private:
65    ConvolverNode(AudioContext*, float sampleRate);
66
67    virtual double tailTime() const OVERRIDE;
68    virtual double latencyTime() const OVERRIDE;
69
70    OwnPtr<Reverb> m_reverb;
71    Member<AudioBuffer> m_buffer;
72
73    // This synchronizes dynamic changes to the convolution impulse response with process().
74    mutable Mutex m_processLock;
75
76    // Normalize the impulse response or not. Must default to true.
77    bool m_normalize;
78};
79
80} // namespace blink
81
82#endif // ConvolverNode_h
83