- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 10 May 2011 23:05:21 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech In directory hutz:/tmp/cvs-serv14177 Modified Files: Overview.html Overview.src.html default.css Log Message: added references to SSML for each property. reworded property intro line wherever necessary. Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-speech/Overview.html,v retrieving revision 1.44 retrieving revision 1.45 diff -u -d -r1.44 -r1.45 --- Overview.html 10 May 2011 20:41:36 -0000 1.44 +++ Overview.html 10 May 2011 23:05:19 -0000 1.45 @@ -5,8 +5,7 @@ <head> <title>CSS Speech Module</title> <meta content="text/html; charset=utf-8" http-equiv=Content-Type> - <link href="http://dev.w3.org/csswg/default.css" rel=stylesheet - type="text/css"> + <link href="../default.css" rel=stylesheet type="text/css"> <style type="text/css"> *:target @@ -81,13 +80,13 @@ <h1 id=top>CSS Speech Module</h1> - <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 10 May 2011</h2> + <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 11 May 2011</h2> <dl> <dt>This version: <dd> - <!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110510">http://www.w3.org/TR/2011/ED-css3-speech-20110510/</a>--> + <!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110511">http://www.w3.org/TR/2011/ED-css3-speech-20110511/</a>--> <a href="http://dev.w3.org/csswg/css3-speech">http://dev.w3.org/csswg/css3-speech</a> @@ -572,31 +571,20 @@ </table> <p>The ‘<a href="#voice-volume"><code - class=property>voice-volume</code></a>’ refers to the amplitude of - the waveform output by the speech synthesiser. This may be mixed with - other audio sources, influencing the perceived loudness of synthetic - speech relative to these sources.</p> - <!-- p> - 'voice-volume' does not apply to <a href - ="#cue-props">audio cues</a> for which there is a separate means - to set loudness (absolute, or relative to 'voice-volume'). - <span class="issue" id="issue-voice-cues-volume"> - ISSUE: shouldn't audio cues be subjected to the voice-volume, - so that an inaudible element gets its entire content (within the aural "box" model) muted as well ? - The rationale is that voice-volume:silent is largely equivalent to visibility:hidden, - which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model). - The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted. - </span> - </p --> - - <p>Values have the following meanings: + class=property>voice-volume</code></a>’ property manipulates the + amplitude of the audio waveform generated by the speech synthesiser, and + is also used to calculate the relative volume level of <a + href="#cue-props">audio cues</a> within the <a href="#aural-model">audio + "box" model</a>. - <dl><!-- dt><strong>auto</strong></dt> - <dd> - Resolves to a computed value of 'medium' when 'visibility' is 'visible', - otherwise resolves to a computed value of 'silent'. - </dd --> + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>volume</code> + attribute of the <code>prosody</code> element</a> from the SSML markup + language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. + <dl> <dt> <strong><non-negative number></strong> <dd>An integer or floating point <a @@ -651,7 +639,19 @@ <!-- (including its descendants, which cannot override the inherited 'none' value). --> (although descendants can override the ‘<a href="#speak"><code class=property>speak</code></a>’ value and may therefore generate - audio output). + audio output).</p> + <!-- p> + 'voice-volume' does not apply to <a href + ="#cue-props">audio cues</a> for which there is a separate means + to set loudness (absolute, or relative to 'voice-volume'). + <span class="issue" id="issue-voice-cues-volume"> + ISSUE: shouldn't audio cues be subjected to the voice-volume, + so that an inaudible element gets its entire content (within the aural "box" model) muted as well ? + The rationale is that voice-volume:silent is largely equivalent to visibility:hidden, + which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model). + The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted. + </span> + </p --> <h3 id=mixing-props-voice-balance><span class=secno>3.2. </span>The ‘<a href="#voice-balance"><code @@ -702,11 +702,13 @@ </table> <p>The ‘<a href="#voice-balance"><code - class=property>voice-balance</code></a>’ property refers to the - balance between left and right channels, and presumes a two channel - (stereo) model that is widely supported on consumer audio equipment. + class=property>voice-balance</code></a>’ property manipulates the + distribution of audio output between left and right channels in + stereo-capable sound devices. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property has no + match in the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><number></strong> @@ -809,13 +811,13 @@ <td>specified value </table> - <!-- p class="issue" id="issue-speakability-name"> - ISSUE: should the "speakability" property be named differently ? e.g. "speaking" - </p --> - <p>This property specifies whether text will be rendered aurally. + <p>The ‘<a href="#speak"><code class=property>speak</code></a>’ + property determines whether or not to render text aurally. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property has no + match in the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong>auto</strong> @@ -920,9 +922,15 @@ <td>specified value </table> - <p>This property specifies in what manner text gets rendered aurally. + <p>The ‘<a href="#speak-as"><code + class=property>speak-as</code></a>’ property determines in what + manner text gets rendered aurally. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_say-as"><code>say-as</code> + element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong>normal</strong> @@ -1064,13 +1072,22 @@ <td>specified value </table> - <p>These properties specify a pause or prosodic boundary to be observed - before (or after) an element or, if any ‘<a href="#cue-before"><code + <p>The ‘<a href="#pause-before"><code + class=property>pause-before</code></a>’ and ‘<a + href="#pause-after"><code class=property>pause-after</code></a>’ + properties specify a prosodic boundary (silence with a specific duration) + that occurs before (or after) the speech synthesis rendition of the + selected element, or if any ‘<a href="#cue-before"><code class=property>cue-before</code></a>’ (or ‘<a href="#cue-after"><code class=property>cue-after</code></a>’) is - specified, before (or after) these. + specified, before (or after) the cue within the <a + href="#aural-model">audio "box" model</a>. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_break"><code>break</code> + element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><time></strong> @@ -1148,7 +1165,7 @@ </table> <p>The ‘<a href="#pause"><code class=property>pause</code></a>’ - property is a shorthand for setting ‘<a href="#pause-before"><code + property is a shorthand property for ‘<a href="#pause-before"><code class=property>pause-before</code></a>’ and ‘<a href="#pause-after"><code class=property>pause-after</code></a>’. If two values are given, the first value is ‘<a @@ -1341,10 +1358,18 @@ <td>specified value </table> - <p>These properties specify a rest or prosodic boundary to be observed - before (or after) speaking an element's content. + <p>The ‘<a href="#rest-before"><code + class=property>rest-before</code></a>’ and ‘<a + href="#rest-after"><code class=property>rest-after</code></a>’ + properties specify a prosodic boundary (silence with a specific duration) + that occurs before (or after) the speech synthesis rendition of an element + within the <a href="#aural-model">audio "box" model</a>. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_break"><code>break</code> + element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><time></strong> @@ -1429,7 +1454,7 @@ </table> <p>The ‘<a href="#rest"><code class=property>rest</code></a>’ - property is a shorthand for setting ‘<a href="#rest-before"><code + property is a shorthand for ‘<a href="#rest-before"><code class=property>rest-before</code></a>’ and ‘<a href="#rest-after"><code class=property>rest-after</code></a>’. If two values are given, the first value is ‘<a @@ -1542,10 +1567,18 @@ <td>specified value </table> - <p>Auditory icons are another way to distinguish semantic elements. Sounds - can be played before and/or after the element to delimit it. + <p>The ‘<a href="#cue-before"><code + class=property>cue-before</code></a>’ and ‘<a + href="#cue-after"><code class=property>cue-after</code></a>’ + properties specify auditory icons (i.e. prerecorded audio clips) to be + played before (or after) the selected element within the <a + href="#aural-model">audio "box" model</a>. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_audio"><code>audio</code> + element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><uri></strong> @@ -1666,7 +1699,7 @@ </table> <p>The ‘<a href="#cue"><code class=property>cue</code></a>’ - property is a shorthand for setting ‘<a href="#cue-before"><code + property is a shorthand for ‘<a href="#cue-before"><code class=property>cue-before</code></a>’ and ‘<a href="#cue-after"><code class=property>cue-after</code></a>’. If two values are given the first value is ‘<a href="#cue-before"><code @@ -1925,11 +1958,17 @@ <td>specified value </table> - <p>The value is a comma-separated, prioritized list of voice family names - (note the similarity with ‘<code - class=property>font-family</code>’). + <p>The ‘<a href="#voice-family"><code + class=property>voice-family</code></a>’ property specifies a + comma-separated, prioritized list of values that designate speech + synthesis voices. (analog to ‘<code + class=property>font-family</code>’ in visual style sheets). - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_voice"><code>voice</code> + element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><name></strong> @@ -2041,13 +2080,19 @@ <td>specified value </table> - <p>This property controls the speaking rate. The default rate for a voice - depends on the language and dialect and on the personality of the voice. - The default rate for a voice should be such that it is experienced as a - normal speaking rate for the voice when reading aloud text. Since voices - are processor-specific, the default rate will be as well. + <p>The ‘<a href="#voice-rate"><code + class=property>voice-rate</code></a>’ property manipulates the speed + of generated synthetic speech. The default rate for a given ‘<a + href="#voice-family"><code class=property>voice-family</code></a>’ + is processor-specific, and depends on the language, dialect and on the + "personality" of the voice. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>rate</code> + attribute of the <code>prosody</code> element</a> from the SSML markup + language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><percentage></strong> @@ -2116,13 +2161,19 @@ <td>specified value </table> - <p>Specifies the average pitch (a frequency) of the speaking voice. The - average pitch of a voice depends on the ‘<a + <p>The ‘<a href="#voice-pitch"><code + class=property>voice-pitch</code></a>’ property specifies the + average pitch of generated speech output, and depends on the ‘<a href="#voice-family"><code class=property>voice-family</code></a>’. - For example, the average pitch for a standard male voice is around 120Hz, - but for a female voice, it's around 210Hz. + For example, the default average pitch for a common male voice is around + 120Hz, whereas it is around 210Hz for a female voice. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>pitch</code> + attribute of the <code>prosody</code> element</a> from the SSML markup + language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><frequency></strong> @@ -2229,14 +2280,20 @@ <td>specified value </table> - <p>Specifies variation in average pitch. Human languages are spoken with - varying inflection and pitch; these variations convey additional meaning - and emphasis. Thus, a highly animated voice, i.e., one that is heavily - inflected, displays a high pitch range. This property specifies the range - over which these variations occur, i.e., how much the fundamental - frequency may deviate from the average pitch. + <p> The ‘<a href="#voice-pitch-range"><code + class=property>voice-pitch-range</code></a>’ property specifies the + variability in average pitch, i.e. how much the fundamental frequency may + deviate from the average pitch. The dynamic pitch range of the generated + speech output typically increases for a highly animated voice, for example + when variations in inflection are used to convey meaning and emphasis in + speech. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>range</code> + attribute of the <code>prosody</code> element</a> from the SSML markup + language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong><frequency></strong> @@ -2293,12 +2350,12 @@ <tr> <td> <em>Value:</em> - <td>auto | strong | moderate | none | reduced | inherit + <td>normal | strong | moderate | none | reduced | inherit <tr> <td> <em>Initial:</em> - <td>auto + <td>normal <tr> <td> <em>Applies to:</em> @@ -2326,14 +2383,21 @@ <td>specified value </table> - <p>Indicates the strength of emphasis to be applied. Emphasis is applied - using a combination of pitch change, timing changes, loudness and other - acoustic differences, and is dependent on the language being spoken. + <p>The ‘<a href="#voice-stress"><code + class=property>voice-stress</code></a>’ property manipulates the + strength of emphasis, which is normally applied using a combination of + pitch change, timing changes, loudness and other acoustic differences. The + precise meaning of the values therefore depend on the language being + spoken. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_emphasis"><code>emphasis</code> + element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> - <dt> <strong>auto</strong> + <dt> <strong>normal</strong> <dd>Represents the default emphasis produced by the speech synthesizer. @@ -2427,14 +2491,21 @@ <td>specified value </table> - <p> Allows authors to specify how long it should take to render the - selected element's content. Unless the value ‘<code + <p> The ‘<a href="#voice-duration"><code + class=property>voice-duration</code></a>’ property specifies how + long it should take to render the selected element's content (excluding <a + href="#cue-props">audio cues</a> ). Unless the value ‘<code class=property>auto</code>’ is specified, this property takes precedence over the ‘<a href="#voice-rate"><code - class=property>voice-rate</code></a>’ property and must be used to + class=property>voice-rate</code></a>’ property and should be used to determine the speaking rate of the voice. - <p>Values have the following meanings: + <p class=note> Note that the functionality provided by this property is + related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>duration</code> + attribute of the <code>prosody</code> element</a> from the SSML markup + language <a href="#SPEECH-SYNTHESIS" + rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>. <dl> <dt> <strong>auto</strong> @@ -3103,9 +3174,9 @@ <tr valign=baseline> <td><a class=property href="#voice-stress">voice-stress</a> - <td>auto | strong | moderate | none | reduced | inherit + <td>normal | strong | moderate | none | reduced | inherit - <td>auto + <td>normal <td>all elements @@ -3573,7 +3644,7 @@ <li>Improved the pause collapsing prose, removed redundant paragraphs. - <li>Added the "auto" value for ‘<a href="#voice-stress"><code + <li>Added the "normal" value for ‘<a href="#voice-stress"><code class=property>voice-stress</code></a>’. <li>Improved document structure by adding sub-sections. Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v retrieving revision 1.45 retrieving revision 1.46 diff -u -d -r1.45 -r1.46 --- Overview.src.html 10 May 2011 20:41:36 -0000 1.45 +++ Overview.src.html 10 May 2011 23:05:19 -0000 1.46 @@ -3,7 +3,7 @@ <head> <title>CSS Speech Module</title> <meta content="text/html; charset=utf-8" http-equiv="Content-Type" /> - <link href="http://dev.w3.org/csswg/default.css" rel="stylesheet" type="text/css" /> + <link href="../default.css" rel="stylesheet" type="text/css" /> <style type="text/css"> *:target { @@ -313,28 +313,14 @@ </tr> </tbody> </table> - <p>The 'voice-volume' refers to the amplitude of the waveform output by the speech synthesiser. - This may be mixed with other audio sources, influencing the perceived loudness of synthetic - speech relative to these sources. </p> - <!-- p> - 'voice-volume' does not apply to <a href - ="#cue-props">audio cues</a> for which there is a separate means - to set loudness (absolute, or relative to 'voice-volume'). - <span class="issue" id="issue-voice-cues-volume"> - ISSUE: shouldn't audio cues be subjected to the voice-volume, - so that an inaudible element gets its entire content (within the aural "box" model) muted as well ? - The rationale is that voice-volume:silent is largely equivalent to visibility:hidden, - which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model). - The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted. - </span> - </p --> - <p>Values have the following meanings:</p> + <p>The 'voice-volume' property manipulates the amplitude of the audio waveform generated by the + speech synthesiser, and is also used to calculate the relative volume level of <a + href="#cue-props">audio cues</a> within the <a href="#aural-model">audio "box" + model</a>.</p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>volume</code> attribute of + the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> - <!-- dt><strong>auto</strong></dt> - <dd> - Resolves to a computed value of 'medium' when 'visibility' is 'visible', - otherwise resolves to a computed value of 'silent'. - </dd --> <dt> <strong><non-negative number></strong> </dt> @@ -367,6 +353,18 @@ is not rendered in the aural dimension <!-- (including its descendants, which cannot override the inherited 'none' value). --> (although descendants can override the 'speak' value and may therefore generate audio output). </p> + <!-- p> + 'voice-volume' does not apply to <a href + ="#cue-props">audio cues</a> for which there is a separate means + to set loudness (absolute, or relative to 'voice-volume'). + <span class="issue" id="issue-voice-cues-volume"> + ISSUE: shouldn't audio cues be subjected to the voice-volume, + so that an inaudible element gets its entire content (within the aural "box" model) muted as well ? + The rationale is that voice-volume:silent is largely equivalent to visibility:hidden, + which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model). + The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted. + </span> + </p --> <h3 id="mixing-props-voice-balance">The 'voice-balance' property</h3> <table class="propdef" summary="name: syntax"> <tbody> @@ -420,10 +418,10 @@ </tr> </tbody> </table> - <p>The 'voice-balance' property refers to the balance between left and right channels, and - presumes a two channel (stereo) model that is widely supported on consumer audio - equipment.</p> - <p>Values have the following meanings:</p> + <p>The 'voice-balance' property manipulates the distribution of audio output between left and + right channels in stereo-capable sound devices.</p> + <p class="note"> Note that the functionality provided by this property has no match in the SSML + markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><number></strong> @@ -520,11 +518,9 @@ </tr> </tbody> </table> - <!-- p class="issue" id="issue-speakability-name"> - ISSUE: should the "speakability" property be named differently ? e.g. "speaking" - </p --> - <p>This property specifies whether text will be rendered aurally.</p> - <p>Values have the following meanings:</p> + <p>The 'speak' property determines whether or not to render text aurally.</p> + <p class="note"> Note that the functionality provided by this property has no match in the SSML + markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong>auto</strong> @@ -619,8 +615,10 @@ </tr> </tbody> </table> - <p>This property specifies in what manner text gets rendered aurally.</p> - <p>Values have the following meanings:</p> + <p>The 'speak-as' property determines in what manner text gets rendered aurally.</p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_say-as"><code>say-as</code> element</a> + from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong>normal</strong> @@ -763,9 +761,13 @@ </tr> </tbody> </table> - <p>These properties specify a pause or prosodic boundary to be observed before (or after) an - element or, if any 'cue-before' (or 'cue-after') is specified, before (or after) these.</p> - <p>Values have the following meanings:</p> + <p>The 'pause-before' and 'pause-after' properties specify a prosodic boundary (silence with a + specific duration) that occurs before (or after) the speech synthesis rendition of the + selected element, or if any 'cue-before' (or 'cue-after') is specified, before (or after) the + cue within the <a href="#aural-model">audio "box" model</a>.</p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_break"><code>break</code> element</a> from + the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><time></strong> @@ -839,7 +841,7 @@ </tr> </tbody> </table> - <p>The 'pause' property is a shorthand for setting 'pause-before' and 'pause-after'. If two + <p>The 'pause' property is a shorthand property for 'pause-before' and 'pause-after'. If two values are given, the first value is 'pause-before' and the second is 'pause-after'. If only one value is given, it applies to both properties.</p> <div class="example"> @@ -990,9 +992,12 @@ </tr> </tbody> </table> - <p>These properties specify a rest or prosodic boundary to be observed before (or after) - speaking an element's content.</p> - <p>Values have the following meanings:</p> + <p>The 'rest-before' and 'rest-after' properties specify a prosodic boundary (silence with a + specific duration) that occurs before (or after) the speech synthesis rendition of an element + within the <a href="#aural-model">audio "box" model</a>. </p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_break"><code>break</code> element</a> from + the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><time></strong> @@ -1069,9 +1074,9 @@ </tr> </tbody> </table> - <p>The 'rest' property is a shorthand for setting 'rest-before' and 'rest-after'. If two values - are given, the first value is 'rest-before' and the second is 'rest-after'. If only one value - is given, it applies to both properties.</p> + <p>The 'rest' property is a shorthand for 'rest-before' and 'rest-after'. If two values are + given, the first value is 'rest-before' and the second is 'rest-after'. If only one value is + given, it applies to both properties.</p> <h2 id="cue-props">Cue properties</h2> <h3 id="cue-props-cue-before">The 'cue-before' property</h3> <table class="propdef" summary="name: syntax"> @@ -1184,9 +1189,12 @@ </tr> </tbody> </table> - <p>Auditory icons are another way to distinguish semantic elements. Sounds can be played before - and/or after the element to delimit it. </p> - <p>Values have the following meanings:</p> + <p>The 'cue-before' and 'cue-after' properties specify auditory icons (i.e. prerecorded audio + clips) to be played before (or after) the selected element within the <a href="#aural-model" + >audio "box" model</a>.</p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_audio"><code>audio</code> element</a> from + the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><uri></strong> @@ -1300,9 +1308,9 @@ </tr> </tbody> </table> - <p>The 'cue' property is a shorthand for setting 'cue-before' and 'cue-after'. If two values are - given the first value is 'cue-before' and the second is 'cue-after'. If only one value is - given, it applies to both properties.</p> + <p>The 'cue' property is a shorthand for 'cue-before' and 'cue-after'. If two values are given + the first value is 'cue-before' and the second is 'cue-after'. If only one value is given, it + applies to both properties.</p> <p>The following two rules are equivalent:</p> <div class="example"> <pre> @@ -1552,9 +1560,11 @@ </tr> </tbody> </table> - <p>The value is a comma-separated, prioritized list of voice family names (note the similarity - with 'font-family').</p> - <p>Values have the following meanings:</p> + <p>The 'voice-family' property specifies a comma-separated, prioritized list of values that + designate speech synthesis voices. (analog to 'font-family' in visual style sheets).</p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_voice"><code>voice</code> element</a> from + the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><name></strong> @@ -1652,11 +1662,12 @@ </tr> </tbody> </table> - <p>This property controls the speaking rate. The default rate for a voice depends on the - language and dialect and on the personality of the voice. The default rate for a voice should - be such that it is experienced as a normal speaking rate for the voice when reading aloud - text. Since voices are processor-specific, the default rate will be as well.</p> - <p>Values have the following meanings:</p> + <p>The 'voice-rate' property manipulates the speed of generated synthetic speech. The default + rate for a given 'voice-family' is processor-specific, and depends on the language, dialect + and on the "personality" of the voice.</p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>rate</code> attribute of + the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><percentage></strong> @@ -1726,10 +1737,12 @@ </tr> </tbody> </table> - <p>Specifies the average pitch (a frequency) of the speaking voice. The average pitch of a voice - depends on the 'voice-family'. For example, the average pitch for a standard male voice is - around 120Hz, but for a female voice, it's around 210Hz.</p> - <p>Values have the following meanings:</p> + <p>The 'voice-pitch' property specifies the average pitch of generated speech output, and + depends on the 'voice-family'. For example, the default average pitch for a common male voice + is around 120Hz, whereas it is around 210Hz for a female voice.</p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>pitch</code> attribute of + the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><frequency></strong> @@ -1833,12 +1846,13 @@ </tr> </tbody> </table> - <p>Specifies variation in average pitch. Human languages are spoken with varying inflection and - pitch; these variations convey additional meaning and emphasis. Thus, a highly animated voice, - i.e., one that is heavily inflected, displays a high pitch range. This property specifies the - range over which these variations occur, i.e., how much the fundamental frequency may deviate - from the average pitch.</p> - <p>Values have the following meanings:</p> + <p> The 'voice-pitch-range' property specifies the variability in average pitch, i.e. how much + the fundamental frequency may deviate from the average pitch. The dynamic pitch range of the + generated speech output typically increases for a highly animated voice, for example when + variations in inflection are used to convey meaning and emphasis in speech. </p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>range</code> attribute of + the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong><frequency></strong> @@ -1890,13 +1904,13 @@ <td> <em>Value:</em> </td> - <td>auto | strong | moderate | none | reduced | inherit</td> + <td>normal | strong | moderate | none | reduced | inherit</td> </tr> <tr> <td> <em>Initial:</em> </td> - <td>auto</td> + <td>normal</td> </tr> <tr> <td> @@ -1930,13 +1944,15 @@ </tr> </tbody> </table> - <p>Indicates the strength of emphasis to be applied. Emphasis is applied using a combination of - pitch change, timing changes, loudness and other acoustic differences, and is dependent on the - language being spoken. </p> - <p>Values have the following meanings:</p> + <p>The 'voice-stress' property manipulates the strength of emphasis, which is normally applied + using a combination of pitch change, timing changes, loudness and other acoustic differences. + The precise meaning of the values therefore depend on the language being spoken. </p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_emphasis"><code>emphasis</code> + element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> - <strong>auto</strong> + <strong>normal</strong> </dt> <dd>Represents the default emphasis produced by the speech synthesizer.</dd> <dt> @@ -2031,10 +2047,13 @@ </tr> </tbody> </table> - <p> Allows authors to specify how long it should take to render the selected element's content. - Unless the value 'auto' is specified, this property takes precedence over the 'voice-rate' - property and must be used to determine the speaking rate of the voice. </p> - <p>Values have the following meanings:</p> + <p> The 'voice-duration' property specifies how long it should take to render the selected + element's content (excluding <a href="#cue-props">audio cues</a> ). Unless the value 'auto' is + specified, this property takes precedence over the 'voice-rate' property and should be used to + determine the speaking rate of the voice. </p> + <p class="note"> Note that the functionality provided by this property is related to the <a + href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>duration</code> attribute + of the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p> <dl> <dt> <strong>auto</strong> @@ -2616,7 +2635,7 @@ <li>Cleaned-up the list of module dependencies, and removed redundant "module dependencies" section.</li> <li>Improved the pause collapsing prose, removed redundant paragraphs.</li> - <li>Added the "auto" value for 'voice-stress'.</li> + <li>Added the "normal" value for 'voice-stress'.</li> <li>Improved document structure by adding sub-sections.</li> <li>Fixed typos and made other minor edits.</li> </ul> Index: default.css =================================================================== RCS file: /sources/public/csswg/css3-speech/default.css,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- default.css 1 Sep 2010 17:44:06 -0000 1.1 +++ default.css 10 May 2011 23:05:19 -0000 1.2 @@ -33,7 +33,7 @@ body {counter-reset: exampleno figure} -h2, h3, h5, h6 { margin-top: 2em } +/* Pagination */ h1, h2, h3, h4, h5, h6 { page-break-after: avoid; font-family: inherit } div.figure, div.sidefigure, pre, table.propdef, table.propdef-extra, div.example { page-break-inside: avoid } @@ -41,6 +41,14 @@ span.id {float: right; font-weight: bold} +/* General Structural Markup */ +h2, h3, h5, h6 { + margin-top: 2em; +} +h1 + h2 { + margin-top: 0; +} + p, p.testlink + p, p.mtb { text-indent: 0; margin-bottom: 0; @@ -54,10 +62,6 @@ margin-top: 0 } -h1 + h2 { - margin-top: 0; -} - pre { text-align: left; /* fixes justification in Mac IE 5 */ text-indent: 0; /* fixes indent in Mac Netscape 6 */ @@ -106,6 +110,8 @@ ul.indexlist li { margin-left: 0; list-style: none } ul.indexlist li li { margin-left: 1em } +/* Examples */ + .example { counter-increment: exampleno; } @@ -151,6 +157,7 @@ margin: 1em 0; border: thin solid #999; position: relative; + clear: both; } pre.example, pre.illegal-example, pre.html, pre.illegal-html, pre.xml, pre.illegal-xml { @@ -184,19 +191,29 @@ code.xml { color: #600 } /* inline XML */ .property { font: inherit; } /* name of a CSS property (SPAN) */ .descriptor { } /* name of a CSS descriptor (SPAN) */ -.issue { color: #c00 } /* editorial remark, open issue */ .type { font-style: italic } /* A <type> value for a property */ dfn { font-weight: bolder; /*font-size: 1em*/ } +/* Open issue / editorial remark; not intended for a final publication */ + +.issue { color: #c00 } +.issue:before { + content: "Issue:"; + border: 3px double #c00; + background: #c00; + background-clip: padding-box; + color: white; + margin: 0.25em; + padding: 0 0.25em; +} + /* Class note is a non-normative note. May be inline or a P or DIV */ .note { color: green } -/* -p.note:before, span.note:before { content: "\25B6\A0" } -div.note > p:first-child:before { content: "\25B6\A0" } -*/ +p.note:before, span.note:before { content: "\25B6" " " } +div.note > p:first-child:before { content: "\25B6" " " } .normref { color: red } .informref { color: green } @@ -374,6 +391,17 @@ background: #005A9C; color: white } + +/* A footnote at the bottom of a propdef */ +table.propdef td.footnote {padding-top: 0.6em; width: auto} +table.propdef td.footnote:before { + content: " "; + display: block; + height: 0.6em; + width: 4em; + border-top: thin solid +} + /* table.propdef tr:first-child td { padding-top: 0.1em; padding-bottom: 0.1em } */ /* This would replace :first-child for Opera, but it confuses WinIE :-( */
Received on Tuesday, 10 May 2011 23:05:29 UTC