1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<!-- HTML file produced from file: UserManual.tex --
-- using Hyperlatex v 2.3.1 (c) Otfried Cheong--
-- on Emacs 21.1 (patch 4) "Arches" XEmacs Lucid, Sun Apr 30 20:49:57 2000 -->
<HEAD>
<TITLE>Tao User Manual -- Shell commands</TITLE>
<link rel=stylesheet href="../../taomanual.css" type="text/css">
</HEAD><BODY BACKGROUND="bg.gif">
<table width="500" border="0" align="left" cellspacing="2" cellpadding="2"><tr><td class="nav" valign="top"><!-- top panel --><A HREF="UserManual_42.html"><IMG ALT="Up" ALIGN=BOTTOM BORDER=0 SRC="up.gif"></A>
<BR><A HREF="UserManual_42.html"><B>Tao</B>'s User Interface</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
</td><td class="nav" valign="top"><A HREF="UserManual_42.html"><IMG ALT="Back" ALIGN=BOTTOM BORDER=0 SRC="back.gif"></A>
<BR><A HREF="UserManual_42.html"><B>Tao</B>'s User Interface</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
</td><td class="nav" valign="top"><A HREF="UserManual_44.html"><IMG ALT="Forward" ALIGN=BOTTOM BORDER=0 SRC="forward.gif"></A>
<BR><A HREF="UserManual_44.html">Mouse bindings in the visualisation window</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
</td></tr><!-- end top panel --><tr><td colspan="3" class="main"><!-- main text --><br><br>
<H2>Shell commands</H2>
A number of shell commands<A NAME="1">
are</A> provided for executing scripts and converting
the output files to WAV format. These are described below:
<P><P><DL><DT><B>tao <script></B><DD>
Takes the name of a script as its argument (minus the <CODE>.tao</CODE>
extension) and executes it, producing a file called <CODE><script>.exe</CODE>.
This shell script calls upon the services of the binary executable
<CODE>taoparse</CODE>, which is described below.
<P><DT><B>taoparse <script>.tao</B><DD>
Binary executable which parses a <B>Tao</B> script, translates it into a
valid C++ program, and writes the results to standard output. This is
called by the <CODE>tao</CODE> shell script.
<P><DT><B>taosf <outputfile></B><DD>
Takes the name of a file produced by an Output device, minus the
<CODE>.dat</CODE> extension and normalises the audio samples, adding
a WAV header and writing the results to a file called <CODE><outputfile>.wav</CODE>.
This command actually calls the <CODE>tao2wav</CODE> binary executable with
the arguments <CODE>tao2wav <outputfile>.dat <outputfile>.wav</CODE>.
<P><DT><B>tao2wav <outputfile>.dat <outputfile>.wav</B><DD>
Binary executable used to convert a file produced by an Output device
(in raw floating point format) into a WAV file.
</DL>
<P>In addition to these commands, whenever a script is invoked with the
<CODE>tao</CODE> command a corresponding <CODE>.exe</CODE> file is produced. This
is the actual executable which carries out the synthesis described in
the script. For example the command <CODE>tao <file></CODE> invokes the script
<CODE><file>.tao</CODE> and as a by-product produces the executable file
<CODE><file>.exe</CODE>. Each <CODE>.exe</CODE> file has one command line option,
<CODE>[-g]</CODE>. This option causes the instrument visualisation window
to be opened. If omitted the synthesis proceeds without any visualisations.
<P>If you want to replay a synthesis described in a script you can invoke
this executable file directly rather than having to re-compile the original
text file containing the script.
<P>
<BR></td></tr><!-- end main text --><tr><td class="nav" align="left" valign="top"><!-- bottom matter --><A HREF="UserManual_42.html"><IMG ALT="Up" ALIGN=BOTTOM BORDER=0 SRC="up.gif"></A>
<BR><A HREF="UserManual_42.html"><B>Tao</B>'s User Interface</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
</td><td class="nav" align="left" valign="top"><A HREF="UserManual_42.html"><IMG ALT="Back" ALIGN=BOTTOM BORDER=0 SRC="back.gif"></A>
<BR><A HREF="UserManual_42.html"><B>Tao</B>'s User Interface</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
</td><td class="nav" align="left" valign="top"><!-- bottom matter --><A HREF="UserManual_44.html"><IMG ALT="Forward" ALIGN=BOTTOM BORDER=0 SRC="forward.gif"></A>
<BR><A HREF="UserManual_44.html">Mouse bindings in the visualisation window</A>
<IMG width="167" height="1" SRC="trans1x1.gif">
</td></tr><!-- end bottom matter -->
<tr><td colspan="3" class="addr"><!-- bottom panel --><ADDRESS><FONT SIZE=-1>©1999,2000 Mark Pearson
<A HREF="mailto:m.pearson@ukonline.co.uk">m.pearson@ukonline.co.uk</A> April 30, 2000</ADDRESS><BR></td></tr><!-- end bottom panel --></table></BODY></HTML>
|