/***************************************************************************/
/* */
/* (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.