- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 Jul 2011 17:56:38 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv16238
Modified Files:
Overview.html Overview.src.html
Log Message:
pitch frequency "relative" keyword now "absolute"
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -d -r1.70 -r1.71
--- Overview.html 13 Jul 2011 17:26:28 -0000 1.70
+++ Overview.html 13 Jul 2011 17:56:36 -0000 1.71
@@ -783,29 +783,6 @@
behavior of the ‘<code class=property>center</code>’ value.
</ul>
- <p class=note> Note that sound systems may be configured by users in such a
- way that it would interfere with the left-right audio distribution
- specified by document authors. Typically, the various "surround" modes
- available in modern sound systems (including systems based on basic stereo
- speakers) tend to greatly alter the perceived spatial arrangement of audio
- signals. The illusion of a three-dimensional sound stage is often achieved
- using a combination of phase shifting, digital delay, volume control
- (channel mixing), and other techniques. Some users may even configure
- their system to "downgrade" any rendered sound to a single mono channel,
- in which case the effect of the ‘<a href="#voice-balance"><code
- class=property>voice-balance</code></a>’ property would obviously
- not be perceivable at all. The rendering fidelity of authored content is
- therefore dependent on such user customizations, and the ‘<a
- href="#voice-balance"><code class=property>voice-balance</code></a>’
- property merely specifies the desired end-result.
-
- <p class=note> Note that many speech synthesizers only generate mono sound,
- and therefore do not intrinsically support the ‘<a
- href="#voice-balance"><code class=property>voice-balance</code></a>’
- property. The sound distribution along the left-right axis consequently
- occurs at post-synthesis stage (when the speech-enabled user-agent mixes
- the various audio sources authored within the document)
-
<p> Future revisions of the CSS Speech module may include support for
three-dimensional audio, which would effectively enable authors to specify
"azimuth" and "elevation" values. In the future, content authored using
@@ -840,6 +817,29 @@
class=css>-50</code>’ maps to -20 degrees.
</ul>
+ <p class=note> Note that sound systems may be configured by users in such a
+ way that it would interfere with the left-right audio distribution
+ specified by document authors. Typically, the various "surround" modes
+ available in modern sound systems (including systems based on basic stereo
+ speakers) tend to greatly alter the perceived spatial arrangement of audio
+ signals. The illusion of a three-dimensional sound stage is often achieved
+ using a combination of phase shifting, digital delay, volume control
+ (channel mixing), and other techniques. Some users may even configure
+ their system to "downgrade" any rendered sound to a single mono channel,
+ in which case the effect of the ‘<a href="#voice-balance"><code
+ class=property>voice-balance</code></a>’ property would obviously
+ not be perceivable at all. The rendering fidelity of authored content is
+ therefore dependent on such user customizations, and the ‘<a
+ href="#voice-balance"><code class=property>voice-balance</code></a>’
+ property merely specifies the desired end-result.
+
+ <p class=note> Note that many speech synthesizers only generate mono sound,
+ and therefore do not intrinsically support the ‘<a
+ href="#voice-balance"><code class=property>voice-balance</code></a>’
+ property. The sound distribution along the left-right axis consequently
+ occurs at post-synthesis stage (when the speech-enabled user-agent mixes
+ the various audio sources authored within the document)
+
<h2 id=speaking-props><span class=secno>6. </span>Speaking properties</h2>
<h3 id=speaking-props-speak><span class=secno>6.1. </span>The ‘<a
@@ -2119,7 +2119,7 @@
<tr>
<td> <em>Value:</em>
- <td><frequency> && relative? | <semitones> |
+ <td><frequency> && absolute? | <semitones> |
<percentage> | x-low | low | medium | high | x-high
<tr>
@@ -2174,18 +2174,20 @@
<dd>
<p> A value in <a href="#frequency-def">frequency</a> units (Hertz or
kiloHertz, e.g. "100Hz", "+2kHz"). Values are restricted to positive
- numbers, unless the ‘<code class=property>relative</code>’
- keyword is used. Computed frequency values that are negative numbers
- result in the property being ignored.</p>
+ numbers when the ‘<code class=property>absolute</code>’
+ keyword is used. Otherwise, a negative value represents an decrement,
+ and a positive value represents an increment (relative to the inherited
+ frequency value). For example, "2kHz" is a positive offset (strictly
+ equivalent to "+2kHz"), unlike "+2kHz absolute" which is an absolute
+ frequency value (strictly equivalent to "2kHz absolute"). Computed
+ frequency values that are negative numbers result in the property being
+ ignored.</p>
- <dt> <strong>relative</strong>
+ <dt> <strong>absolute</strong>
<dd>
<p> This keyword specifies that the provided frequency value is expressed
- relatively to the inherited value, using a positive or negative offset.
- For example, "2kHz relative" is an increment (strictly equivalent to
- "+2kHz relative"), unlike "+2kHz" which is an absolute value (strictly
- equivalent to "2kHz").</p>
+ as a positive absolute value.</p>
<dt> <strong><semitones></strong>
@@ -2223,13 +2225,13 @@
<p>Examples of property values:</p>
<pre>
-h1 { voice-pitch: 250Hz; }
+h1 { voice-pitch: 250Hz; } /* positive offset relative to the inherited absolute frequency */
h1 { voice-pitch: +250Hz; } /* identical to the line above */
-h2 { voice-pitch: +30Hz relative; }
-h2 { voice-pitch: 30Hz relative; } /* identical to the line above */
-h3 { voice-pitch: relative -20Hz; } /* the swapped keyword placement is a legal syntax */
-h4 { voice-pitch: -20Hz; } /* Illegal syntax ! ("relative" keyword is missing for negative frequency) */
-h4 { voice-pitch: -3.5st; } /* Legal syntax: semitones are always relative, no need for the keyword. */
+h2 { voice-pitch: +30Hz absolute; } /* not an increment! */
+h2 { voice-pitch: absolute 30Hz; } /* identical to the line above */
+h3 { voice-pitch: -20Hz; } /* negative offset (decrement) relative to the inherited absolute frequency */
+h4 { voice-pitch: -20Hz absolute; } /* Illegal syntax ! ("absolute" keyword not allowed with negative frequency) */
+h4 { voice-pitch: -3.5st; } /* Semitones are always relative, no need for the keyword. */
</pre>
</div>
@@ -2247,7 +2249,7 @@
<tr>
<td> <em>Value:</em>
- <td><frequency> && relative? | <semitones> |
+ <td><frequency> && absolute? | <semitones> |
<percentage> | x-low | low | medium | high | x-high
<tr>
@@ -2302,18 +2304,20 @@
<dd>
<p> A value in <a href="#frequency-def">frequency</a> units (Hertz or
kiloHertz, e.g. "100Hz", "+2kHz"). Values are restricted to positive
- numbers, unless the ‘<code class=property>relative</code>’
- keyword is used. Computed frequency values that are negative numbers
- result in the property being ignored.</p>
+ numbers when the ‘<code class=property>absolute</code>’
+ keyword is used. Otherwise, a negative value represents an decrement,
+ and a positive value represents an increment (relative to the inherited
+ frequency value). For example, "2kHz" is a positive offset (strictly
+ equivalent to "+2kHz"), unlike "+2kHz absolute" which is an absolute
+ frequency value (strictly equivalent to "2kHz absolute"). Computed
+ frequency values that are negative numbers result in the property being
+ ignored.</p>
- <dt> <strong>relative</strong>
+ <dt> <strong>absolute</strong>
<dd>
<p> This keyword specifies that the provided frequency value is expressed
- relatively to the inherited value, using a positive or negative offset.
- For example, "2kHz relative" is an increment (strictly equivalent to
- "+2kHz relative"), unlike "+2kHz" which is an absolute value (strictly
- equivalent to "2kHz").</p>
+ as a positive absolute value.</p>
<dt> <strong><semitones></strong>
@@ -2972,7 +2976,7 @@
<tr>
<td><a class=property href="#voice-pitch">voice-pitch</a>
- <td><frequency> && relative? | <semitones> |
+ <td><frequency> && absolute? | <semitones> |
<percentage> | x-low | low | medium | high | x-high
<td>medium
@@ -2988,7 +2992,7 @@
<tr>
<td><a class=property href="#voice-pitch-range">voice-pitch-range</a>
- <td><frequency> && relative? | <semitones> |
+ <td><frequency> && absolute? | <semitones> |
<percentage> | x-low | low | medium | high | x-high
<td>medium
@@ -3535,8 +3539,7 @@
class=property>voice-family</code></a>’ selection algorithm to
cater for language changes.
- <li>Separated definition of semitones, as they are relative values already
- (unlike Hz frequencies).
+ <li>Separated definition of semitones (pitch properties).
<li>More consistent behavior when audio cue URI fails (for whatever
reason).
@@ -3564,7 +3567,7 @@
value for ‘<a href="#voice-stress"><code
class=property>voice-stress</code></a>’.
- <li>Separated the ‘<code class=property>relative</code>’
+ <li>Separated the ‘<code class=property>absolute</code>’
keyword for ‘<a href="#voice-pitch"><code
class=property>voice-pitch</code></a>’ and ‘<code
class=property>voice-range</code>’.
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -d -r1.71 -r1.72
--- Overview.src.html 13 Jul 2011 17:26:29 -0000 1.71
+++ Overview.src.html 13 Jul 2011 17:56:36 -0000 1.72
@@ -482,22 +482,6 @@
used altogether in order to emulate the behavior of the 'center' value. </li>
</ul>
- <p class="note"> Note that sound systems may be configured by users in such a way that it would
- interfere with the left-right audio distribution specified by document authors. Typically, the
- various "surround" modes available in modern sound systems (including systems based on basic
- stereo speakers) tend to greatly alter the perceived spatial arrangement of audio signals. The
- illusion of a three-dimensional sound stage is often achieved using a combination of phase
- shifting, digital delay, volume control (channel mixing), and other techniques. Some users may
- even configure their system to "downgrade" any rendered sound to a single mono channel, in
- which case the effect of the 'voice-balance' property would obviously not be perceivable at
- all. The rendering fidelity of authored content is therefore dependent on such user
- customizations, and the 'voice-balance' property merely specifies the desired end-result. </p>
-
- <p class="note"> Note that many speech synthesizers only generate mono sound, and therefore do
- not intrinsically support the 'voice-balance' property. The sound distribution along the
- left-right axis consequently occurs at post-synthesis stage (when the speech-enabled
- user-agent mixes the various audio sources authored within the document) </p>
-
<p> Future revisions of the CSS Speech module may include support for three-dimensional audio,
which would effectively enable authors to specify "azimuth" and "elevation" values. In the
future, content authored using the current specification may therefore be consumed by
@@ -518,6 +502,22 @@
degrees.</li>
</ul>
+ <p class="note"> Note that sound systems may be configured by users in such a way that it would
+ interfere with the left-right audio distribution specified by document authors. Typically, the
+ various "surround" modes available in modern sound systems (including systems based on basic
+ stereo speakers) tend to greatly alter the perceived spatial arrangement of audio signals. The
+ illusion of a three-dimensional sound stage is often achieved using a combination of phase
+ shifting, digital delay, volume control (channel mixing), and other techniques. Some users may
+ even configure their system to "downgrade" any rendered sound to a single mono channel, in
+ which case the effect of the 'voice-balance' property would obviously not be perceivable at
+ all. The rendering fidelity of authored content is therefore dependent on such user
+ customizations, and the 'voice-balance' property merely specifies the desired end-result. </p>
+
+ <p class="note"> Note that many speech synthesizers only generate mono sound, and therefore do
+ not intrinsically support the 'voice-balance' property. The sound distribution along the
+ left-right axis consequently occurs at post-synthesis stage (when the speech-enabled
+ user-agent mixes the various audio sources authored within the document) </p>
+
<h2 id="speaking-props">Speaking properties</h2>
<h3 id="speaking-props-speak">The 'speak' property</h3>
<table class="propdef" summary="name: syntax">
@@ -1666,7 +1666,7 @@
<td>
<em>Value:</em>
</td>
- <td><frequency> && relative? | <semitones> | <percentage> |
+ <td><frequency> && absolute? | <semitones> | <percentage> |
x-low | low | medium | high | x-high </td>
</tr>
<tr>
@@ -1721,18 +1721,19 @@
</dt>
<dd>
<p> A value in <a href="#frequency-def">frequency</a> units (Hertz or kiloHertz, e.g.
- "100Hz", "+2kHz"). Values are restricted to positive numbers, unless the 'relative'
- keyword is used. Computed frequency values that are negative numbers result in the
- property being ignored. </p>
+ "100Hz", "+2kHz"). Values are restricted to positive numbers when the 'absolute' keyword
+ is used. Otherwise, a negative value represents an decrement, and a positive value
+ represents an increment (relative to the inherited frequency value). For example, "2kHz"
+ is a positive offset (strictly equivalent to "+2kHz"), unlike "+2kHz absolute" which is an
+ absolute frequency value (strictly equivalent to "2kHz absolute"). Computed frequency
+ values that are negative numbers result in the property being ignored. </p>
</dd>
<dt>
- <strong>relative</strong>
+ <strong>absolute</strong>
</dt>
<dd>
- <p> This keyword specifies that the provided frequency value is expressed relatively to the
- inherited value, using a positive or negative offset. For example, "2kHz relative" is an
- increment (strictly equivalent to "+2kHz relative"), unlike "+2kHz" which is an absolute
- value (strictly equivalent to "2kHz"). </p>
+ <p> This keyword specifies that the provided frequency value is expressed as a positive
+ absolute value.</p>
</dd>
<dt>
<strong><semitones></strong>
@@ -1767,13 +1768,13 @@
<div class="example">
<p>Examples of property values:</p>
<pre>
-h1 { voice-pitch: 250Hz; }
+h1 { voice-pitch: 250Hz; } /* positive offset relative to the inherited absolute frequency */
h1 { voice-pitch: +250Hz; } /* identical to the line above */
-h2 { voice-pitch: +30Hz relative; }
-h2 { voice-pitch: 30Hz relative; } /* identical to the line above */
-h3 { voice-pitch: relative -20Hz; } /* the swapped keyword placement is a legal syntax */
-h4 { voice-pitch: -20Hz; } /* Illegal syntax ! ("relative" keyword is missing for negative frequency) */
-h4 { voice-pitch: -3.5st; } /* Legal syntax: semitones are always relative, no need for the keyword. */
+h2 { voice-pitch: +30Hz absolute; } /* not an increment! */
+h2 { voice-pitch: absolute 30Hz; } /* identical to the line above */
+h3 { voice-pitch: -20Hz; } /* negative offset (decrement) relative to the inherited absolute frequency */
+h4 { voice-pitch: -20Hz absolute; } /* Illegal syntax ! ("absolute" keyword not allowed with negative frequency) */
+h4 { voice-pitch: -3.5st; } /* Semitones are always relative, no need for the keyword. */
</pre>
</div>
<h3 id="voice-props-voice-pitch-range">The 'voice-pitch-range' property</h3>
@@ -1789,7 +1790,7 @@
<td>
<em>Value:</em>
</td>
- <td><frequency> && relative? | <semitones> | <percentage> |
+ <td><frequency> && absolute? | <semitones> | <percentage> |
x-low | low | medium | high | x-high </td>
</tr>
<tr>
@@ -1845,18 +1846,19 @@
</dt>
<dd>
<p> A value in <a href="#frequency-def">frequency</a> units (Hertz or kiloHertz, e.g.
- "100Hz", "+2kHz"). Values are restricted to positive numbers, unless the 'relative'
- keyword is used. Computed frequency values that are negative numbers result in the
- property being ignored. </p>
+ "100Hz", "+2kHz"). Values are restricted to positive numbers when the 'absolute' keyword
+ is used. Otherwise, a negative value represents an decrement, and a positive value
+ represents an increment (relative to the inherited frequency value). For example, "2kHz"
+ is a positive offset (strictly equivalent to "+2kHz"), unlike "+2kHz absolute" which is an
+ absolute frequency value (strictly equivalent to "2kHz absolute"). Computed frequency
+ values that are negative numbers result in the property being ignored. </p>
</dd>
<dt>
- <strong>relative</strong>
+ <strong>absolute</strong>
</dt>
<dd>
- <p> This keyword specifies that the provided frequency value is expressed relatively to the
- inherited value, using a positive or negative offset. For example, "2kHz relative" is an
- increment (strictly equivalent to "+2kHz relative"), unlike "+2kHz" which is an absolute
- value (strictly equivalent to "2kHz"). </p>
+ <p> This keyword specifies that the provided frequency value is expressed as a positive
+ absolute value.</p>
</dd>
<dt>
<strong><semitones></strong>
@@ -2478,8 +2480,7 @@
<li>Added the 'normal' value for voice-rate ("default" in SSML 1.1).</li>
<li>Renamed voice-family fields to be consistent with SSML.</li>
<li>Improved the 'voice-family' selection algorithm to cater for language changes.</li>
- <li>Separated definition of semitones, as they are relative values already (unlike Hz
- frequencies).</li>
+ <li>Separated definition of semitones (pitch properties).</li>
<li>More consistent behavior when audio cue URI fails (for whatever reason).</li>
<li>Enabled voice-family names to contain spaces, matching 'font-family' syntax which is based
on quoted strings and concatenated identifiers.</li>
@@ -2491,7 +2492,7 @@
'young' and 'old'). This aligns with SSML. </li>
<li>Improved the pause collapsing prose, removed redundant paragraphs.</li>
<li>Added the missing 'normal' value for 'voice-stress'.</li>
- <li>Separated the 'relative' keyword for 'voice-pitch' and 'voice-range'.</li>
+ <li>Separated the 'absolute' keyword for 'voice-pitch' and 'voice-range'.</li>
<li>Improved document structure by adding sub-sections.</li>
<li>Removed the implicit 'inherit' value for all properties.</li>
<li>Fixed typos and made other minor edits.</li>
Received on Wednesday, 13 July 2011 17:56:40 UTC