v2.0.3

Documentation update: A remark on the use of subnote dynamics.

src/mpm.odd

@@ -361,7 +361,7 @@
                         </dynamicsMap>
                     </egXML>
 
-                    <tei:p>Each continuous dynamics transition should be followed by another dynamics instruction (continuous or constant) as it provides the end date of the transition. Otherwise the transition would stretch to infinity. The second dynamics instruction sets the optional attribute <tei:att>subNoteDynamics</tei:att> true (default value is false) which expresses that the dynamics transition is performed not only in a note-wise fashion but also within each tone. This feature may not be applicable to, e.g., struck instruments such as piano and harp. Other instruments, however, have the possibility to modulate the dynamics of a held tone, such as the human voice, wind and string instruments.</tei:p> 
+                    <tei:p>Each continuous dynamics transition should be followed by another dynamics instruction (continuous or constant) as it provides the end date of the transition. Otherwise the transition would stretch to infinity. The second dynamics instruction sets the optional attribute <tei:att>subNoteDynamics</tei:att> true (default value is false) which expresses that the dynamics transition is performed not only in a note-wise fashion but also within each tone. This feature may not be applicable to, e.g., struck instruments such as piano and harp. Other instruments, however, are able to modulate the dynamics of a held tone, such as the human voice, wind and bowed string instruments. Switching from non-subnote dynamics to subnote dynamics or vice versa should be done at the beginning of a note or during a rest, not within a note, to avoid artifacts.</tei:p> 
 
                     <tei:p>The shape of continuous dynamics transitions can be further refined by attributes <tei:att>curvature</tei:att> and <tei:att>protraction</tei:att>. Attribute <tei:att>curvature</tei:att> is defined in the interval [0.0, 1.0] and indicates a distinct sigmoidal (S) shape of the dynamics curve (value &gt; 0.0) or a straight linear transition (value = 0.0). The higher the value the more accentuated is the transition. Attribute <tei:att>protraction</tei:att> is defined in the interval [-1.0, 1.0] and indicates whether the transition comes relatively early (value &lt; 0.0), relatively late (value &gt; 0.0) or is equally shared between first and second half of the interval between <tei:gi>date</tei:gi> and the subsequent dynamics instruction's<tei:gi>date</tei:gi>. The mathematical model to construct dynamics curves translates these attributes into cubic Bézier curves as shown in the following figures.</tei:p>