Fix AudioNode.disconnect() to support selective disconnection.

Source/modules/webaudio/AudioNode.cpp

 /*
  * 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
@@ skipping 259 matching lines @@
     if (context() != param->context()) {
         exceptionState.throwDOMException(
             SyntaxError,
             "cannot connect to an AudioParam belonging to a different audio context.");
         return;
     }
 
     param->connect(*output(outputIndex));
 }
 
+void AudioNode::disconnect()
+{
+    ASSERT(isMainThread());
+    AudioContext::AutoLocker locker(context());
+
+    // Disconnect all outgoing connections.
+    for (unsigned i = 0; i < numberOfOutputs(); ++i)
+        this->output(i)->disconnectAll();
+}
+
 void AudioNode::disconnect(unsigned outputIndex, ExceptionState& exceptionState)
 {
     ASSERT(isMainThread());
     AudioContext::AutoLocker locker(context());
 
-    // Sanity check input and output indices.
+    // Sanity check on the output index.
     if (outputIndex >= numberOfOutputs()) {
         exceptionState.throwDOMException(
             IndexSizeError,
             "output index (" + String::number(outputIndex) + ") exceeds number of outputs (" + String::number(numberOfOutputs()) + ").");
         return;
     }
 
+    // Disconnect all outgoing connections from the given output.
+    AudioNodeOutput* output = this->output(outputIndex);
+    output->disconnectAll();
+}
+
+void AudioNode::disconnect(AudioNode* destination, ExceptionState& exceptionState)
+{
+    ASSERT(isMainThread());
+    AudioContext::AutoLocker locker(context());
+
+    bool isConnectedToDestination = false;
+
+    // TO FIX: Can this be optimized? ChannelSplitter and ChannelMerger can have

[Raymond Toy, 2015/02/11 21:31:18]

s/TO FIX/FIXME/ according to http://www.webkit.org/coding/coding-style.html

[hongchan, 2015/02/12 18:38:01]

Done.

+    // 32 ports and that requires 1024 iterations to validate entire connections.
+    for (unsigned i = 0; i < numberOfOutputs(); ++i) {
+        AudioNodeOutput* output = this->output(i);
+        for (unsigned j = 0; j < destination->numberOfInputs(); ++j) {
+            AudioNodeInput* input = destination->input(j);
+            if (output->isConnectedWithInput(*input)) {
+                output->disconnectInput(*input);
+                isConnectedToDestination = true;
+            }
+        }
+    }
+
+    // If there is no connection to the destination, throw an exception.
+    if (!isConnectedToDestination) {
+        exceptionState.throwDOMException(
+            InvalidAccessError,
+            "the given destination is not connected.");
+        return;
+    }
+}
+
+void AudioNode::disconnect(AudioNode* destination, unsigned outputIndex, ExceptionState& exceptionState)
+{
+    ASSERT(isMainThread());
+    AudioContext::AutoLocker locker(context());
+
+    // Sanity check on output index.
+    if (outputIndex >= numberOfOutputs()) {
+        exceptionState.throwDOMException(
+            IndexSizeError,
+            "output index (" + String::number(outputIndex) + ") exceeds number of outputs (" + String::number(numberOfOutputs()) + ").");

[Raymond Toy, 2015/02/11 21:31:18]

Consider using IndexOutsideOfRange.

[hongchan, 2015/02/12 18:38:01]

Acknowledged.

+        return;
+    }
+
+    bool isConnectedToDestination = false;
+    AudioNodeOutput* output = this->output(outputIndex);
+
+    // Sanity check on destination inputs and disconnect when possible.
+    for (unsigned i = 0; i < destination->numberOfInputs(); ++i) {
+        AudioNodeInput* input = destination->input(i);
+        if (output->isConnectedWithInput(*input)) {
+            output->disconnectInput(*input);
+            isConnectedToDestination = true;
+        }
+    }
+
+    // If there is no connection to the destination, throw an exception.
+    if (!isConnectedToDestination) {
+        exceptionState.throwDOMException(
+            InvalidAccessError,
+            "the given destination is not connected.");

[Raymond Toy, 2015/02/11 21:31:18]

Give the output index with the message.

[hongchan, 2015/02/12 18:38:00]

I will try to come up with the better error message.

+        return;
+    }
+}
+
+void AudioNode::disconnect(AudioNode* destination, unsigned outputIndex, unsigned inputIndex, ExceptionState& exceptionState)
+{
+    ASSERT(isMainThread());
+    AudioContext::AutoLocker locker(context());
+
+    // Sanity check input and output indices.
+    if (outputIndex >= numberOfOutputs()) {
+        exceptionState.throwDOMException(
+            IndexSizeError,
+            "output index (" + String::number(outputIndex) + ") exceeds number of outputs (" + String::number(numberOfOutputs()) + ").");

[Raymond Toy, 2015/02/11 21:31:18]

Consider using IndexOutsideOfRange, here and below.

[hongchan, 2015/02/12 18:38:01]

Done.

+        return;
+    }
+
+    if (inputIndex >= destination->numberOfInputs()) {
+        exceptionState.throwDOMException(
+            IndexSizeError,
+            "input index (" + String::number(inputIndex) + ") exceeds number of inputs of destination node (" + String::number(destination->numberOfInputs()) + ").");
+        return;
+    }
+
     AudioNodeOutput* output = this->output(outputIndex);
-    output->disconnectAll();
+    AudioNodeInput* input = destination->input(inputIndex);
+
+    // Sanity check on the connection between the output and the destination input.
+    if (!output->isConnectedWithInput(*input)) {
+        exceptionState.throwDOMException(
+            InvalidAccessError,
+            "the given destination input (" + String::number(inputIndex) + ") and node output (" + String::number(outputIndex) + ") are not connected.");

[Raymond Toy, 2015/02/11 21:31:18]

I think it reads better to say output # is not connected to the input # of the
destination.

[hongchan, 2015/02/12 18:38:01]

Done.

+        return;
+    }
+
+    output->disconnectInput(*input);
+}
+
+void AudioNode::disconnect(AudioParam* destinationParam, ExceptionState& exceptionState)
+{
+    ASSERT(isMainThread());
+    AudioContext::AutoLocker locker(context());
+
+    bool isConnectedToDestination = false;
+
+    for (unsigned i = 0; i < numberOfOutputs(); ++i) {
+        AudioNodeOutput* output = this->output(i);
+        if (output->isConnectedWithAudioParam(*destinationParam)) {
+            output->disconnectAudioParam(*destinationParam);
+            isConnectedToDestination = true;
+        }
+    }
+
+    // Throw an exception when there is no valid connection to the destination.
+    if (!isConnectedToDestination) {
+        exceptionState.throwDOMException(
+            InvalidAccessError,
+            "the given destination AudioParam and the node are not connected.");
+        return;
+    }
+}
+
+void AudioNode::disconnect(AudioParam* destinationParam, unsigned outputIndex, ExceptionState& exceptionState)
+{
+    ASSERT(isMainThread());
+    AudioContext::AutoLocker locker(context());
+
+    // Sanity check input and output indices.
+    if (outputIndex >= numberOfOutputs()) {
+        exceptionState.throwDOMException(
+            IndexSizeError,
+            "output index (" + String::number(outputIndex) + ") exceeds number of outputs (" + String::number(numberOfOutputs()) + ").");
+        return;
+    }
+
+    AudioNodeOutput* output = this->output(outputIndex);
+
+    // Sanity check on the connection between the output and the destination.
+    if (!output->isConnectedWithAudioParam(*destinationParam)) {
+        exceptionState.throwDOMException(
+            InvalidAccessError,
+            "specified destination AudioParam and node output (" + String::number(outputIndex) + ") are not connected.");
+        return;
+    }
+
+    output->disconnectAudioParam(*destinationParam);
 }
 
 void AudioNode::disconnectWithoutException(unsigned outputIndex)
 {
     ASSERT(isMainThread());
     AudioContext::AutoLocker locker(context());
 
     // Sanity check input and output indices.
     if (outputIndex < numberOfOutputs()) {
         AudioNodeOutput* output = this->output(outputIndex);
@@ skipping 298 matching lines @@
 
 void AudioNode::updateChannelCountMode()
 {
     m_channelCountMode = m_newChannelCountMode;
     updateChannelsForInputs();
 }
 
 } // namespace blink
 
 #endif // ENABLE(WEB_AUDIO)