<sect1 id='na-play-manual'>
	<title><command>na_play</command><emphasis> Audio Playback</emphasis></title>

    <toc depth='1'></toc>
    <para>
    </para>
    <sect2>
      <title>Synopsis</title>
      <para>
      </para>
        <!-- /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/na_play -sgml_synopsis -->
        <para>
<cmdsynopsis><command>na_play</command>[input file0] [input file1] ...<arg>-h </arg>
<arg>-itype <replaceable>string</replaceable></arg>
<arg>-n <replaceable>int</replaceable></arg>
<arg>-f <replaceable>int</replaceable></arg>
<arg>-ibo <replaceable>string</replaceable></arg>
<arg>-iswap </arg>
<arg>-istype <replaceable>string</replaceable></arg>
<arg>-c <replaceable>string</replaceable></arg>
<arg>-start <replaceable>float</replaceable></arg>
<arg>-end <replaceable>float</replaceable></arg>
<arg>-from <replaceable>int</replaceable></arg>
<arg>-to <replaceable>int</replaceable></arg>
<arg>-p <replaceable>string</replaceable></arg>
<arg>-command <replaceable>string</replaceable></arg>
<arg>-basic </arg>
<arg>-r* </arg>
<arg>-quality <replaceable>string</replaceable></arg>
<arg>-server <replaceable>string</replaceable></arg>
<arg>-audiodevice <replaceable>string</replaceable></arg>
<arg>-scale <replaceable>float</replaceable></arg>
<arg>-v </arg>
<arg>-wait </arg>
</cmdsynopsis>
        </para>
        <!-- DONE /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/na_play -sgml_synopsis -->
      <para>

na_play is a general playback program for playing sound files on a variety
of platforms and sound cards.
Currently, the following audio devices are supported:
<itemizedlist mark='@bullet'>
<listitem><para>sunaudio:</para><para>
8k ulaw direct to <filename>/dev/audio</filename> found on most Sun machines.  This
is also found under Linux and FreeBSD, and possibly others.  This
is the default if <function>netaudio</function> is not supported.
<listitem><para>netaudio:</para><para>
NCD's network transparent audio system (NAS).  This allows
use of audio devices across a network.  NAS has support for, Suns,
Linux, FreeBSD, HPs and probably other machines by now.
<listitem><para>sun16audio:</para><para>
This is only available on newer Sun workstations and has been
enabled at compile time.  This provides 
16bit linear PCM at various sample rates.
<listitem><para>linux16audio:</para><para>
This is only available on Linux workstations and has been enabled
at compile time.  This provides 
16bit linear PCM at various sample rates.
<listitem><para>freebsd16audio:</para><para>
This is only available on workstations running FreeBSD and has
been enabled at compile time.  This provides 
16bit linear PCM at various sample rates.
<listitem><para>mplayeraudio:</para><para>
This is only available under Windows NT 4.0 and Windows 95 and
has been enabled at compile time.  This provides 
16bit linear PCM at various sample rates.
<listitem><para>win32audio</para><para>
This is only available under Windows NT 4.0 and Windows 95 and
has been enabled at compile time.  This provides 
16bit linear PCM at various sample rates, playing the audio directly
rather than saving to a file as with mplayeraudio.
<listitem><para>irixaudio</para><para>
Audio support for SGI's IRIX 6.2.
<listitem><para>Audio_Command:</para><para>
Allows the specification of an arbitrary UNIX command to play
the waveform.  This won't normally be used with <function>na_play</function> as
you could just use the command directly but is necessary with some
systems using the speech tools.
</itemizedlist>
</para>
<para>
The default audio is netaudio if it is supported.  If not the platform
specific auido mode is the default (e.g. sun16audio, linux16audio,
freebsd16audio or mplayeraudio).  If none of these is supported,
sunaudio is the default. 
      </para>
    </sect2>
    <sect2>
      <title>OPTIONS</title>
      <para>
      </para>
        <!-- /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/na_play -sgml_options -->
        <para>
<variablelist>
<varlistentry><term>-h</term>
<LISTITEM><PARA>

options help 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-itype</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

Input file type (optional). If set to raw, this 
indicates that the input file does not have a header. While 
this can be used to specify file types other than raw, this is 
rarely used for other purposes 
as the file type of all the existing supported 
types can be determined automatically from the 
file's header. If the input file is unheadered, 
files are assumed to be shorts (16bit). 
Supported types are 
nist, est, esps, snd, riff, aiff, audlab, raw, ascii 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-n</term>
<LISTITEM><PARA>
<replaceable>int</replaceable>

Number of channels in an unheadered input file 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-f</term>
<LISTITEM><PARA>
<replaceable>int</replaceable>

Sample rate in Hertz for an unheadered input file 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-ibo</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

Input byte order in an unheadered input file: 
possibliities are: MSB , LSB, native or nonnative. 
Suns, HP, SGI Mips, M68000 are MSB (big endian) 
Intel, Alpha, DEC Mips, Vax are LSB (little 
endian) 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-iswap</term>
<LISTITEM><PARA>

Swap bytes. (For use on an unheadered input file) 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-istype</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

Sample type in an unheadered input file: 
short, mulaw, byte, ascii 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-c</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

Select a single channel (starts from 0). 
Waveforms can have multiple channels. This option 
extracts a single channel for progcessing and 
discards the rest. 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-start</term>
<LISTITEM><PARA>
<replaceable>float</replaceable>

Extract sub-wave starting at this time, specified in 
seconds 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-end</term>
<LISTITEM><PARA>
<replaceable>float</replaceable>

Extract sub-wave ending at this time, specified in 
seconds 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-from</term>
<LISTITEM><PARA>
<replaceable>int</replaceable>

Extract sub-wave starting at this sample point 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-to</term>
<LISTITEM><PARA>
<replaceable>int</replaceable>

Extract sub-wave ending at this sample point 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-p</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

audio device protocol. Ths supported types are 
sunaudio audio_command linux16audio 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-command</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

command to play wave when protocol 
is audio_command 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-basic</term>
<LISTITEM><PARA>

HTML audio/basic format, if unheadered treat 
as ulaw 8K 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-r*</term>
<LISTITEM><PARA>

ESPS compatible way of selecting subrange of file. 
The options -start, -end, -to and -from are 
recommended 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-quality</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

either [ high | low ] . "high" will ensure 
that proper resampling is used. "low" means play 
as fast as possible, with a minimum of processing 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-server</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

play sound on machine (when protocol is 
server-based) 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-audiodevice</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

use specified audiodevice if approrpriate 
for protocol 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-scale</term>
<LISTITEM><PARA>
<replaceable>float</replaceable>

change the gain (volume) of the signal. 1.0 is default 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-v</term>
<LISTITEM><PARA>

verbose. Print file names when playing 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-wait</term>
<LISTITEM><PARA>

wait for a key to be pressed between each file </PARA></LISTITEM>
</varlistentry>
</variablelist>
        </para>
        <!-- DONE /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/na_play -sgml_options -->
    </sect2>
  </sect1>