/// <summary>
/// Extension method to return whether this ShortMessage is a Channel Message or whether it's a System Message
/// </summary>
/// <param name="mess">the ShortMessage</param>
/// <returns>whether this ShortMessage is a Channel Message</returns>
public static bool IsChannelMessage(this ShortMessage mess)
{
int st = mess.GetStatus();
// Check if this is a channel message
// all MidiEventTypes less than SystemExclusive, see MidiHelper.MidiEventType
if ((st & 0xF0) <= 0xF0)
{
return(true);
}
return(false);
}
/// <summary>
/// Extension method to return useful information about the ShortMessage
/// </summary>
/// <param name="mess">the ShortMessage</param>
/// <param name="inFlats">whether to return Note names in flats</param>
/// <returns>and array of 6 elements consisting of Event, Note, Value, Patch, Text and Channel</returns>
public static object[] GetShortStrings(this ShortMessage mess, bool inFlats)
{
// Event, Note, Value, Patch, Text, Channel
object[] result = { "", "", null, "", "", null };
int st = mess.GetStatus();
int d1 = mess.GetData1();
int d2 = mess.GetData2();
// Check if this is a channel message
if (mess.IsChannelMessage())
{
int cmd = mess.GetCommand();
switch (cmd)
{
case (int)MidiHelper.MidiEventType.AfterTouchChannel:
result[0] = "AfterTouchChannel";
result[2] = Convert.ToInt32(d1);
break;
case (int)MidiHelper.MidiEventType.ControlChange:
result[0] = Controllers.GetControlName(d1);
result[2] = Controllers.GetControlValue(d2, false);
break;
case (int)MidiHelper.MidiEventType.NoteOff:
result[0] = "NoteOff";
result[1] = NoteNames.GetNoteName(d1, inFlats);
result[2] = Convert.ToInt32(d2);
break;
case (int)MidiHelper.MidiEventType.NoteOn:
result[0] = "NoteOn ";
result[1] = NoteNames.GetNoteName(d1, inFlats);
result[2] = Convert.ToInt32(d2);
break;
case (int)MidiHelper.MidiEventType.PitchBend:
result[0] = "PitchBend";
// The two bytes of the pitch bend message form a 14 bit number, 0 to 16383.
// The value 8192 (sent, LSB first, as 0x00 0x40), is centered, or "no pitch bend."
// The value 0 (0x00 0x00) means, "bend as low as possible,"
// and, similarly, 16383 (0x7F 0x7F) is to "bend as high as possible."
result[2] = MidiHelper.TwoBytesToInt(d1, d2);
break;
case (int)MidiHelper.MidiEventType.AfterTouchPoly:
result[0] = "AfterTouchPoly";
result[1] = NoteNames.GetNoteName(d1, inFlats);
result[2] = Convert.ToInt32(d2);
break;
case (int)MidiHelper.MidiEventType.ProgramChange:
result[0] = "ProgramChange ";
result[3] = InstrumentNames.GetName(d2, d1);
break;
default:
result[0] = "Unknown";
break;
}
int chan = mess.GetChannel();
result[5] = Convert.ToInt32(chan);
}
// This is a system message
else
{
switch (st)
{
case (int)MidiHelper.MidiEventType.ActiveSensing:
result[0] = "ActiveSensing";
break;
case (int)MidiHelper.MidiEventType.Continue:
result[0] = "Continue";
break;
case (int)MidiHelper.MidiEventType.EndOfExclusive:
result[0] = "EndOfExclusive";
break;
case (int)MidiHelper.MidiEventType.TimeCodeQuarterFrame:
result[0] = "TimeCodeQuarterFrame";
break;
case (int)MidiHelper.MidiEventType.SongPosition:
result[0] = "SongPosition";
// This 14-bit value is the MIDI Beat upon which to start the song.
// Songs are always assumed to start on a MIDI Beat of 0. Each MIDI Beat spans 6 MIDI Clocks.
// In other words, each MIDI Beat is a 16th note (since there are 24 MIDI Clocks in a quarter note).
result[2] = MidiHelper.TwoBytesToInt(d1, d2);
break;
case (int)MidiHelper.MidiEventType.SongSelect:
result[0] = "SongSelect";
result[2] = Convert.ToInt32(d1);
break;
case (int)MidiHelper.MidiEventType.Start:
result[0] = "Start";
break;
case (int)MidiHelper.MidiEventType.Stop:
result[0] = "Stop";
break;
case (int)MidiHelper.MidiEventType.SystemReset:
result[0] = "SystemReset";
break;
case (int)MidiHelper.MidiEventType.Clock:
result[0] = "Clock";
break;
case (int)MidiHelper.MidiEventType.TuneRequest:
result[0] = "TuneRequest";
break;
default:
result[0] = "Undefined";
break;
}
}
return(result);
}
/// <summary>
/// Extension method to generate C# code for this event
/// </summary>
/// <param name="mess">the ShortMessage</param>
/// <param name="inFlats">whether to return Note names in flats</param>
/// <param name="tick">the position of the event in the sequence</param>
/// <returns>a C# code segment as a string</returns>
public static string CreateShortEventGeneratedCode(this ShortMessage mess, bool inFlats, long tick)
{
int cmd = mess.GetCommand();
string typeName = MidiHelper.GetEventTypeString(cmd);
int st = mess.GetStatus();
int d1 = mess.GetData1();
int d2 = mess.GetData2();
int chan = mess.GetChannel();
string val1 = "0";
string val2 = "0";
string comment = "";
// Check if this is a channel message
if (mess.IsChannelMessage())
{
switch (cmd)
{
case (int)MidiHelper.MidiEventType.AfterTouchChannel:
val1 = "" + Convert.ToInt32(d1);
val2 = "0";
break;
case (int)MidiHelper.MidiEventType.ControlChange:
string controlName = Controllers.GetControlName(d1);
val1 = "" + Controllers.GetControllerNumber(controlName);
val2 = "" + Convert.ToInt32(Controllers.GetControlValue(d2, false));
comment = string.Format("// {0}", controlName);
break;
case (int)MidiHelper.MidiEventType.NoteOff:
string noteOff = NoteNames.GetNoteName(d1, inFlats);
val1 = string.Format("NoteNames.GetNoteNumber(\"{0}\")", noteOff);
val2 = "" + Convert.ToInt32(d2);
break;
case (int)MidiHelper.MidiEventType.NoteOn:
string noteOn = NoteNames.GetNoteName(d1, inFlats);
val1 = string.Format("NoteNames.GetNoteNumber(\"{0}\")", noteOn);
val2 = "" + Convert.ToInt32(d2);
break;
case (int)MidiHelper.MidiEventType.PitchBend:
// The two bytes of the pitch bend message form a 14 bit number, 0 to 16383.
// The value 8192 (sent, LSB first, as 0x00 0x40), is centered, or "no pitch bend."
// The value 0 (0x00 0x00) means, "bend as low as possible,"
// and, similarly, 16383 (0x7F 0x7F) is to "bend as high as possible."
val1 = "" + d1;
val2 = "" + d2;
comment = string.Format("// {0} (0 to 16383, 8192 = centered)", MidiHelper.TwoBytesToInt(d1, d2));
break;
case (int)MidiHelper.MidiEventType.AfterTouchPoly:
string noteAfterTouch = NoteNames.GetNoteName(d1, inFlats);
val1 = string.Format("NoteNames.GetNoteNumber(\"{0}\")", noteAfterTouch);
val2 = "" + Convert.ToInt32(d2);
break;
case (int)MidiHelper.MidiEventType.ProgramChange:
string instrumentName = InstrumentNames.GetName(d2, d1);
val1 = "" + InstrumentNames.GetInstrumentNumber(instrumentName);
val2 = "0";
comment = string.Format("// {0}", instrumentName);
break;
default:
break;
}
}
// This is a system message
else
{
switch (st)
{
case (int)MidiHelper.MidiEventType.ActiveSensing:
case (int)MidiHelper.MidiEventType.Continue:
case (int)MidiHelper.MidiEventType.EndOfExclusive:
case (int)MidiHelper.MidiEventType.TimeCodeQuarterFrame:
case (int)MidiHelper.MidiEventType.Start:
case (int)MidiHelper.MidiEventType.Stop:
case (int)MidiHelper.MidiEventType.SystemReset:
case (int)MidiHelper.MidiEventType.Clock:
case (int)MidiHelper.MidiEventType.TuneRequest:
val1 = "0";
val2 = "0";
break;
case (int)MidiHelper.MidiEventType.SongPosition:
// This 14-bit value is the MIDI Beat upon which to start the song.
// Songs are always assumed to start on a MIDI Beat of 0. Each MIDI Beat spans 6 MIDI Clocks.
// In other words, each MIDI Beat is a 16th note (since there are 24 MIDI Clocks in a quarter note).
val1 = "" + d1;
val2 = "" + d2;
comment = string.Format("// {0}", MidiHelper.TwoBytesToInt(d1, d2));
break;
case (int)MidiHelper.MidiEventType.SongSelect:
val1 = "" + Convert.ToInt32(d1);
val2 = "0";
break;
default:
break;
}
}
return(string.Format("ShortEvent.CreateShortEvent((int) MidiHelper.MidiEventType.{0}, {1}, {2}, {3}, {4})); {5}",
typeName, chan, val1, val2, tick, comment));
}