@@ -1721,37 +1721,40 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17211721 </ dt >
17221722 < dd >
17231723 < p > A value in < a href ="#frequency-def "> frequency</ a > units (Hertz or kiloHertz, e.g.
1724- "100Hz", "+2kHz"). Values are restricted to positive numbers ( unless the 'relative'
1725- keyword is used), and using negative numbers results in the property value being ignored.
1726- </ p >
1724+ "100Hz", "+2kHz"). Values are restricted to positive numbers, unless the 'relative'
1725+ keyword is used. Computed frequency values that are negative numbers result in the
1726+ property being ignored. </ p >
17271727 </ dd >
17281728 < dt >
17291729 < strong > relative</ strong >
17301730 </ dt >
17311731 < dd >
17321732 < p > This keyword specifies that the provided frequency value is expressed relatively to the
1733- inherited value, with positive or negative numbers. For example, "+ 2kHz relative" is an
1734- increment, unlike "+2kHz" which is a positive absolute value. </ p >
1733+ inherited value, with positive or negative numbers. For example, "2kHz relative" is an
1734+ increment, unlike "+2kHz" which is an absolute value. </ p >
17351735 </ dd >
17361736 < dt >
17371737 < strong > <semitones></ strong >
17381738 </ dt >
17391739 < dd >
1740- < p > Specifies a relative change (decrement or increment) to the inherited value. The syntax
1741- of allowed values is a << a href ="#number-def "> number</ a > > followed immediately by
1742- "st" (semitones). A semitone is half of a tone (a half step) on the standard diatonic
1743- scale. As such, a semitone doesn't correspond to a fixed frequency: the ratio between two
1744- consecutive frequencies separated by exactly one semitone is the twelfth root of two
1745- (approximately 1.05946). </ p >
1740+ < p > Specifies a relative change (decrement or increment) to the inherited frequency value.
1741+ The syntax of allowed values is a << a href ="#number-def "> number</ a > > followed
1742+ immediately by "st" (semitones). A semitone is half of a tone (a half step) on the
1743+ standard diatonic scale. As such, a semitone doesn't correspond to a fixed frequency: the
1744+ ratio between two consecutive frequencies separated by exactly one semitone is the twelfth
1745+ root of two (approximately 1.05946). </ p >
17461746 </ dd >
17471747 < dt >
17481748 < strong > <percentage></ strong >
17491749 </ dt >
17501750 < dd >
1751- < p > Only non-negative < a href ="#percentage-def "> percentage</ a > values are allowed. Computed
1752- values are calculated relative to the inherited value. For example, 50% means that the
1753- inherited value gets multiplied by 0.5, which results in half the inherited pitch of the
1754- voice. </ p >
1751+ < p > Positive and negative < a href ="#percentage-def "> percentage</ a > values are allowed, to
1752+ represent an increment or decrement (respectively) relative to the inherited frequency
1753+ value. Computed values are calculated by adding (or subtracting) the specified fraction of
1754+ the inherited frequency value, to (from) the inherited frequency value. For example, 50%
1755+ (which is equivalent to +50%) with a inherited value of 200Hz results in < code > 200 +
1756+ (200*0.5)</ code > = 300Hz. Conversely, -50% results in < code > 200-(200*0.5)</ code > =
1757+ 100Hz. </ p >
17551758 </ dd >
17561759 < dt > < strong > x-low</ strong > , < strong > low</ strong > , < strong > medium</ strong > ,
17571760 < strong > high</ strong > , < strong > x-high</ strong > </ dt >
@@ -1841,9 +1844,9 @@ <h3 id="voice-props-voice-pitch-range">The 'voice-pitch-range' property</h3>
18411844 </ dt >
18421845 < dd >
18431846 < p > A value in < a href ="#frequency-def "> frequency</ a > units (Hertz or kiloHertz, e.g.
1844- "100Hz", "+2kHz"). Values are restricted to positive numbers ( unless the 'relative'
1845- keyword is used), and using negative numbers results in the property value being ignored.
1846- </ p >
1847+ "100Hz", "+2kHz"). Values are restricted to positive numbers, unless the 'relative'
1848+ keyword is used. Computed frequency values that are negative numbers result in the
1849+ property being ignored. </ p >
18471850 </ dd >
18481851 < dt >
18491852 < strong > relative</ strong >
@@ -1857,21 +1860,24 @@ <h3 id="voice-props-voice-pitch-range">The 'voice-pitch-range' property</h3>
18571860 < strong > <semitones></ strong >
18581861 </ dt >
18591862 < dd >
1860- < p > Specifies a relative change (decrement or increment) to the inherited value. The syntax
1861- of allowed values is a << a href ="#number-def "> number</ a > > followed immediately by
1862- "st" (semitones). A semitone is half of a tone (a half step) on the standard diatonic
1863- scale. As such, a semitone doesn't correspond to a fixed frequency: the ratio between two
1864- consecutive frequencies separated by exactly one semitone is the twelfth root of two
1865- (approximately 1.05946).</ p >
1863+ < p > Specifies a relative change (decrement or increment) to the inherited frequency value.
1864+ The syntax of allowed values is a << a href ="#number-def "> number</ a > > followed
1865+ immediately by "st" (semitones). A semitone is half of a tone (a half step) on the
1866+ standard diatonic scale. As such, a semitone doesn't correspond to a fixed frequency: the
1867+ ratio between two consecutive frequencies separated by exactly one semitone is the twelfth
1868+ root of two (approximately 1.05946).</ p >
18661869 </ dd >
18671870 < dt >
18681871 < strong > <percentage></ strong >
18691872 </ dt >
18701873 < dd >
1871- < p > Only non-negative < a href ="#percentage-def "> percentage</ a > values are allowed. Computed
1872- values are calculated relative to the inherited value. For example, 50% means that the
1873- inherited value gets multiplied by 0.5, which results in half the inherited pitch range of
1874- the voice. </ p >
1874+ < p > Positive and negative < a href ="#percentage-def "> percentage</ a > values are allowed, to
1875+ represent an increment or decrement (respectively) relative to the inherited frequency
1876+ value. Computed values are calculated by adding (or subtracting) the specified fraction of
1877+ the inherited frequency value, to (from) the inherited frequency value. For example, 50%
1878+ (which is equivalent to +50%) with a inherited value of 200Hz results in < code > 200 +
1879+ (200*0.5)</ code > = 300Hz. Conversely, -50% results in < code > 200-(200*0.5)</ code > =
1880+ 100Hz. </ p >
18751881 </ dd >
18761882 < dt > < strong > x-low</ strong > , < strong > low</ strong > , < strong > medium</ strong > ,
18771883 < strong > high</ strong > and < strong > x-high</ strong > </ dt >
@@ -2461,6 +2467,12 @@ <h2 class="no-num" id="changes">Appendix D — Changes from previous draft</
24612467 < li > Added an "auto" value to 'voice-duration', which is the [initial] property value as
24622468 well.</ li >
24632469 < li > Handling of 'voice-balance' values outside of the allowed range (clamping).</ li >
2470+ < li > Fixed 'voice-balance' prose to better explain the relationship between author intent
2471+ (stereo sound distribution) and actual user sound system setup (mono, stereo, or surround
2472+ speaker layout / mixing capabilities).</ li >
2473+ < li > Added prose for 'voice-balance' to describe the mapping between stereo left-right sound
2474+ axis and three-dimensional sound stage (azimuth support in future versions of
2475+ CSS-Speech).</ li >
24642476 < li > Added the 'normal' value for voice-rate ("default" in SSML 1.1).</ li >
24652477 < li > Renamed voice-family fields to be consistent with SSML.</ li >
24662478 < li > Improved the 'voice-family' selection algorithm to cater for language changes.</ li >
0 commit comments