ISSUE-20: Relationship to currentTime
authorcrogers
Mon, 04 Jun 2012 16:14:48 -0700
changeset 69 6ea467c0b48b
parent 68 c86957261db6
child 70 1fbfc8e7b350
ISSUE-20: Relationship to currentTime
webaudio/specification.html
--- a/webaudio/specification.html	Mon Jun 04 15:48:49 2012 -0700
+++ b/webaudio/specification.html	Mon Jun 04 16:14:48 2012 -0700
@@ -1341,12 +1341,10 @@
 <h3 id="methodsandparams-AudioParam">4.5.2. Methods and Parameters</h3>
 <dl>
   <dt id="dfn-setValueAtTime">The <code>setValueAtTime</code> method</dt>
-    <dd><p>Schedules a parameter value change at the given time (relative to
-      the AudioContext .currentTime).</p>
+    <dd><p>Schedules a parameter value change at the given time.</p>
       <p>The <dfn id="dfn-value_2">value</dfn> parameter is the value the
       parameter will change to at the given time.</p>
-      <p>The <dfn id="dfn-time_2">time</dfn> parameter is the time (relative to
-      the AudioContext .currentTime).</p>
+      <p>The <dfn id="dfn-time_2">time</dfn> parameter is the time in the same time coordinate system as AudioContext.currentTime.</p>
     </dd>
 </dl>
 <dl>
@@ -1356,8 +1354,7 @@
       previous scheduled parameter value to the given value.</p>
       <p>The <dfn id="dfn-value_3">value</dfn> parameter is the value the
       parameter will linearly ramp to at the given time.</p>
-      <p>The <dfn id="dfn-time_3">time</dfn> parameter is the time (relative to
-      the AudioContext .currentTime).</p>
+      <p>The <dfn id="dfn-time_3">time</dfn> parameter is the time in the same time coordinate system as AudioContext.currentTime.</p>
     </dd>
 </dl>
 <dl>
@@ -1369,8 +1366,7 @@
       exponentially because of the way humans perceive sound. </p>
       <p>The <dfn id="dfn-value_4">value</dfn> parameter is the value the
       parameter will exponentially ramp to at the given time.</p>
-      <p>The <dfn id="dfn-time_4">time</dfn> parameter is the time (relative to
-      the AudioContext .currentTime).</p>
+      <p>The <dfn id="dfn-time_4">time</dfn> parameter is the time in the same time coordinate system as AudioContext.currentTime.</p>
     </dd>
 </dl>
 <dl>
@@ -1384,8 +1380,7 @@
       changes to the target value.</p>
       <p>The <dfn id="dfn-targetValue">targetValue</dfn> parameter is the value
       the parameter will *start* changing to at the given time.</p>
-      <p>The <dfn id="dfn-time">time</dfn> parameter is the time (relative to
-      the AudioContext .currentTime).</p>
+      <p>The <dfn id="dfn-time">time</dfn> parameter is the time in the same time coordinate system as AudioContext.currentTime.</p>
       <p>The <dfn id="dfn-timeConstant">timeConstant</dfn> parameter is the
       time-constant value of first-order filter (exponential) approach to the
       target value. The larger this value is, the slower the transition will
@@ -1401,8 +1396,7 @@
       <p>The <dfn id="dfn-values">values</dfn> parameter is a Float32Array
       representing a parameter value curve. These values will apply starting at
       the given time and lasting for the given duration. </p>
-      <p>The <dfn id="dfn-time_5">time</dfn> parameter is the starting time for
-      the curve values (relative to the AudioContext .currentTime).</p>
+      <p>The <dfn id="dfn-time_5">time</dfn> parameter is the time in the same time coordinate system as AudioContext.currentTime.</p>
       <p>The <dfn id="dfn-duration_5">duration</dfn> parameter is the
       time-constant value of first-order filter (exponential) approach to the
       target value.</p>
@@ -1415,7 +1409,7 @@
       equal to startTime.</p>
       <p>The <dfn id="dfn-startTime">startTime</dfn> parameter is the starting
       time at and after which any previously scheduled parameter changes will
-      be cancelled.</p>
+      be cancelled.  It is a time in the same time coordinate system as AudioContext.currentTime.</p>
     </dd>
 </dl>
 </div>
@@ -1700,8 +1694,8 @@
   <dt id="dfn-noteOn">The <code>noteOn</code> method</dt>
     <dd><p>Schedules a sound to playback at an exact time.</p>
       <p>The <dfn id="dfn-when">when</dfn> parameter describes at what time (in
-      seconds) the sound should start playing. This time is relative to the
-      <b>currentTime</b> attribute of the AudioContext. If 0 is passed in for
+      seconds) the sound should start playing. It is in the same
+      time coordinate system as AudioContext.currentTime. If 0 is passed in for
       this value or if the value is less than <b>currentTime</b>, then the
       sound will start playing immediately.  Either <code>noteOn</code> or <code>noteGrainOn</code> (but not both) may only be called one time
       and must be called before <code>noteOff</code> is called or an exception will be thrown.</p>
@@ -1711,8 +1705,8 @@
   <dt id="dfn-noteGrainOn">The <code>noteGrainOn</code> method</dt>
     <dd><p>Schedules a portion of a sound to playback at an exact time.</p>
       <p>The <dfn id="dfn-when_AudioBufferSourceNode">when</dfn> parameter
-      describes at what time (in seconds) the sound should start playing. This
-      time is relative to the <b>currentTime</b> attribute of the AudioContext.
+      describes at what time (in seconds) the sound should start playing.
+      It is in the same time coordinate system as AudioContext.currentTime.
       If 0 is passed in for this value or if the value is less than
       <b>currentTime</b>, then the sound will start playing immediately. </p>
       <p>The <dfn id="dfn-grainOffset">grainOffset</dfn> parameter describes
@@ -1727,8 +1721,8 @@
   <dt id="dfn-noteOff">The <code>noteOff</code> method</dt>
     <dd><p>Schedules a sound to stop playback at an exact time.</p>
       <p>The <dfn id="dfn-when_AudioBufferSourceNode_2">when</dfn> parameter
-      describes at what time (in seconds) the sound should stop playing. This
-      time is relative to the <b>currentTime</b> attribute of the AudioContext.
+      describes at what time (in seconds) the sound should stop playing.
+      It is in the same time coordinate system as AudioContext.currentTime.
       If 0 is passed in for this value or if the value is less than
       <b>currentTime</b>, then the sound will stop playing immediately.
       <code>noteOff</code> must only be called one time and only after a call to <code>noteOn</code> or <code>noteOff</code>,
@@ -1870,8 +1864,7 @@
 </dl>
 <dl>
   <dt id="dfn-playbackTime"><code>playbackTime</code></dt>
-    <dd><p>The time when the audio will be played. This time is in relation to
-      the context's <code>currentTime</code> attribute.
+    <dd><p>The time when the audio will be played in the same time coordinate system as AudioContext.currentTime.
       <code>playbackTime</code> allows for very tight synchronization between
       processing directly in JavaScript with the other events in the context's
       rendering graph. </p>