- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 Jul 2011 21:59:26 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech In directory hutz:/tmp/cvs-serv23143 Modified Files: Overview.html Overview.src.html Log Message: updated computed value definition, and inheritance example Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-speech/Overview.html,v retrieving revision 1.78 retrieving revision 1.79 diff -u -d -r1.78 -r1.79 --- Overview.html 13 Jul 2011 21:24:49 -0000 1.78 +++ Overview.html 13 Jul 2011 21:59:24 -0000 1.79 @@ -2150,8 +2150,9 @@ <tr> <td> <em>Computed value:</em> - <td>an absolute frequency or keyword value, and potentially, a - frequency, semitone, or percentage representing any non-zero offsets + <td>an absolute frequency, or a keyword value and potentially also a + frequency, semitone, and/or percentage representing any non-zero + offsets </table> <p>The ‘<a href="#voice-pitch"><code @@ -2176,10 +2177,10 @@ <p> A value in <a href="#frequency-def">frequency</a> units (Hertz or kiloHertz, e.g. "100Hz", "+2kHz"). Values are restricted to positive numbers when the ‘<code class=property>absolute</code>’ - keyword is used. Otherwise (when the ‘<code - class=property>absolute</code>’ keyword is not used), a negative - value represents an decrement, and a positive value represents an - increment (relative to the inherited value). For example, "2kHz" is a + keyword is specified. Otherwise (when the ‘<code + class=property>absolute</code>’ keyword is not specified), a + negative value represents a decrement, and a positive value represents + an increment, relative to the inherited value. For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute").</p> @@ -2291,8 +2292,9 @@ <tr> <td> <em>Computed value:</em> - <td>an absolute frequency or keyword value, and potentially, a - frequency, semitone, or percentage representing any non-zero offsets + <td>an absolute frequency, or a keyword value and potentially also a + frequency, semitone, and/or percentage representing any non-zero + offsets </table> <p> The ‘<a href="#voice-range"><code @@ -2317,10 +2319,10 @@ <p> A value in <a href="#frequency-def">frequency</a> units (Hertz or kiloHertz, e.g. "100Hz", "+2kHz"). Values are restricted to positive numbers when the ‘<code class=property>absolute</code>’ - keyword is used. Otherwise (when the ‘<code - class=property>absolute</code>’ keyword is not used), a negative - value represents an decrement, and a positive value represents an - increment (relative to the inherited value). For example, "2kHz" is a + keyword is specified. Otherwise (when the ‘<code + class=property>absolute</code>’ keyword is not specified), a + negative value represents a decrement, and a positive value represents + an increment, relative to the inherited value. For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute").</p> @@ -2340,8 +2342,7 @@ (semitones). A semitone is half of a tone (a half step) on the standard diatonic scale. As such, a semitone doesn't correspond to a fixed frequency: the ratio between two consecutive frequencies separated by - exactly one semitone is the twelfth root of two (approximately 1.05946). - </p> + exactly one semitone is the twelfth root of two (approximately 1.05946).</p> <dt> <strong><percentage></strong> @@ -2350,17 +2351,17 @@ are allowed, to represent an increment or decrement (respectively) relative to the inherited value. Computed values are calculated by adding (or subtracting) the specified fraction of the inherited value, - to (from) the inherited frequency value. For example, 50% (which is - equivalent to +50%) with a inherited value of 200Hz results in <code>200 - + (200*0.5)</code> = 300Hz. Conversely, -50% results in + to (from) the inherited value. For example, 50% (which is equivalent to + +50%) with a inherited value of 200Hz results in <code>200 + + (200*0.5)</code> = 300Hz. Conversely, -50% results in <code>200-(200*0.5)</code> = 100Hz.</p> <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>, - <strong>high</strong> and <strong>x-high</strong> + <strong>high</strong>, <strong>x-high</strong> <dd> - <p>A sequence of monotonically non-decreasing pitch ranges that are - implementation and language-dependent.</p> + <p>A sequence of monotonically non-decreasing pitch levels that are + implementation and voice specific.</p> </dl> <p> Computed absolute frequency values that are negative are clamped to @@ -2377,24 +2378,52 @@ <pre> <body> - <parent> - <child> - <grandchild> - ... - </grandchild> - </child> - </parent> -</body> - -body { voice-range: inherit; } /* the initial value is 'medium' */ -parent { voice-range: 200Hz absolute; } /* override with an absolute frequency */ -child { voice-range: 2st; } /* the computed value is [200Hz + two semitones] */ -grandchild { voice-range: inherit; - voice-family: "another-voice"; } /* the computed value is the same as - for "child", but the voice is different so the - calculated (used) absolute frequency - may be completely different, + <e1> + <e2> + <e3> + <e4> + <e5> + ... + </e5> + </e4> + </e3> + </e2> + </e1> +</body> + + + + +body { voice-range: inherit; } /* the initial value is 'medium' + (the actual frequency value + depends on the active voice) */ + +e1 { voice-range: +25%; } /* the computed value is + ['medium' + 0.25 times the frequency + corresponding to 'medium'] */ + +e2 { voice-range: inherit; /* this could be omitted, + but we explicitly specify it for clarity purposes */ + + voice-family: "another-voice"; } /* the computed value is the same as + for "e1", but here the voice is different, + so once calculated, the used absolute frequency + may be completely different due to voice-dependent discrepancies */ + +e3 { voice-range: 200Hz absolute; } /* override with an absolute frequency + which doesn't depend on the active voice */ + +e4 { voice-range: 2st; } /* the computed value is an absolute frequency, + which is the result of the + calculation: 200Hz + two semitones */ + +e5 { voice-range: inherit; /* this could be omitted, + but we explicitly specify it for clarity purposes */ + + voice-family: "yet-another-voice"; } /* the computed value is the same as + for "e4" (i.e. an absolute frequency value, + independent from the active voice) */ </pre> </div> Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v retrieving revision 1.79 retrieving revision 1.80 diff -u -d -r1.79 -r1.80 --- Overview.src.html 13 Jul 2011 21:24:49 -0000 1.79 +++ Overview.src.html 13 Jul 2011 21:59:24 -0000 1.80 @@ -1703,8 +1703,8 @@ <td> <em>Computed value:</em> </td> - <td>an absolute frequency or keyword value, and potentially, a frequency, semitone, or - percentage representing any non-zero offsets </td> + <td>an absolute frequency, or a keyword value and potentially also a frequency, semitone, + and/or percentage representing any non-zero offsets </td> </tr> </tbody> </table> @@ -1724,10 +1724,11 @@ <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 when the 'absolute' keyword - is used. Otherwise (when the 'absolute' keyword is not used), a negative value represents - an decrement, and a positive value represents an increment (relative to the inherited - value). For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and - "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute"). </p> + is specified. Otherwise (when the 'absolute' keyword is not specified), a negative value + represents a decrement, and a positive value represents an increment, relative to the + inherited value. For example, "2kHz" is a positive offset (strictly equivalent to + "+2kHz"), and "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz + absolute"). </p> </dd> <dt> <strong>absolute</strong> @@ -1837,8 +1838,8 @@ <td> <em>Computed value:</em> </td> - <td>an absolute frequency or keyword value, and potentially, a frequency, semitone, or - percentage representing any non-zero offsets </td> + <td>an absolute frequency, or a keyword value and potentially also a frequency, semitone, + and/or percentage representing any non-zero offsets </td> </tr> </tbody> </table> @@ -1852,6 +1853,7 @@ <p class="note"> Note that the functionality provided by this property is related to the <a href="http://www.w3.org/TR/speech-synthesis11/#edef_prosody"><code>range</code> attribute of the <code>prosody</code> element</a> from the SSML markup language [[!SSML]]. </p> + <dl> <dt> <strong><frequency></strong> @@ -1859,17 +1861,18 @@ <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 when the 'absolute' keyword - is used. Otherwise (when the 'absolute' keyword is not used), a negative value represents - an decrement, and a positive value represents an increment (relative to the inherited - value). For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and - "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute"). </p> + is specified. Otherwise (when the 'absolute' keyword is not specified), a negative value + represents a decrement, and a positive value represents an increment, relative to the + inherited value. For example, "2kHz" is a positive offset (strictly equivalent to + "+2kHz"), and "+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz + absolute"). </p> </dd> <dt> <strong>absolute</strong> </dt> <dd> <p> If specified, this keyword indicates that the specified frequency represents an absolute - value. If a negative frequency is specified, the computed frequency will be zero.</p> + value. If a negative frequency is specified, the computed frequency will be zero. </p> </dd> <dt> <strong><semitones></strong> @@ -1880,7 +1883,7 @@ "st" (semitones). A semitone is half of a tone (a half step) on the standard diatonic scale. As such, a semitone doesn't correspond to a fixed frequency: the ratio between two consecutive frequencies separated by exactly one semitone is the twelfth root of two - (approximately 1.05946). </p> + (approximately 1.05946).</p> </dd> <dt> <strong><percentage></strong> @@ -1889,16 +1892,15 @@ <p> Positive and negative <a href="#percentage-def">percentage</a> values are allowed, to represent an increment or decrement (respectively) relative to the inherited value. Computed values are calculated by adding (or subtracting) the specified fraction of the - inherited value, to (from) the inherited frequency value. For example, 50% (which is - equivalent to +50%) with a inherited value of 200Hz results in <code>200 + - (200*0.5)</code> = 300Hz. Conversely, -50% results in <code>200-(200*0.5)</code> = - 100Hz. </p> + inherited value, to (from) the inherited value. For example, 50% (which is equivalent to + +50%) with a inherited value of 200Hz results in <code>200 + (200*0.5)</code> = 300Hz. + Conversely, -50% results in <code>200-(200*0.5)</code> = 100Hz. </p> </dd> <dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>, - <strong>high</strong> and <strong>x-high</strong></dt> + <strong>high</strong>, <strong>x-high</strong></dt> <dd> - <p>A sequence of monotonically non-decreasing pitch ranges that are implementation and - language-dependent.</p> + <p>A sequence of monotonically non-decreasing pitch levels that are implementation and voice + specific.</p> </dd> </dl> @@ -1913,24 +1915,52 @@ <p>Examples of inherited values:</p> <pre> <body> - <parent> - <child> - <grandchild> - ... - </grandchild> - </child> - </parent> -</body> - -body { voice-range: inherit; } /* the initial value is 'medium' */ -parent { voice-range: 200Hz absolute; } /* override with an absolute frequency */ -child { voice-range: 2st; } /* the computed value is [200Hz + two semitones] */ -grandchild { voice-range: inherit; - voice-family: "another-voice"; } /* the computed value is the same as - for "child", but the voice is different so the - calculated (used) absolute frequency - may be completely different, + <e1> + <e2> + <e3> + <e4> + <e5> + ... + </e5> + </e4> + </e3> + </e2> + </e1> +</body> + + + + +body { voice-range: inherit; } /* the initial value is 'medium' + (the actual frequency value + depends on the active voice) */ + +e1 { voice-range: +25%; } /* the computed value is + ['medium' + 0.25 times the frequency + corresponding to 'medium'] */ + +e2 { voice-range: inherit; /* this could be omitted, + but we explicitly specify it for clarity purposes */ + + voice-family: "another-voice"; } /* the computed value is the same as + for "e1", but here the voice is different, + so once calculated, the used absolute frequency + may be completely different due to voice-dependent discrepancies */ + +e3 { voice-range: 200Hz absolute; } /* override with an absolute frequency + which doesn't depend on the active voice */ + +e4 { voice-range: 2st; } /* the computed value is an absolute frequency, + which is the result of the + calculation: 200Hz + two semitones */ + +e5 { voice-range: inherit; /* this could be omitted, + but we explicitly specify it for clarity purposes */ + + voice-family: "yet-another-voice"; } /* the computed value is the same as + for "e4" (i.e. an absolute frequency value, + independent from the active voice) */ </pre> </div> <table class="propdef" summary="name: syntax">
Received on Wednesday, 13 July 2011 21:59:27 UTC