/***************************************************************************/
/*                                                                         */
/* (c) Copyright IBM Corp. 2001  All rights reserved.                      */
/*                                                                         */
/* This sample program is owned by International Business Machines         */
/* Corporation or one of its subsidiaries ("IBM") and is copyrighted       */
/* and licensed, not sold.                                                 */
/*                                                                         */
/* You may copy, modify, and distribute this sample program in any         */
/* form without payment to IBM, for any purpose including developing,      */
/* using, marketing or distributing programs that include or are           */
/* derivative works of the sample program.                                 */
/*                                                                         */
/* The sample program is provided to you on an "AS IS" basis, without      */
/* warranty of any kind.  IBM HEREBY  EXPRESSLY DISCLAIMS ALL WARRANTIES,  */
/* EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED   */
/* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.     */
/* Some jurisdictions do not allow for the exclusion or limitation of      */
/* implied warranties, so the above limitations or exclusions may not      */
/* apply to you.  IBM shall not be liable for any damages you suffer as    */
/* a result of using, modifying or distributing the sample program or      */
/* its derivatives.                                                        */
/*                                                                         */
/* Each copy of any portion of this sample program or any derivative       */
/* work,  must include the above copyright notice and disclaimer of        */
/* warranty.                                                               */
/*                                                                         */
/***************************************************************************/

/***************************************************************************/
/*                                                                         */
/* This file accompanies the article "Understanding and using Java MIDI    */
/* audio." This article was published in the Special Edition 2001 issue    */
/* of the IBM DeveloperToolbox Technical Magazine at                       */
/* http://www.developer.ibm.com/devcon/mag.htm.                            */
/*                                                                         */
/***************************************************************************/

This README file describes the example program files.

When you unpacked the archive file, you see the following files:

  JavaMidi.html - An ASCII text file containing the HTML for the article.
   
  MidiArch.gif - A GIF image file containing the MIDI architecture diagram.

  MidiPlay/MidiPlay.java - Java source code for the first example program
      that plays MIDI or RMF files from the command line.
  
  MidiPlay/MidiPlay.class - The Java code that may be run using
      "java MidiPlay <midi file name>" for example "java MidiPlay quick.midi".

  InstrumentTest/BankInfo.java - Java source code for the example program
      that inspects and lists the instruments in a MIDI sound bank.

  InstrumentTest/BankInfo.class - The Java code that may be run using
      "java BankInfo <sound bank name>" where sound bank name is a MIDI
      sound bank on your system. Use the MIDI sound bank that came
      with your Java run time, usually soundbank.gm under jre/lib/audio,
      for instance "java BankInfo c:/java13/jre/lib/audio/soundbank.gm".

  InstrumentTest/InstrumentTest - Java source code for the example program
      that plays a sample music tune on a range of MIDI instruments.

  InstrumentTest/BankInfo.class - The Java code that may be run
      "java InstrumentTest <begin instrument> <end instrument>" for instance
      "java InstrumentTest 0 10".

  SequenceInfo/SequenceInfo.java - Java source code for the example program 
      that reports the sequence info in a MIDI file.

  SequenceInfo/SequenceInfo.class - The Java code that may be run using
      "java SequenceInfo <midi file name>" for instance "java MidiPlay 
      quick.midi".

  SequenceInfo/MessageInfo.java - Java source code for the class that
      converts MIDI messages into strings. This class is not runnable but
      is used by SequenceInfo.java.

  SequenceInfo/MessageInfo.class - The Java code for the class that
      converts MIDI messages into strings. This class is not runnable but
      is used by SequenceInfo.class.

In general, compile Java source code with the Java Development Kit compiler.
For instance, say the following to compile a file.

   "javac BankInfo.java"

You should see a new class file output from the compile process.
.