<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="v">
  <refmeta>
    <refentrytitle>v Statement</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>v</refname>
    <refpurpose>
      Provides for locally variable time warping of score events.
      <indexterm id="IndexVStatement"><primary>v statement</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      The <emphasis>v statement</emphasis> provides for locally variable time warping of score events.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>v</command> p1</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <command>p1</command> -- Time warp factor (must be positive).
    </para>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      The <emphasis>v statement</emphasis> takes effect with the following <link linkend="i"><citetitle>i statement</citetitle></link>, and remains in effect until the next <link linkend="v"><citetitle>v statement</citetitle></link>, <link linkend="s"><citetitle>s statement</citetitle></link>, or <link linkend="e"><citetitle>e statement</citetitle></link>.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Examples</title>
    <para>
      The value of p1 is used as a multiplier for the start times (p2) of subsequent <link linkend="i"><citetitle>i statements</citetitle></link>.
    </para>

    <para>
      <informalexample>
        <programlisting>
<emphasis>i</emphasis>1   0 1  ;note1
<emphasis>v</emphasis>2
<emphasis>i</emphasis>1   1 1  ;note2
        </programlisting>
      </informalexample>

      In this example, the second note occurs two beats after the first note, and is twice as long.
    </para>

    <para>
      Although the <emphasis>v statement</emphasis> is similar to the <link linkend="t"><citetitle>t statement</citetitle></link>, the <emphasis>v statement</emphasis> is local in operation. That is, <emphasis>v</emphasis> affects only the following notes, and its effect may be cancelled or changed by another <emphasis>v statement</emphasis>.
    </para>

    <para>
      Carried values are unaffected by the <emphasis>v statement</emphasis> (see <link linkend="ScoreCarry"><citetitle>Carry</citetitle></link>).
    </para>

    <para>
      <informalexample>
        <programlisting>
<emphasis>i</emphasis>1   0 1  ;note1
<emphasis>v</emphasis>2
<emphasis>i</emphasis>1   1 .  ;note2
<emphasis>i</emphasis>1   2 .  ;note3
<emphasis>v</emphasis>1
<emphasis>i</emphasis>1   3 .  ;note4
<emphasis>i</emphasis>1   4 .  ;note5
<emphasis>e</emphasis>
        </programlisting>
      </informalexample>
    </para>

    <para>
      In this example, note2 and note4 occur simultaneously, while note3 actually occurs before note2, that is, at its original place. Durations are unaffected.
    </para>

    <para>
      <informalexample>
        <programlisting>
<emphasis>i</emphasis>1   0 1
<emphasis>v</emphasis>2
<emphasis>i</emphasis>.   + .
<emphasis>i</emphasis>.   . .
        </programlisting>
      </informalexample>

      In this example, the <emphasis>v statement</emphasis> has no effect.
    </para>
  </refsect1>
</refentry>
