Refer to the value attribute of an AudioParam in a consistent manner.
authorPaul Adenot <paul@paul.cx>
Fri, 30 Aug 2013 18:15:30 +0200
changeset 329 c356109a4006
parent 328 396c4054ef67
child 330 d5abda1da9fc
Refer to the value attribute of an AudioParam in a consistent manner.
webaudio/specification.html
--- a/webaudio/specification.html	Thu Aug 29 19:16:48 2013 +0200
+++ b/webaudio/specification.html	Fri Aug 30 18:15:30 2013 +0200
@@ -1460,7 +1460,7 @@
       with multiple calls to connect().  Thus, "fan-in" is supported. </p>
       <p>An AudioParam will take the rendered audio data from any AudioNode output connected to it and <a href="#down-mix">convert it to mono</a> by down-mixing if it is not
       already mono, then mix it together with other such outputs and finally will mix with the <em>intrinsic</em>
-      parameter value (the value the AudioParam would normally have without any audio connections), including any timeline changes
+      parameter value (the <code>value</code> the AudioParam would normally have without any audio connections), including any timeline changes
       scheduled for the parameter. </p>
 
       <p>
@@ -1600,7 +1600,7 @@
 <p>AudioParam controls an individual aspect of an <a
 href="#AudioNode-section"><code>AudioNode</code></a>'s functioning, such as
 volume. The parameter can be set immediately to a particular value using the
-"value" attribute. Or, value changes can be scheduled to happen at
+<code>value</code> attribute. Or, value changes can be scheduled to happen at
 very precise times (in the coordinate system of AudioContext.currentTime), for envelopes, volume fades, LFOs, filter sweeps, grain
 windows, etc. In this way, arbitrary timeline-based automation curves can be
 set on any AudioParam.  Additionally, audio signals from the outputs of <code>AudioNodes</code> can be connected
@@ -1669,13 +1669,13 @@
 <dl>
   <dt id="dfn-value"><code>value</code></dt>
     <dd><p>The parameter's floating-point value.  This attribute is initialized to the
-      <code>defaultValue</code>.  If a value is set during a time when there are any automation events scheduled then
+      <code>defaultValue</code>.  If <code>value</code> is set during a time when there are any automation events scheduled then
       it will be ignored and no exception will be thrown.</p>
     </dd>
 </dl>
 <dl>
   <dt id="dfn-defaultValue"><code>defaultValue</code></dt>
-    <dd><p>Initial value for the value attribute</p>
+    <dd><p>Initial value for the <code>value</code> attribute</p>
     </dd>
 </dl>
 </div>
@@ -1866,12 +1866,12 @@
 </p>
 
 <ol>
-<li>An <em>intrinsic</em> parameter value will be calculated at each time, which is either the value set directly to the .value attribute,
+<li>An <em>intrinsic</em> parameter value will be calculated at each time, which is either the value set directly to the <code>value</code> attribute,
 or, if there are any scheduled parameter changes (automation events) with times before or at this time,
-the value as calculated from these events.  If the .value attribute
-is set after any automation events have been scheduled, then these events will be removed.  When read, the .value attribute
+the value as calculated from these events.  If the <code>value</code> attribute
+is set after any automation events have been scheduled, then these events will be removed.  When read, the <code>value</code> attribute
 always returns the <em>intrinsic</em> value for the current time.  If automation events are removed from a given time range, then the
-<em>intrinsic</em> value will remain unchanged and stay at its previous value until either the .value attribute is directly set, or automation events are added
+<em>intrinsic</em> value will remain unchanged and stay at its previous value until either the <code>value</code> attribute is directly set, or automation events are added
 for the time range.
 </li>
 
@@ -2050,7 +2050,7 @@
 <dl>
   <dt id="dfn-delayTime_2"><code>delayTime</code></dt>
     <dd><p>An AudioParam object representing the amount of delay (in seconds)
