Change .maxNumberOfChannels attribute to .maxChannelCount adding more detailed text
authorcrogers
Mon, 04 Mar 2013 17:01:14 -0800
changeset 269 28d91bd1b594
parent 268 4275c082b3de
child 270 38125358ffc1
Change .maxNumberOfChannels attribute to .maxChannelCount adding more detailed text
webaudio/specification.html
--- a/webaudio/specification.html	Mon Mar 04 15:04:40 2013 -0500
+++ b/webaudio/specification.html	Mon Mar 04 17:01:14 2013 -0800
@@ -1493,8 +1493,7 @@
 
 interface <dfn id="dfn-AudioDestinationNode">AudioDestinationNode</dfn> : AudioNode {
 
-    readonly attribute unsigned long maxNumberOfChannels;
-    attribute unsigned long numberOfChannels;
+    readonly attribute unsigned long maxChannelCount;
 
 };
 </code></pre>
@@ -1504,22 +1503,27 @@
 <div id="attributes-AudioDestinationNode-section" class="section">
 <h3 id="attributes-AudioDestinationNode">4.4.1. Attributes</h3>
 <dl>
-  <dt id="dfn-maxNumberOfChannels"><code>maxNumberOfChannels</code></dt>
-    <dd><p>The maximum number of channels that the <code>numberOfChannels</code> attribute can be set to.
+  <dt id="dfn-maxChannelCount"><code>maxChannelCount</code></dt>
+    <dd><p>The maximum number of channels that the <code>channelCount</code> attribute can be set to.
     An <code>AudioDestinationNode</code> representing the audio hardware end-point (the normal case) can potentially output more than
-    2 channels of audio if the audio hardware is multi-channel.  <code>maxNumberOfChannels</code> is the maximum number of channels that
-    this hardware is capable of supporting.  If this value is 0, then this indicates that <code>maxNumberOfChannels</code> may not be
-    changed.  This will be the case for an <code>AudioDestinationNode</code> in an <code>OfflineAudioContext</code>.</p>
+    2 channels of audio if the audio hardware is multi-channel.  <code>maxChannelCount</code> is the maximum number of channels that
+    this hardware is capable of supporting.  If this value is 0, then this indicates that <code>channelCount</code> may not be
+    changed.  This will be the case for an <code>AudioDestinationNode</code> in an <code>OfflineAudioContext</code> and also for
+    basic implementations with hardware support for stereo output only.</p>
+
+    <p><code>channelCount</code> defaults to 2 for a destination in a normal AudioContext, and may be set to any non-zero value less than or equal
+    to <code>maxNumberOfChannels</code>.  An exception will be thrown if this value is not within the valid range.  Giving a concrete example, if
+    the audio hardware supports 8-channel output, then we may set <code>numberOfChannels</code> to 8, and render 8-channels of output.
+    </p>
+    
+    <p>
+    For an AudioDestinationNode in an OfflineAudioContext, the <code>channelCount</code> is determined when the offline context is created and this value
+    may not be changed.
+    </p>
+    
     </dd>
 </dl>
 
-<dl>
-  <dt id="dfn-numberOfChannels_2"><code>numberOfChannels</code></dt>
-    <dd><p>The number of channels of the destination's input.  This value will default to 2, and may be set to any non-zero value less than or equal
-    to <code>maxNumberOfChannels</code>.  An exception will be thrown if this value is not within the valid range.  Giving a concrete example, if
-    the audio hardware supports 8-channel output, then we may set <code>numberOfChannels</code> to 8, and render 8-channels of output.  </p>
-    </dd>
-</dl>
 </div>
 </div>