8000 added example of pitch inheritance · xfq/csswg-drafts@1095fa0 · GitHub
Skip to content

Commit 1095fa0

Browse files
danielweckdanielweck
committed
added example of pitch inheritance
1 parent d7c7b34 commit 1095fa0

2 files changed

Lines changed: 77 additions & 14 deletions

File tree

‎css3-speech/Overview.html‎

Lines changed: 43 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2150,7 +2150,8 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
21502150
<tr>
21512151
<td> <em>Computed value:</em>
21522152

2153-
<td>specified value
2153+
<td>an absolute frequency or keyword value, and potentially, a
2154+
frequency, semitone, or percentage representing any non-zero offsets
21542155
</table>
21552156

21562157
<p>The &lsquo;<a href="#voice-pitch"><code
@@ -2163,11 +2164,12 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
21632164
around 120Hz, whereas it is around 210Hz for a female voice.
21642165

21652166
<p> Speech-capable user agents are likely to support a specific range of
2166-
values rather than the full range of possible computed numerical values
2167+
values rather than the full range of possible calculated numerical values
21672168
for frequencies. The actual values in user agents may therefore be clamped
21682169
to implementation-dependent minimum and maximum boundaries. For example:
2169-
although the 0Hz frequency can be legitimately computed, it may be clamped
2170-
to a more meaningful value in the context of the speech synthesizer.
2170+
although the 0Hz frequency can be legitimately calculated, it may be
2171+
clamped to a more meaningful value in the context of the speech
2172+
synthesizer.
21712173

21722174
<p class=note> Note that the functionality provided by this property is
21732175
related to the <a
@@ -2293,7 +2295,8 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
22932295
<tr>
22942296
<td> <em>Computed value:</em>
22952297

2296-
<td>specified value
2298+
<td>an absolute frequency or keyword value, and potentially, a
2299+
frequency, semitone, or percentage representing any non-zero offsets
22972300
</table>
22982301

22992302
<p> The &lsquo;<a href="#voice-range"><code
@@ -2306,11 +2309,12 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
23062309
a flat, monotonic voice, whereas a high range produces an animated voice.
23072310

23082311
<p> Speech-capable user agents are likely to support a specific range of
2309-
values rather than the full range of possible computed numerical values
2312+
values rather than the full range of possible calculated numerical values
23102313
for frequencies. The actual values in user agents may therefore be clamped
23112314
to implementation-dependent minimum and maximum boundaries. For example:
2312-
although the 0Hz frequency can be legitimately computed, it may be clamped
2313-
to a more meaningful value in the context of the speech synthesizer.
2315+
although the 0Hz frequency can be legitimately calculated, it may be
2316+
clamped to a more meaningful value in the context of the speech
2317+
synthesizer.
23142318

23152319
<p class=note> Note that the functionality provided by this property is
23162320
related to the <a
@@ -2375,6 +2379,32 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
23752379
implementation and language-dependent.</p>
23762380
</dl>
23772381

2382+
<div class=example>
2383+
<p>Examples of inherited values:</p>
2384+
2385+
<pre>
2386+
&lt;body&gt;
2387+
&lt;parent&gt;
2388+
&lt;child&gt;
2389+
&lt;grandchild&gt;
2390+
...
2391+
&lt;/grandchild&gt;
2392+
&lt;/child&gt;
2393+
&lt;/parent&gt;
2394+
&lt;/body&gt;
2395+
2396+
body { voice-range: inherit; } /* the initial value is 'medium' */
2397+
parent { voice-range: 200Hz absolute; } /* override with an absolute frequency */
2398+
child { voice-range: 2st; } /* the computed value is [200Hz + two semitones] */
2399+
grandchild { voice-range: inherit;
2400+
voice-family: "another-voice"; } /* the computed value is the same as
2401+
for "child", but the voice is different so the
2402+
calculated (used) absolute frequency
2403+
may be completely different,
2404+
due to voice-dependent discrepancies */
2405+
</pre>
2406+
</div>
2407+
23782408
<table class=propdef summary="name: syntax">
23792409
<tbody>
23802410
<tr>
@@ -3511,6 +3541,11 @@ <h2 class=no-num id=changes>Appendix D &mdash; Changes from previous draft</h2>
35113541
as being a subset of &lsquo;<a href="#voice-pitch"><code
35123542
class=property>voice-pitch</code></a>&rsquo;.
35133543

