<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="print">
  <refmeta>
    <refentrytitle>print</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>print</refname>
    <refpurpose>
      Displays the values init, control, or audio signals.
      <indexterm id="IndexPrint"><primary>print</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      These units will print orchestra init-values, or produce graphic display of orchestra control signals and audio signals. Uses X11 windows if enabled, else (or if <link linkend="FlagsMinusLowerG"><citetitle>-g</citetitle></link> flag is set) displays are approximated in ASCII characters.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>print</command> iarg [, iarg1] [, iarg2] [...]</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>iarg, iarg2, ... </emphasis> -- i-rate arguments.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>print</emphasis> -- print the current value of the i-time arguments (or expressions) <emphasis>iarg</emphasis> at every i-pass through the instrument.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the print opcode. It uses the files <ulink url="examples/print.orc"><citetitle>print.orc</citetitle></ulink> and <ulink url="examples/print.sco"><citetitle>print.sco</citetitle></ulink>.

      <example>
        <title>Example of the print opcode.</title>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/print.orc" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/print.sco" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>
      </example>

      Its output should include lines like this:
      <screen>
instr 1:  p4 = 50.375
instr 1:  p4 = 300.000
instr 1:  p4 = -999.000
      </screen>
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="dispfft"><citetitle>dispfft</citetitle></link>,
      <link linkend="display"><citetitle>display</citetitle></link>, 
      <link linkend="printk"><citetitle>printk</citetitle></link>,
      <link linkend="printk2"><citetitle>printk2</citetitle></link>,
      <link linkend="printks"><citetitle>printks</citetitle></link> and
      <link linkend="prints"><citetitle>prints</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Example written by &namekevin;.</para>
    <para>Comments about the <emphasis>inprds</emphasis> parameter contributed by &namerasmus;.</para>
  </refsect1>
</refentry>
