MVH/NAudio-2.2.1/NAudio.Midi/Midi/PatchChangeEvent.cs

using System;
using System.IO;
using System.Text;

namespace NAudio.Midi
{
    /// <summary>
    /// Represents a MIDI patch change event
    /// </summary>
    public class PatchChangeEvent : MidiEvent
    {
        private byte patch;

        /// <summary>
        /// Gets the default MIDI instrument names
        /// </summary>
        public static string GetPatchName(int patchNumber)
        {
            return patchNames[patchNumber];
        }

        // TODO: localize
        private static readonly string[] patchNames = new string[] 
        {
            "Acoustic Grand","Bright Acoustic","Electric Grand","Honky-Tonk","Electric Piano 1","Electric Piano 2","Harpsichord","Clav",
            "Celesta","Glockenspiel","Music Box","Vibraphone","Marimba","Xylophone","Tubular Bells","Dulcimer",
            "Drawbar Organ","Percussive Organ","Rock Organ","Church Organ","Reed Organ","Accoridan","Harmonica","Tango Accordian",
            "Acoustic Guitar(nylon)","Acoustic Guitar(steel)","Electric Guitar(jazz)","Electric Guitar(clean)","Electric Guitar(muted)","Overdriven Guitar","Distortion Guitar","Guitar Harmonics",
            "Acoustic Bass","Electric Bass(finger)","Electric Bass(pick)","Fretless Bass","Slap Bass 1","Slap Bass 2","Synth Bass 1","Synth Bass 2",
            "Violin","Viola","Cello","Contrabass","Tremolo Strings","Pizzicato Strings","Orchestral Strings","Timpani",
            "String Ensemble 1","String Ensemble 2","SynthStrings 1","SynthStrings 2","Choir Aahs","Voice Oohs","Synth Voice","Orchestra Hit",
            "Trumpet","Trombone","Tuba","Muted Trumpet","French Horn","Brass Section","SynthBrass 1","SynthBrass 2",
            "Soprano Sax","Alto Sax","Tenor Sax","Baritone Sax","Oboe","English Horn","Bassoon","Clarinet",
            "Piccolo","Flute","Recorder","Pan Flute","Blown Bottle","Skakuhachi","Whistle","Ocarina",
            "Lead 1 (square)","Lead 2 (sawtooth)","Lead 3 (calliope)","Lead 4 (chiff)","Lead 5 (charang)","Lead 6 (voice)","Lead 7 (fifths)","Lead 8 (bass+lead)",
            "Pad 1 (new age)","Pad 2 (warm)","Pad 3 (polysynth)","Pad 4 (choir)","Pad 5 (bowed)","Pad 6 (metallic)","Pad 7 (halo)","Pad 8 (sweep)",
            "FX 1 (rain)","FX 2 (soundtrack)","FX 3 (crystal)","FX 4 (atmosphere)","FX 5 (brightness)","FX 6 (goblins)","FX 7 (echoes)","FX 8 (sci-fi)",
            "Sitar","Banjo","Shamisen","Koto","Kalimba","Bagpipe","Fiddle","Shanai",
            "Tinkle Bell","Agogo","Steel Drums","Woodblock","Taiko Drum","Melodic Tom","Synth Drum","Reverse Cymbal",
            "Guitar Fret Noise","Breath Noise","Seashore","Bird Tweet","Telephone Ring","Helicopter","Applause","Gunshot" 
        };

        /// <summary>
        /// Reads a new patch change event from a MIDI stream
        /// </summary>
        /// <param name="br">Binary reader for the MIDI stream</param>
        public PatchChangeEvent(BinaryReader br)
        {
            patch = br.ReadByte();
            if ((patch & 0x80) != 0)
            {
                // TODO: might be a follow-on
                throw new FormatException("Invalid patch");
            }
        }

        /// <summary>
        /// Creates a new patch change event
        /// </summary>
        /// <param name="absoluteTime">Time of the event</param>
        /// <param name="channel">Channel number</param>
        /// <param name="patchNumber">Patch number</param>
        public PatchChangeEvent(long absoluteTime, int channel, int patchNumber)
            : base(absoluteTime, channel, MidiCommandCode.PatchChange)
        {
            this.Patch = patchNumber;
        }

        /// <summary>
        /// The Patch Number
        /// </summary>
        public int Patch
        {
            get
            {
                return patch;
            }
            set
            {
                if (value < 0 || value > 127)
                {
                    throw new ArgumentOutOfRangeException("value", "Patch number must be in the range 0-127");
                }
                patch = (byte)value;
            }
        }

        /// <summary>
        /// Describes this patch change event
        /// </summary>
        /// <returns>String describing the patch change event</returns>
        public override string ToString()
        {
            return String.Format("{0} {1}",
                base.ToString(),
                GetPatchName(this.patch));
        }

        /// <summary>
        /// Gets as a short message for sending with the midiOutShortMsg API
        /// </summary>
        /// <returns>short message</returns>
        public override int GetAsShortMessage()
        {
            return base.GetAsShortMessage() + (this.patch << 8);
        }

        /// <summary>
        /// Calls base class export first, then exports the data 
        /// specific to this event
        /// <seealso cref="MidiEvent.Export">MidiEvent.Export</seealso>
        /// </summary>
        public override void Export(ref long absoluteTime, BinaryWriter writer)
        {
            base.Export(ref absoluteTime, writer);
            writer.Write(patch);
        }
    }
}