+-------------------------------------------------------+
+	libInstPatch - README				+
+	Copyright (C) 1999-2003 Josh Green		+
+	Email: jgreen@users.sourceforge.net		+
+	libInstPatch site: http://swami.sourceforge.net	+
+-------------------------------------------------------+


=====================================
1. What is libInstPatch?
2. License
3. Requirements
4. Features
5. Future plans
6. Programs using this library
7. Patch file info and links
8. Thanks
9. Trademark Acknowledgement
10. Contact
=====================================

1. What is libInstPatch?
-------------------------------------
libInstPatch stands for lib-Instrument-Patch and is a library for
processing digital sample based MIDI instrument "patch" files.
The types of files libInstPatch supports are used for creating
instrument sounds for wavetable synthesis. libInstPatch provides
an object framework (based on GObject) to load patch files into,
which can then be edited, converted, and saved.


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

This 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.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA or point your web browser to http://www.gnu.org.


3. Requirements
-------------------------------------
Look at the INSTALL file for instructions on compiling and installing
libInstPatch and for more details on software requirements.

libInstPatch has the following requirements:
- Just about anywhere glib/GObject can be found. This includes many
  *nix like operating systems such as Linux, *BSD, and Mac OS X and it
  should also be possible to run on win32 systems.
- glib/gobject 2.x
- libsndfile 1.x (audiofile support in the future)

glib/gobject homepage: http://www.gtk.org
libsndfile homepage: http://www.zip.com.au/~erikd/libsndfile/
audiofile homepage: http://www.68k.org/~michael/audiofile/


4. Features
-------------------------------------
- Supports SoundFont 2, DLS 1/2 and GigaSampler
- Virtually kicks ass
- Lots of bugs


5. Future plans
-------------------------------------
More ass kicking, less virtual


6. Programs using this library
-------------------------------------
Swami 1.0 (currently in heavy development)


7. Patch file info and links
-------------------------------------
I wrote an "Intro to SoundFont files" and its available on the Swami homepage
http://swami.sourceforge.net. Its a general overview of what a SoundFont is.

More information on the SoundFont standard can be obtained from
http://www.soundfont.com. There is a PDF of the SoundFont technical
specification at http://www.soundfont.com/documents/sfspec21.pdf.


8. Thanks
-------------------------------------
- Takashi Iwai for his work on the aweutils package which I gained
  much SoundFont loading example code from when I first started the
  Smurf SoundFont Editor way back when. It was a pleasure meeting you
  at the LinuxTag 2003, I hope to see you again sometime in the near
  future.

- Ruben from the LinuxSampler project for doing much research on the
  GigaSampler format.

- GStreamer for helpful examples of using GObject.

- All the Linux Audio Developers I met on my travels in Germany,
  looking forward to seeing many of you at the LAD 2004 conference!

- It goes without saying that this project would not be possible
  without the thousands of other developers working on free software:
  Linux, ALSA, FluidSynth, Gnome, Gtk, gcc, gdb, valgrind, emacs, Gimp,
  Blender, XMMS, MPlayer, Evolution, Gnumeric, Galeon, Mozilla, X
  Windows, and of course the Free Software Foundation to name just a
  few of the projects that improve my day to day life :)


9. Trademark Acknowledgement
-------------------------------------
SoundFont is a registered trademark of E-mu Systems, Inc.
All other trademarks are property of their respective holders.


10. Contact
-------------------------------------
Feel free to contact me if you have any questions, need help, or would
like to contribute. It always cheers me up to find an email waiting
for me from someone using my software, or trying to :), so don't be shy.

Email: jgreen@users.sourceforge.net
libInstPatch/Swami homepage: http://swami.sourceforge.net

=====================================
