hixie: Revamp how .muted, .volume, and muted='' are defined (shouldn't impact implementations) (whatwg r6467)

hixie: Revamp how .muted, .volume, and muted='' are defined (shouldn't
impact implementations) (whatwg r6467)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5168&r2=1.5169&f=h
http://html5.org/tools/web-apps-tracker?from=6466&to=6467

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5168
retrieving revision 1.5169
diff -u -d -r1.5168 -r1.5169
--- Overview.html 16 Aug 2011 00:40:10 -0000 1.5168
+++ Overview.html 16 Aug 2011 01:29:18 -0000 1.5169
@@ -26945,34 +26945,40 @@
   <p>The <dfn id="dom-media-volume" title="dom-media-volume"><code>volume</code></dfn>
   attribute must return the playback volume of any audio portions of
   the <a href="#media-element">media element</a>, in the range 0.0 (silent) to 1.0
-  (loudest). Initially, the volume must be 1.0, but user agents may
+  (loudest). Initially, the volume should be 1.0, but user agents may
   remember the last set value across sessions, on a per-site basis or
   otherwise, so the volume may start at other values. On setting, if
-  the new value is in the range 0.0 to 1.0 inclusive, the attribute
-  must be set to the new value. If the new value is outside the range
-  0.0 to 1.0 inclusive, then, on setting, an
-  <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception must be raised instead.</p>
+  the new value is in the range 0.0 to 1.0 inclusive, the playback
+  volume of any audio portions of the <a href="#media-element">media element</a> must
+  be set to the new value. If the new value is outside the range 0.0
+  to 1.0 inclusive, then, on setting, an <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code>
+  exception must be raised instead.</p>
 
   <p>The <dfn id="dom-media-muted" title="dom-media-muted"><code>muted</code></dfn>
-  attribute must return true if the audio channels are muted and false
-  otherwise. Initially, the audio channels should not be muted
-  (false), but user agents may remember the last set value across
-  sessions, on a per-site basis or otherwise, so the muted state may
-  start as muted (true). On setting, the attribute must be set to the
-  new value.</p>
+  attribute must return true if the audio output is muted and false
+  otherwise. Initially, the audio output should not be muted (false),
+  but user agents may remember the last set value across sessions, on
+  a per-site basis or otherwise, so the muted state may start as muted
+  (true). On setting, if the new value is true then the audio output
+  should be muted and if the new value is false it should be
+  unmuted.</p>
 
-  <p>Whenever either the <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code> or
-  <code title="dom-media-volume"><a href="#dom-media-volume">volume</a></code> attributes are changed,
-  the user agent must <a href="#queue-a-task">queue a task</a> to <a href="#fire-a-simple-event">fire a simple
-  event</a> named <code title="event-media-volumechange"><a href="#event-media-volumechange">volumechange</a></code> at the <a href="#media-element">media
-  element</a>.</p>
+  <p>Whenever either of the values that would be returned by the <code title="dom-media-volume"><a href="#dom-media-volume">volume</a></code> and <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code> attributes change, the user
+  agent must <a href="#queue-a-task">queue a task</a> to <a href="#fire-a-simple-event">fire a simple
+  event</a> named <code title="event-media-volumechange"><a href="#event-media-volumechange">volumechange</a></code> at the
+  <a href="#media-element">media element</a>.</p>
 
   <p>An element's <dfn id="effective-media-volume">effective media volume</dfn> is determined as
   follows:</p>
 
-  <ol><li><p>If the element's <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code>
-   attribute is true, the element's <a href="#effective-media-volume">effective media
-   volume</a> is zero. Abort these steps.</li>
+  <ol><li><p>If the user has indicated that the user agent is to override
+   the volume of the element, then the element's <a href="#effective-media-volume">effective media
+   volume</a> is the volume desired by the user. Abort these
+   steps.</li>
+
+   <li><p>If the element's audio output is muted, the element's
+   <a href="#effective-media-volume">effective media volume</a> is zero. Abort these
+   steps.</li>
 
    <li><p>If the element has a <a href="#current-media-controller">current media controller</a>
    and that <code><a href="#mediacontroller">MediaController</a></code> object's <a href="#media-controller-mute-override">media
@@ -26980,8 +26986,9 @@
    <a href="#effective-media-volume">effective media volume</a> is zero. Abort these
    steps.</li>
 
-   <li><p>Let <var title="">volume</var> be the value of the element's
-   <code title="dom-media-volume"><a href="#dom-media-volume">volume</a></code> attribute.</li>
+   <li><p>Let <var title="">volume</var> be the playback volume of the
+   audio portions of the <a href="#media-element">media element</a>, in range 0.0
+   (silent) to 1.0 (loudest).</li>
 
    <li><p>If the element has a <a href="#current-media-controller">current media controller</a>,
    multiply <var title="">volume</var> by that
@@ -26998,12 +27005,12 @@
   </ol></div><p>The <dfn id="attr-media-muted" title="attr-media-muted"><code>muted</code></dfn>
   attribute on <a href="#media-element" title="media element">media elements</a> is a
   <a href="#boolean-attribute">boolean attribute</a> that controls the default state of
-  the audio channel of the <a href="#media-resource">media resource</a>, potentially
+  the audio output of the <a href="#media-resource">media resource</a>, potentially
   overriding user preferences.<div class="impl">
 
   <p>When a <a href="#media-element">media element</a> is created, if it has a <code title="attr-media-muted"><a href="#attr-media-muted">muted</a></code> attribute specified, the user
-  agent must set the <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code> IDL
-  attribute to true, overriding any user preference.</p>
+  agent must mute the <a href="#media-element">media element</a>'s audio output,
+  overriding any user preference.</p>
 
   <p>The <dfn id="dom-media-defaultmuted" title="dom-media-defaultMuted"><code>defaultMuted</code></dfn> IDL
   attribute must <a href="#reflect">reflect</a> the <code title="attr-media-muted"><a href="#attr-media-muted">muted</a></code> content attribute.</p>

Received on Tuesday, 16 August 2011 01:30:09 UTC