- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 Jul 2011 22:48:31 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv28911
Modified Files:
Overview.html Overview.src.html
Log Message:
voice-rate "computed value" fix, made consistent with voice-volume by allowing combination of keyword and percentage, added example.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.81
retrieving revision 1.82
diff -u -d -r1.81 -r1.82
--- Overview.html 13 Jul 2011 22:12:17 -0000 1.81
+++ Overview.html 13 Jul 2011 22:48:29 -0000 1.82
@@ -548,7 +548,7 @@
<tr>
<td> <em>Computed value:</em>
- <td>keyword value, and decibel offset (if not zero)
+ <td>a keyword value, and optionally also a decibel offset (if not zero)
</table>
<p>The ‘<a href="#voice-volume"><code
@@ -618,15 +618,16 @@
(decibel unit). This represents a change (positive or negative) relative
to the given keyword value (see enumeration above), or to the default
value for the root element, or otherwise to the inherited volume level
- (which may itself be be a combination of a keyword value and of a
- decibel offset). When the inherited volume level is ‘<code
+ (which may itself be a combination of a keyword value and of a decibel
+ offset, in which case the decibel values are combined additively). When
+ the inherited volume level is ‘<code
class=property>silent</code>’, this ‘<a
href="#voice-volume"><code class=property>voice-volume</code></a>’
resolves to ‘<code class=property>silent</code>’ too,
- regardless of the specified <decibel> value. Decibels express the
- ratio of the squares of the new signal amplitude (a1) and the current
- amplitude (a0), as per the following logarithmic equation: volume(dB) =
- 20 log10 (a1 / a0)</p>
+ regardless of the specified <decibel> value. Decibels represent
+ the ratio of the squares of the new signal amplitude (a1) and the
+ current amplitude (a0), as per the following logarithmic equation:
+ volume(dB) = 20 log10 (a1 / a0)</p>
<p class=note> Note that -6.0dB is approximately half the amplitude of
the audio signal, and +6.0dB is approximately twice the amplitude.</p>
@@ -691,7 +692,9 @@
<tr>
<td> <em>Computed value:</em>
- <td>specified value
+ <td>the specified value resolved to a <number> between
+ ‘<code class=css>-100</code>’ and ‘<code
+ class=css>100</code>’ (inclusive)
</table>
<p> The ‘<a href="#voice-balance"><code
@@ -2033,8 +2036,8 @@
<tr>
<td> <em>Value:</em>
- <td>normal | <percentage> | x-slow | slow | medium | fast | x-fast
-
+ <td>[normal | x-slow | slow | medium | fast | x-fast] ||
+ <percentage>
<tr>
<td> <em>Initial:</em>
@@ -2064,7 +2067,8 @@
<tr>
<td> <em>Computed value:</em>
- <td>specified value
+ <td>a keyword value, and optionally also a percentage relative to the
+ keyword (if not 100%)
</table>
<p>The ‘<a href="#voice-rate"><code
@@ -2085,26 +2089,69 @@
currently active voice. This is processor-specific and depends on the
language, dialect and on the "personality" of the voice.</p>
- <dt> <strong><percentage></strong>
-
- <dd>
- <p>Only non-negative <a href="#percentage-def">percentage</a> values are
- allowed. Computed values are calculated relative to the default speaking
- rate for the voice (the "normal" computed value). For example, 50% means
- that the default value gets multiplied by 0.5, which results in half the
- default rate of the voice.</p>
-
<dt><strong>x-slow</strong>, <strong>slow</strong>,
<strong>medium</strong>, <strong>fast</strong> and
<strong>x-fast</strong>
<dd>
<p>A sequence of monotonically non-decreasing speaking rates that are
- implementation and voice specific. For example, typical values for the
+ implementation and voice -specific. For example, typical values for the
English language are (in words per minute) x-slow = 80, slow = 120,
medium = between 180 and 200, fast = 500.</p>
+
+ <dt> <strong><percentage></strong>
+
+ <dd>
+ <p>Only non-negative <a href="#percentage-def">percentage</a> values are
+ allowed. This represents a change relative to the given keyword value
+ (see enumeration above), or to the default value for the root element,
+ or otherwise to the inherited speaking rate (which may itself be a
+ combination of a keyword value and of a percentage, in which case
+ percentages are combined multiplicatively). For example, 50% means that
+ the speaking rate gets multiplied by 0.5 (half the value).</p>
</dl>
+ <div class=example>
+ <p>Examples of inherited values:</p>
+
+ <pre>
+<body>
+ <e1>
+ <e2>
+ <e3>
+ ...
+ </e3>
+ </e2>
+ </e1>
+</body>
+
+
+
+
+body { voice-rate: inherit; } /* the initial value is 'normal'
+ (the actual speaking rate value
+ depends on the active voice) */
+
+e1 { voice-rate: +50%; } /* the computed value is
+ ['normal' and 50%], which will resolve
+ to the rate corresponding to 'normal'
+ multiplied by 0.5 (half the speaking rate) */
+
+e2 { voice-rate: fast 120%; } /* the computed value is
+ ['fast' and 120%], which will resolve
+ to the rate corresponding to 'fast'
+ multiplied by 1.2 (one and a half times the speaking rate) */
+
+e3 { voice-rate: normal; /* "resets" the speaking rate to the intrinsic voice value,
+ the computed value is 'normal' (see comment below for actual value) */
+
+ voice-family: "another-voice"; } /* because the voice is different,
+ the calculated speaking rate may vary
+ compared to "body" (even though the computed
+ 'voice-rate' value is the same) */
+ </pre>
+ </div>
+
<h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The ‘<a
href="#voice-pitch"><code class=property>voice-pitch</code></a>’
property</h3>
@@ -2152,7 +2199,7 @@
<td>an absolute frequency, or a keyword value and potentially also a
frequency, semitone, and/or percentage representing any non-zero
- offsets
+ offsets (relative to the keyword)
</table>
<p>The ‘<a href="#voice-pitch"><code
@@ -2294,7 +2341,7 @@
<td>an absolute frequency, or a keyword value and potentially also a
frequency, semitone, and/or percentage representing any non-zero
- offsets
+ offsets (relative to the keyword)
</table>
<p> The ‘<a href="#voice-range"><code
@@ -3098,7 +3145,8 @@
<tr>
<td><a class=property href="#voice-rate">voice-rate</a>
- <td>normal | <percentage> | x-slow | slow | medium | fast | x-fast
+ <td>[normal | x-slow | slow | medium | fast | x-fast] ||
+ <percentage>
<td>normal
@@ -3634,6 +3682,12 @@
<li>Added the ‘<code class=property>normal</code>’ value for
voice-rate ("default" in SSML 1.1).
+ <li>Fixed the "computed value" for voice-rate, and added the possibility
+ to combine keywords and percentages (to be consistent with ‘<a
+ href="#voice-volume"><code
+ class=property>voice-volume</code></a>’). Added an example to
+ illustrate inheritance and value resolution.
+
<li>Renamed voice-family fields to be consistent with SSML.
<li>Improved the ‘<a href="#voice-family"><code
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.82
retrieving revision 1.83
diff -u -d -r1.82 -r1.83
--- Overview.src.html 13 Jul 2011 22:12:17 -0000 1.82
+++ Overview.src.html 13 Jul 2011 22:48:29 -0000 1.83
@@ -292,7 +292,7 @@
<td>
<em>Computed value:</em>
</td>
- <td>keyword value, and decibel offset (if not zero)</td>
+ <td>a keyword value, and optionally also a decibel offset (if not zero)</td>
</tr>
</tbody>
</table>
@@ -342,11 +342,12 @@
<p>A <a href="#number-def">number</a> immediately followed by "dB" (decibel unit). This
represents a change (positive or negative) relative to the given keyword value (see
enumeration above), or to the default value for the root element, or otherwise to the
- inherited volume level (which may itself be be a combination of a keyword value and of a
- decibel offset). When the inherited volume level is 'silent', this 'voice-volume' resolves
- to 'silent' too, regardless of the specified <decibel> value. Decibels express the
- ratio of the squares of the new signal amplitude (a1) and the current amplitude (a0), as
- per the following logarithmic equation: volume(dB) = 20 log10 (a1 / a0) </p>
+ inherited volume level (which may itself be a combination of a keyword value and of a
+ decibel offset, in which case the decibel values are combined additively). When the
+ inherited volume level is 'silent', this 'voice-volume' resolves to 'silent' too,
+ regardless of the specified <decibel> value. Decibels represent the ratio of the
+ squares of the new signal amplitude (a1) and the current amplitude (a0), as per the
+ following logarithmic equation: volume(dB) = 20 log10 (a1 / a0) </p>
<p class="note"> Note that -6.0dB is approximately half the amplitude of the audio signal,
and +6.0dB is approximately twice the amplitude.</p>
</dd>
@@ -408,7 +409,8 @@
<td>
<em>Computed value:</em>
</td>
- <td>specified value</td>
+ <td>the specified value resolved to a <number> between '-100' and '100'
+ (inclusive)</td>
</tr>
</tbody>
</table>
@@ -1582,7 +1584,7 @@
<td>
<em>Value:</em>
</td>
- <td>normal | <percentage> | x-slow | slow | medium | fast | x-fast </td>
+ <td>[normal | x-slow | slow | medium | fast | x-fast] || <percentage></td>
</tr>
<tr>
<td>
@@ -1618,7 +1620,8 @@
<td>
<em>Computed value:</em>
</td>
- <td>specified value</td>
+ <td>a keyword value, and optionally also a percentage relative to the keyword (if not
+ 100%)</td>
</tr>
</tbody>
</table>
@@ -1636,23 +1639,66 @@
voice. This is processor-specific and depends on the language, dialect and on the
"personality" of the voice. </p>
</dd>
- <dt>
- <strong><percentage></strong>
- </dt>
- <dd>
- <p>Only non-negative <a href="#percentage-def">percentage</a> values are allowed. Computed
- values are calculated relative to the default speaking rate for the voice (the "normal"
- computed value). For example, 50% means that the default value gets multiplied by 0.5,
- which results in half the default rate of the voice.</p>
- </dd>
<dt><strong>x-slow</strong>, <strong>slow</strong>, <strong>medium</strong>,
<strong>fast</strong> and <strong>x-fast</strong></dt>
<dd>
<p>A sequence of monotonically non-decreasing speaking rates that are implementation and
- voice specific. For example, typical values for the English language are (in words per
+ voice -specific. For example, typical values for the English language are (in words per
minute) x-slow = 80, slow = 120, medium = between 180 and 200, fast = 500. </p>
</dd>
+ <dt>
+ <strong><percentage></strong>
+ </dt>
+ <dd>
+ <p>Only non-negative <a href="#percentage-def">percentage</a> values are allowed. This
+ represents a change relative to the given keyword value (see enumeration above), or to the
+ default value for the root element, or otherwise to the inherited speaking rate (which may
+ itself be a combination of a keyword value and of a percentage, in which case percentages
+ are combined multiplicatively). For example, 50% means that the speaking rate gets
+ multiplied by 0.5 (half the value).</p>
+ </dd>
</dl>
+
+ <div class="example">
+ <p>Examples of inherited values:</p>
+ <pre>
+<body>
+ <e1>
+ <e2>
+ <e3>
+ ...
+ </e3>
+ </e2>
+ </e1>
+</body>
+
+
+
+
+body { voice-rate: inherit; } /* the initial value is 'normal'
+ (the actual speaking rate value
+ depends on the active voice) */
+
+e1 { voice-rate: +50%; } /* the computed value is
+ ['normal' and 50%], which will resolve
+ to the rate corresponding to 'normal'
+ multiplied by 0.5 (half the speaking rate) */
+
+e2 { voice-rate: fast 120%; } /* the computed value is
+ ['fast' and 120%], which will resolve
+ to the rate corresponding to 'fast'
+ multiplied by 1.2 (one and a half times the speaking rate) */
+
+e3 { voice-rate: normal; /* "resets" the speaking rate to the intrinsic voice value,
+ the computed value is 'normal' (see comment below for actual value) */
+
+ voice-family: "another-voice"; } /* because the voice is different,
+ the calculated speaking rate may vary
+ compared to "body" (even though the computed
+ 'voice-rate' value is the same) */
+ </pre>
+ </div>
+
<h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
<table class="propdef" summary="name: syntax">
<tbody>
@@ -1704,7 +1750,7 @@
<em>Computed value:</em>
</td>
<td>an absolute frequency, or a keyword value and potentially also a frequency, semitone,
- and/or percentage representing any non-zero offsets </td>
+ and/or percentage representing any non-zero offsets (relative to the keyword)</td>
</tr>
</tbody>
</table>
@@ -1839,7 +1885,7 @@
<em>Computed value:</em>
</td>
<td>an absolute frequency, or a keyword value and potentially also a frequency, semitone,
- and/or percentage representing any non-zero offsets </td>
+ and/or percentage representing any non-zero offsets (relative to the keyword) </td>
</tr>
</tbody>
</table>
@@ -2568,6 +2614,9 @@
axis and three-dimensional sound stage (azimuth support in future versions of
CSS-Speech).</li>
<li>Added the 'normal' value for voice-rate ("default" in SSML 1.1).</li>
+ <li>Fixed the "computed value" for voice-rate, and added the possibility to combine keywords
+ and percentages (to be consistent with 'voice-volume'). Added an example to illustrate
+ inheritance and value resolution.</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 (pitch properties).</li>
Received on Wednesday, 13 July 2011 22:48:38 UTC