-      to apply. The default value (<code>delayTime.value</code>) is 0 (no
+      to apply. Its default <code>value</code> is 0 (no
       delay). The minimum value is 0 and the maximum value is determined by the <em>maxDelayTime</em>
       argument to the <code>AudioContext</code> method <code>createDelay</code>.  This parameter is <em>a-rate</em></p>
     </dd>
@@ -2195,8 +2195,8 @@
 </dl>
 <dl>
   <dt id="dfn-playbackRate_AudioBufferSourceNode"><code>playbackRate</code></dt>
-    <dd><p>The speed at which to render the audio stream. The default
-      playbackRate.value is 1.  This parameter is <em>a-rate</em> </p>
+    <dd><p>The speed at which to render the audio stream. Its default
+      <code>value</code> is 1.  This parameter is <em>a-rate</em> </p>
     </dd>
 </dl>
 <dl>
@@ -2208,13 +2208,13 @@
 <dl>
   <dt id="dfn-loopStart_AudioBufferSourceNode"><code>loopStart</code></dt>
     <dd><p>An optional value in seconds where looping should begin if the <code>loop</code> attribute is true.
-    Its default value is 0, and it may usefully be set to any value between 0 and the duration of the buffer.</p>
+    Its default <code>value</code> is 0, and it may usefully be set to any value between 0 and the duration of the buffer.</p>
     </dd>
 </dl>
 <dl>
   <dt id="dfn-loopEnd_AudioBufferSourceNode"><code>loopEnd</code></dt>
     <dd><p>An optional value in seconds where looping should end if the <code>loop</code> attribute is true.
-    Its default value is 0, and it may usefully be set to any value between 0 and the duration of the buffer.</p>
+    Its default <code>value</code> is 0, and it may usefully be set to any value between 0 and the duration of the buffer.</p>
     </dd>
 </dl>
 <dl>
@@ -2300,6 +2300,7 @@
 
 <p>
 Note that the default values for <code>loopStart</code> and <code>loopEnd</code> are both 0, which indicates that looping should occur from the very start
+Note that the default <code>value</code>s for <code>loopStart</code> and <code>loopEnd</code> are both 0, which indicates that looping should occur from the very start
 to the very end of the buffer.
 </p>
 
@@ -3235,18 +3236,18 @@
 <dl>
   <dt id="dfn-threshold"><code>threshold</code></dt>
     <dd><p>The decibel value above which the compression will start taking
-      effect.  Its default value is -24, with a nominal range of -100 to 0. </p>
+      effect.  Its default <code>value</code> is -24, with a nominal range of -100 to 0. </p>
     </dd>
 </dl>
 <dl>
   <dt id="dfn-knee"><code>knee</code></dt>
     <dd><p>A decibel value representing the range above the threshold where the
-      curve smoothly transitions to the "ratio" portion. Its default value is 30, with a nominal range of 0 to 40. </p>
+      curve smoothly transitions to the "ratio" portion. Its default <code>value</code> is 30, with a nominal range of 0 to 40. </p>
     </dd>
 </dl>
 <dl>
   <dt id="dfn-ratio"><code>ratio</code></dt>
-    <dd><p>The amount of dB change in input for a 1 dB change in output. Its default value is 12, with a nominal range of 1 to 20. </p>
+    <dd><p>The amount of dB change in input for a 1 dB change in output. Its default <code>value</code> is 12, with a nominal range of 1 to 20. </p>
     </dd>
 </dl>
 <dl>
@@ -3258,12 +3259,12 @@
 </dl>
 <dl>
   <dt id="dfn-attack"><code>attack</code></dt>
-    <dd><p>The amount of time (in seconds) to reduce the gain by 10dB.   Its default value is 0.003, with a nominal range of 0 to 1. </p>
+    <dd><p>The amount of time (in seconds) to reduce the gain by 10dB.   Its default <code>value</code> is 0.003, with a nominal range of 0 to 1. </p>
     </dd>
 </dl>
 <dl>
   <dt id="dfn-release"><code>release</code></dt>
-    <dd><p>The amount of time (in seconds) to increase the gain by 10dB.  Its default value is 0.250, with a nominal range of 0 to 1. </p>
+    <dd><p>The amount of time (in seconds) to increase the gain by 10dB.  Its default <code>value</code> is 0.250, with a nominal range of 0 to 1. </p>
     </dd>
 </dl>
 </div>