3544+
<li>Fixed "computed value" for &lsquo;<a href="#voice-pitch"><code
3545+
class=property>voice-pitch</code></a>&rsquo; and &lsquo;<a
3546+
href="#voice-range"><code class=property>voice-range</code></a>&rsquo;
3547+
properties.
3548+
35143549
<li>Removed the "phonemes" property (and its associated "@alphabet"
35153550
at-rule).
35163551

‎css3-speech/Overview.src.html‎

Lines changed: 34 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1703,7 +1703,8 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17031703
<td>
17041704
<em>Computed value:</em>
17051705
</td>
1706-
<td>specified value</td>
1706+
<td>an absolute frequency or keyword value, and potentially, a frequency, semitone, or
1707+
percentage representing any non-zero offsets </td>
17071708
</tr>
17081709
</tbody>
17091710
</table>
@@ -1714,9 +1715,9 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17141715
voice.</p>
17151716

17161717
<p> Speech-capable user agents are likely to support a specific range of values rather than the
1717-
full range of possible computed numerical values for frequencies. The actual values in user
1718+
full range of possible calculated numerical values for frequencies. The actual values in user
17181719
agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
1719-
For example: although the 0Hz frequency can be legitimately computed, it may be clamped to a
1720+
For example: although the 0Hz frequency can be legitimately calculated, it may be clamped to a
17201721
more meaningful value in the context of the speech synthesizer. </p>
17211722

17221723
<p class="note"> Note that the functionality provided by this property is related to the <a
@@ -1837,7 +1838,8 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
18371838
<td>
18381839
<em>Computed value:</em>
18391840
</td>
1840-
<td>specified value</td>
1841+
<td>an absolute frequency or keyword value, and potentially, a frequency, semitone, or
1842+
percentage representing any non-zero offsets </td>
18411843
</tr>
18421844
</tbody>
18431845
</table>
@@ -1848,9 +1850,9 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
18481850
Typically, a low range produces a flat, monotonic voice, whereas a high range produces an
18491851
animated voice. </p>
18501852
<p> Speech-capable user agents are likely to support a specific range of values rather than the
1851-
full range of possible computed numerical values for frequencies. The actual values in user
1853+
full range of possible calculated numerical values for frequencies. The actual values in user
18521854
agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
1853-
For example: although the 0Hz frequency can be legitimately computed, it may be clamped to a
1855+
For example: although the 0Hz frequency can be legitimately calculated, it may be clamped to a
18541856
more meaningful value in the context of the speech synthesizer. </p>
18551857

18561858
<p class="note"> Note that the functionality provided by this property is related to the <a
@@ -1908,6 +1910,31 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
19081910
language-dependent.</p>
19091911
</dd>
19101912
</dl>
1913+
1914+
<div class="example">
1915+
<p>Examples of inherited values:</p>
1916+
<pre>
1917+
&lt;body&gt;
1918+
&lt;parent&gt;
1919+
&lt;child&gt;
1920+
&lt;grandchild&gt;
1921+
...
1922+
&lt;/grandchild&gt;
1923+
&lt;/child&gt;
1924+
&lt;/parent&gt;
1925+
&lt;/body&gt;
1926+
1927+
body { voice-range: inherit; } /* the initial value is 'medium' */
1928+
parent { voice-range: 200Hz absolute; } /* override with an absolute frequency */
1929+
child { voice-range: 2st; } /* the computed value is [200Hz + two semitones] */
1930+
grandchild { voice-range: inherit;
1931+
voice-family: "another-voice"; } /* the computed value is the same as
1932+
for "child", but the voice is different so the
1933+
calculated (used) absolute frequency
1934+
may be completely different,
1935+
due to voice-dependent discrepancies */
1936+
</pre>
1937+
</div>
19111938
<table class="propdef" summary="name: syntax">
19121939
<tbody>
19131940
<tr>
@@ -2478,6 +2505,7 @@ <h2 class="no-num" id="changes">Appendix D &mdash; Changes from previous draft</
24782505
<li>Renamed 'voice-pitch-range' to 'voice-range', which is compatible with SSML's notation,
24792506
and removes the possibility to interpret this property as being a subset of
24802507
'voice-pitch'.</li>
2508+
<li>Fixed "computed value" for 'voice-pitch' and 'voice-range' properties.</li>
24812509
<li>Removed the "phonemes" property (and its associated "@alphabet" at-rule).</li>
24822510
<li>Renamed 'speakability' to 'speak', and 'speak' to 'speak-as'. Reorganized the 'speak-as'
24832511
values to allow mixing different types.</li>

0 commit comments

Comments
 (0)