<html>
<head>
<title>compo : Readme</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link href="doc/home.css" rel="styleSheet" type="text/css">
</head>
<body bgcolor="FFFFFF">
<p align="center"><img src="doc/img/logo.gif" width="96" height="48"></p>
<p align="center"><font size="+2">Compo 3.0 - Any platform distribution</font></p>
<p align="center">© 2002 Bruno Lartillot</p>
<table width="100%" border="0" bgcolor="FFFF99" cellspacing="0">
<tr>
<td><img src="doc/img/pixel.gif" width="1" height="1"></td>
</tr>
</table>
<p>To install and use compo 3 <i> </i> you need :</p>
<ul>
<li> A Common Lisp environment. Right now, compo 3 has been tested on <a href="http://www.digitool.com">MCL</a>
and <a href="http://clisp.sourceforge.net">CLisp-2.27</a>;</li>
<li><a href="http://www.cs.wisc.edu/%7Eghost/doc/AFPL/get650.htm">Ghostscript
and Ghostview</a> for score visualization and impression.</li>
</ul>
<p>Note that we provide for the macintosh and the Windows environments ready-to-use
binary releases (with a session time limitation of 15 minutes in the case of
MCL on the Macintosh). This document explains how to install compo with clisp.</p>
<p><b><font size="+1"> Installation</font></b></p>
<p>1) If this is not already done, install clisp, Ghostscript and Ghostview;</p>
<p>2) Decompress <font face="Courier New, Courier, mono">compo-3.0.tar.gz</font>;
</p>
<p>3) Check the file <font face="Courier New, Courier, mono">compo-3.0/cminit.lisp</font>.
In the instruction:</p>
<p><font face="Courier New, Courier, mono">(setf midiplayer "...")</font></p>
<p>You should replace the ... by the absolute path of a valid midiplayer on your
system. For example <font face="Courier New, Courier, mono">/usr/bin/playmidi</font>
if you work on Linux or <font face="Courier New, Courier, mono">C:/Program Files/Windows
Media Player/mplayer2.exe</font> if you work on windows.</p>
<p>4) Launch a Common Lisp session;</p>
<p>5) Load the file <font face="Courier New, Courier, mono">compo-3.0/cm-232/src/compo-cm.lisp</font>;</p>
<p>6) After some automatic loading and compilations, you should be asked to launch
clisp again, and reload the file <font face="Courier New, Courier, mono">compo-cm.lisp</font>.
Do it.</p>
<p>7) A Lisp image should automatically be generated in the folder <font face="Courier New, Courier, mono">compo-3.0/</font>.
In a terminal console, set the directory <font face="Courier New, Courier, mono">compo-3.0/</font>
to be the active directory and launch:</p>
<blockquote>
<p> <font face="Courier New, Courier, mono">clisp -M compo30.mem</font></p>
</blockquote>
<p><b><font size="+1">Verification</font></b></p>
<p>1) By entering the command : <font face="Courier New, Courier, mono">(realize
(midi ()))</font>, you should either ear a C4, or get the file <font face="Courier New, Courier, mono">compo-3.0/compo.midi</font>
which produces a C4 when played. If this is not the case, please <a href="mailto:brunolartillot@users.sourceforge.net">contact
us</a>.</p>
<p>2) By entering the command : <font face="Courier New, Courier, mono">(realize
(score ()))</font>, you should get the file <font face="Courier New, Courier, mono">compo-3.0/cmn-1.eps</font>
which displays a one-staff score containing a quarter on C4, when opened with
Ghostview. If this is not the case, please <a href="mailto:brunolartillot@users.sourceforge.net">contact
us</a>.</p>
<p>Compo is ready to work. We just suggest you to take a look at the <a href="doc/quickstart.html">tutorial</a> first, and at the <a href="doc/reference.html">doc</a>.</p>
<p>Some samples are provided in the folder <font face="Courier New, Courier, mono">compo-3.0/samples/</font>.
Each produce a score and a midi file. Try to load them.</p>
<p>It could be a good idea to take a look at these files...</p>
<p> We thank you of using compo and hope it will be usefull.</p>
</body>
</html>