Bug 17795: Behavior of multiple connections to same node needs to be explicitly defined
authorcrogers
Tue, 09 Oct 2012 15:02:04 -0700
changeset 181 351b64e571ba
parent 180 b7050f141b60
child 182 f4bfa16b820d
Bug 17795: Behavior of multiple connections to same node needs to be explicitly defined
webaudio/specification.html
--- a/webaudio/specification.html	Mon Oct 08 13:18:45 2012 -0700
+++ b/webaudio/specification.html	Tue Oct 09 15:02:04 2012 -0700
@@ -1131,6 +1131,21 @@
       <a class="dfnref" href="#DelayNode-section">DelayNode</a> in the <em>cycle</em> or an exception will
       be thrown.
       </p>
+      
+      <p>
+      There can only be one connection between a given output of one specific node and a given input of another specific node.
+      Multiple connections with the same termini are ignored.  For example: 
+
+      <pre>
+      nodeA.connect(nodeB);
+      nodeA.connect(nodeB);
+
+      will have the same effect as
+
+      nodeA.connect(nodeB);
+      </pre>
+      </p>
+      
     </dd>
 </dl>
 <dl>
@@ -1139,6 +1154,12 @@
       value with an audio-rate signal.
       </p>
 
+      <p>The <dfn id="dfn-destination_3">destination</dfn> parameter is the
+      AudioParam to connect to.</p>
+      <p>The <dfn id="dfn-output_3-destination">output</dfn> parameter is an index
+      describing which output of the AudioNode from which to connect. An
+      out-of-bound value throws an exception.</p>      
+
       <p>It is possible to connect an AudioNode output to more than one AudioParam
       with multiple calls to connect(). Thus, "fanout" is supported. </p>
       <p>It is possible to connect more than one AudioNode output to a single AudioParam
@@ -1148,11 +1169,20 @@
       parameter value (the value the AudioParam would normally have without any audio connections), including any timeline changes
       scheduled for the parameter. </p>
 
-      <p>The <dfn id="dfn-destination_3">destination</dfn> parameter is the
-      AudioParam to connect to.</p>
-      <p>The <dfn id="dfn-output_3-destination">output</dfn> parameter is an index
-      describing which output of the AudioNode from which to connect. An
-      out-of-bound value throws an exception.</p>      
+      <p>
+      There can only be one connection between a given output of one specific node and a specific AudioParam.
+      Multiple connections with the same termini are ignored.  For example: 
+
+      <pre>
+      nodeA.connect(param);
+      nodeA.connect(param);
+
+      will have the same effect as
+
+      nodeA.connect(param);
+      </pre>
+      </p>
+
     </dd>
 </dl>
 <dl>