summaryrefslogtreecommitdiffstats
path: root/WebCore/webaudio/AudioNodeInput.h
diff options
context:
space:
mode:
Diffstat (limited to 'WebCore/webaudio/AudioNodeInput.h')
-rw-r--r--WebCore/webaudio/AudioNodeInput.h125
1 files changed, 0 insertions, 125 deletions
diff --git a/WebCore/webaudio/AudioNodeInput.h b/WebCore/webaudio/AudioNodeInput.h
deleted file mode 100644
index 1d90986..0000000
--- a/WebCore/webaudio/AudioNodeInput.h
+++ /dev/null
@@ -1,125 +0,0 @@
-/*
- * 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.
- *
- * THIS SOFTWARE IS PROVIDED BY APPLE INC. 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 INC. 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 AudioNodeInput_h
-#define AudioNodeInput_h
-
-#include "AudioBus.h"
-#include "AudioNode.h"
-#include <wtf/HashSet.h>
-#include <wtf/Vector.h>
-
-namespace WebCore {
-
-class AudioNode;
-class AudioNodeOutput;
-
-// An AudioNodeInput represents an input to an AudioNode and can be connected from one or more AudioNodeOutputs.
-// In the case of multiple connections, the input will act as a unity-gain summing junction, mixing all the outputs.
-// The number of channels of the input's bus is the maximum of the number of channels of all its connections.
-
-class AudioNodeInput {
-public:
- AudioNodeInput(AudioNode*);
-
- // Can be called from any thread.
- AudioNode* node() const { return m_node; }
- AudioContext* context() { return m_node->context(); }
-
- // Must be called with the context's graph lock.
- void connect(AudioNodeOutput*);
- void disconnect(AudioNodeOutput*);
-
- // disable() will take the output out of the active connections list and set aside in a disabled list.
- // enable() will put the output back into the active connections list.
- // Must be called with the context's graph lock.
- void enable(AudioNodeOutput*);
- void disable(AudioNodeOutput*);
-
- // pull() processes all of the AudioNodes connected to us.
- // In the case of multiple connections it sums the result into an internal summing bus.
- // In the single connection case, it allows in-place processing where possible using inPlaceBus.
- // It returns the bus which it rendered into, returning inPlaceBus if in-place processing was performed.
- // Called from context's audio thread.
- AudioBus* pull(AudioBus* inPlaceBus, size_t framesToProcess);
-
- // bus() contains the rendered audio after pull() has been called for each time quantum.
- // Called from context's audio thread.
- AudioBus* bus();
-
- // This copies m_outputs to m_renderingOutputs. Please see comments for these lists below.
- // This must be called when we own the context's graph lock in the audio thread at the very start or end of the render quantum.
- void updateRenderingState();
-
- // Rendering code accesses its version of the current connections here.
- unsigned numberOfRenderingConnections() const { return m_renderingOutputs.size(); }
- AudioNodeOutput* renderingOutput(unsigned i) { return m_renderingOutputs[i]; }
- const AudioNodeOutput* renderingOutput(unsigned i) const { return m_renderingOutputs[i]; }
- bool isConnected() const { return numberOfRenderingConnections() > 0; }
-
- // The number of channels of the connection with the largest number of channels.
- unsigned numberOfChannels() const;
-
-private:
- AudioNode* m_node;
-
- // m_outputs contains the AudioNodeOutputs representing current connections which are not disabled.
- // The rendering code should never use this directly, but instead uses m_renderingOutputs.
- HashSet<AudioNodeOutput*> m_outputs;
-
- // numberOfConnections() should never be called from the audio rendering thread.
- // Instead numberOfRenderingConnections() and renderingOutput() should be used.
- unsigned numberOfConnections() const { return m_outputs.size(); }
-
- // This must be called whenever we modify m_outputs.
- void changedOutputs();
-
- // m_renderingOutputs is a copy of m_outputs which will never be modified during the graph rendering on the audio thread.
- // This is the list which is used by the rendering code.
- // Whenever m_outputs is modified, the context is told so it can later update m_renderingOutputs from m_outputs at a safe time.
- // Most of the time, m_renderingOutputs is identical to m_outputs.
- Vector<AudioNodeOutput*> m_renderingOutputs;
-
- // m_renderingStateNeedUpdating keeps track if m_outputs is modified.
- bool m_renderingStateNeedUpdating;
-
- // The number of channels of the rendering connection with the largest number of channels.
- unsigned numberOfRenderingChannels();
-
- // m_disabledOutputs contains the AudioNodeOutputs which are disabled (will not be processed) by the audio graph rendering.
- // But, from JavaScript's perspective, these outputs are still connected to us.
- // Generally, these represent disabled connections from "notes" which have finished playing but are not yet garbage collected.
- HashSet<AudioNodeOutput*> m_disabledOutputs;
-
- // Called from context's audio thread.
- AudioBus* internalSummingBus();
- void sumAllConnections(AudioBus* summingBus, size_t framesToProcess);
-
- OwnPtr<AudioBus> m_monoSummingBus;
- OwnPtr<AudioBus> m_stereoSummingBus;
-};
-
-} // namespace WebCore
-
-#endif // AudioNodeInput_h