WELCOME TO THE MIDI KIT!

(C)1997-2000 McNabb Software Arts
San Francisco, CA
http://www.mcnabb.com
info@mcnabb.com

Author: Michael McNabb, michael@mcnabb.com
__________________________________________________________________________

LICENSE

This library and program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public License
(com.msa.midi.server.*) and the GNU Library General Public License
(everything else) as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This library and program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

see the included files gpl.html and lgpl.html

You are encouraged to suggest or implement improvements, additions, or
fixes to the code.  Please send such changes back to michael@mcnabb.com
for inclusion in the standard code base, so that others may benefit.
Thanks!

_____________________________________________________

REQUIREMENTS

The MIDI Kit (Windows 2000/XP or OS X only)

    Download from ftp://ftp.mcnabb.com/midikit-29.tar.gz
              or: ftp://ftp.mcnabb.com/midikit-29.zip

J2SE 1.4 or later:
    
    Windows: Download from http://java.sun.com/j2se/downloads.html


__________________________________________________________________________
INSTALLATION

If you are also installing Fantasia, install the MIDI Kit and Fantasia 
parallel in the directory tree, e.g., xx/fantasia/fantasia-17 and 
xx/midikit/midikit-29.  Otherwise the MIDI Kit can be installed anywhere.

For Windows, the expected Java directory is c:\java \jdk1.4. 
If you use different location, you may need to
edit the fantasia.win and midiserver.win files (see SETUP below).

__________________________________________________________________________

SETUP (IMPORTANT)

There are native executable files which may be used to launch
the server, called "midiserver.sh" (OS X) and "midiserver.exe" (Windows). These
launchers read configuration files called "midiserver.unix" or
"midiserver.win" . You may need to edit these files to set the
locations of your local distribution of the JRE and the MIDI Kit.

You may also need to edit the configuration files for Fantasia if you are
also installing that.  Please see the Fantasia Readme file
for further instructions.

Under IRIX, the midiserver should be run as root in order to run at a high priority,
if you execute it not using the provided executable, note that native threads (-native)
should be specified.

Native Code library

This software requires an native code shared library or dll (included)
which interfaces to the midi library. FOr IRIX, it is not guaranteed to work in
other than IRIX 6.5

__________________________________________________________________________

EXECUTION

The examples directory contains several example stand-alone applications
(which do not use the server) and a few simple clients.  To run the
clients, the MIDI Kit server (com.msa.midikit.server.MIDIServerApp) must be
running.

__________________________________________________________________________

EXTENDING

The source files for all of the classes in com/msa/midikit/processors may 
be used as examples or starting points for building your own MIDIProcessors.
See doc/MIDIKit.html for further information.

__________________________________________________________________________

DOCUMENTATION

See doc/MIDIKit.html for further information. Also, JavaDoc documentation files 
for the MIDI Kit API is included.  If you have further questions, contact 
me at michael@mcnabb.com

Please also see the documentation for Fantasia, Fantasia.html.



- Mike McNabb





Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries