<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="sndinfo">
  <refmeta>
    <refentrytitle>sndinfo</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>sndinfo</refname>
    <refpurpose>
      Displays information about a soundfile.
      <indexterm id="IndexSndinfo"><primary>sndinfo</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Get basic information about one or more soundfiles.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>csound -U sndinfo</command> soundfilenames ...</synopsis>

    <synopsis><command>sndinfo</command> soundfilenames ...</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>sndinfo</emphasis> will attempt to find each named file, open it for reading, read in the soundfile header, then print a report on the basic information it finds. The order of search across soundfile directories is as described above. If the file is of type AIFF, some further details are listed first.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Examples</title>
    <para>
      <informalexample>
        <programlisting>
<emphasis>csound -U sndinfo</emphasis> test Bosendorfer/&quot;BOSEN mf A0 st&quot; foo foo2
        </programlisting>
      </informalexample>

      where the environment variables SFDIR = /u/bv/sound, and SSDIR = /so/bv/Samples, might produce the following:

      <informalexample>
        <programlisting>
util  SNDINFO:      
     /u/bv/sound/test:
           srate 22050, monaural, 16 bit shorts, 1.10 seconds
           headersiz 1024, datasiz 48500  (24250 sample frames)
  
    /so/bv/Samples/Bosendorfer/BOSEN mf A0 st:  AIFF, 197586 stereo samples, base Frq 261.6 (MIDI 60), sustnLp: mode 1, 121642 to 197454, relesLp: mode 0
     AIFF soundfile, looping with modes 1, 0
     srate 44100, stereo, 16 bit shorts, 4.48 seconds
  
     headersiz  402, datasiz 790344  (197586 sample frames)
  
     /u/bv/sound/foo:
           no recognizable soundfile header
  
     /u/bv/sound/foo2:
            couldn't find
        </programlisting>
      </informalexample>
    </para>
  </refsect1>
</refentry>
