<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="seed">
  <refmeta>
    <refentrytitle>seed</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>seed</refname>

    <refpurpose>
      Sets the global seed value.
      <indexterm id="IndexSeed"><primary>seed</primary></indexterm>
    </refpurpose> 
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Sets the global seed value for all <emphasis>x-class noise generators</emphasis>, as well as other opcodes that use a random call, such as <emphasis>grain</emphasis>. <emphasis>rand</emphasis>, <emphasis>randi</emphasis>, <emphasis>randh</emphasis>, <emphasis>rnd</emphasis>(x), and <emphasis>birnd</emphasis>(x) are not affected by seed.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>seed</command> ival</synopsis>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      Use of <emphasis>seed</emphasis> will provide predictable results from an orchestra using with random generators, when required from multiple performances.
    </para>

    <para>
      When specifying a seed value, <emphasis>ival</emphasis> should be an integer between 0 and 2<superscript>32</superscript>. If <emphasis>ival</emphasis> = 0, the value of <emphasis>ival</emphasis> will be derived from the system clock.
    </para>
  </refsect1>
</refentry>
