compo Files

 
Installation of compo
---------------------

With MacOS :

1) If you don't own any Common Lisp evaluator/compiler, you can experiment the system at
a macro level by simply running the "compo lite ppc" or the "compo lite" application 
(whether or not your computer is a Power PC). This will provide you with a Common Lisp
environment with compo loaded in, for a session limited to 15 mn (the time limitation is 
not due to compo but to MCL on which the demo version resides).

2) If you own a Common Lisp evaluator such as MCL, follow this steps to install compo in 
it :

  Open the parameters.lisp file at the distribution's root directory;
  
  Adapt the value associated to each parameter to your system :

  . *source-type* and *object-type* should be the extension of respectively a source and
    a compiled file to deal properly with your Lisp implementation (With MCL4.x, just let
    "lisp" and "pfsl", with MCL3.x, replace "pfsl" by "fasl");

  . On a Macintosh, let the *device* parameter to the empty list;

  . The rest of the parameter must correspond to a set of directories where to find the
    compo's sources, and where to place the binary files, depending on where you placed 
    the distribution in your file system;

  Save the parameters.lisp file;

  Eventually change the extension of each source file in the distribution if your Lisp
  implementation doesn't deals with .lisp sources;

  Load the parameters.lisp file;

  Load the make.lisp file from the distribution's root directory. This should compile
  each source file and place the resulting object file in the bin subdirectory; 

  Quit your Lisp environment and restart it to work with a clean heap;

  Load the parameters.lisp file;

  Load the package.lisp file from the distribution's root directory. This loads compo;

  Type in (in-package :compo);

  Create an application by saving an image of your Lisp environment at this time.


With other systems :

3) Compo has only been tested on MacOS yet. But since it's standard Common Lisp, it should 
work on any implementation conforming with the specification.

Follow the procedure 2) above, trying to adapt the parameters value to your system (for
example, "c:" or "d:" should certainly be specified as a value to the *device* parameter).
So that to be not platform dependant, the directories parameters use Common Lisp pathnames 
rather than strings (refers to the specification for more information about pathnames).

Installation of midicompo
-------------------------

midicompo is an extension of compo with midi piano restitution of the generated musical
structures. To install it, you should have Common Music with the :midi syntax, installed 
on your system (refer to http://ccrma-www.stanford.edu/ for more information).

4) Follow this steps to install midicompo :

  Launch your Lisp environment with Common Music and the :midi syntax loaded;

  Verify that the parameters in the parameters.lisp file at the package's root still 
  conform to your system (see the procedure 2) above);

  load the parameters.lisp file;

  load the make.lisp file from the midicompo subdirectory. This should compile
  each midicompo's source file and place the resulting object file in the midicompo/bin 
  subdirectory; 

  Quit your Lisp environment and restart it (always with common music and the :midi syntax) 
  to work with a clean heap;

  Load the parameters.lisp file;

  Load the package.lisp file from the midicompo subdirectory. This loads midicompo;

  Create an application by saving an image of your Lisp environment at this time.