MIDI Interface for Processing Project

/**
 * MIDI Mapping Template for Processing
 *
 * Description:
 * This program demonstrates interaction with MIDI devices using the Processing environment and the MidiBus library.
 * It allows users to select a MIDI device, receive various types of MIDI messages, 
 * and map these messages to specific actions.
 *
 * Usage:
 * 1. List available MIDI devices using the console output.
 * 2. Select your MIDI device by entering its name in the setup function.
 * 3. Customize the mappings in the respective MIDI message functions.
 * 4. Run the sketch and interact with your MIDI device to see messages and actions in the console and on the screen.
 *
 * Date: 2024-06-15
 * 
 * Note:
 * - Ensure the MidiBus library is installed and imported correctly.
 * - Replace the placeholder device name with the actual MIDI device name.
 */

import themidibus.*; // Import the MidiBus library

MidiBus myBus; // Declare a MidiBus object

// Variables to store the last MIDI message data
int lastPitch = -1; 
int lastVelocity = -1;
int lastControllerNumber = -1;
int lastControllerValue = -1;

void setup() {
  size(400, 400); // Set the size of the window
  MidiBus.list(); // List all available MIDI devices to the console
  
  // Replace "YOUR_MIDI_DEVICE_NAME" with the name of your MIDI device
  myBus = new MidiBus(this, "YOUR_MIDI_DEVICE_NAME", "YOUR_MIDI_DEVICE_NAME"); 
}

void draw() {
  background(0); // Set the background color to black
  
  // Display last received MIDI message
  fill(255); // Set the text color to white
  textSize(14); // Set a consistent text size
  text("MIDI MAPPING TEMPLATE", 20, 50);
  text("Last Note Played - Pitch: " + lastPitch + " Velocity: " + lastVelocity, 20, 80);
  text("Last Control Change - Number: " + lastControllerNumber + " Value: " + lastControllerValue, 20, 110);
}

/*
 * This function is called when a Note On message is received.
 * Parameters:
 * - channel: The MIDI channel (1-16)
 * - pitch: The note pitch (0-127)
 * - velocity: The note velocity (0-127)
 */
void noteOn(int channel, int pitch, int velocity) {
  println("Note On received:");
  println("Channel: " + channel);
  println("Pitch: " + pitch);
  println("Velocity: " + velocity);
  
  // Store the pitch and velocity to use in the draw function
  lastPitch = pitch;
  lastVelocity = velocity;
  
  // Example action: change background color based on pitch
  background(map(pitch, 0, 127, 0, 255), 100, 150);
}

/*
 * This function is called when a Note Off message is received.
 * Parameters:
 * - channel: The MIDI channel (1-16)
 * - pitch: The note pitch (0-127)
 * - velocity: The note velocity (0-127)
 */
void noteOff(int channel, int pitch, int velocity) {
  println("Note Off received:");
  println("Channel: " + channel);
  println("Pitch: " + pitch);
  println("Velocity: " + velocity);
  
  // Reset the pitch and velocity
  lastPitch = -1;
  lastVelocity = -1;
}

/*
 * This function is called when a Control Change message is received.
 * Parameters:
 * - channel: The MIDI channel (1-16)
 * - number: The controller number (0-127)
 * - value: The controller value (0-127)
 */
void controllerChange(int channel, int number, int value) {
  println("Control Change received:");
  println("Channel: " + channel);
  println("Number: " + number);
  println("Value: " + value);
  
  // Store the controller number and value to use in the draw function
  lastControllerNumber = number;
  lastControllerValue = value;
  
  // Example action: you can add other actions here based on the controller value
}

/*
 * This function is called when a Program Change message is received.
 * Parameters:
 * - channel: The MIDI channel (1-16)
 * - number: The program number (0-127)
 */
void programChange(int channel, int number) {
  println("Program Change received:");
  println("Channel: " + channel);
  println("Program Number: " + number);
  
  // Example action: print program change to console
}

/*
 * This function is called when a Pitch Bend message is received.
 * Parameters:
 * - channel: The MIDI channel (1-16)
 * - value: The pitch bend value (0-16383)
 */
void pitchBend(int channel, int value) {
  println("Pitch Bend received:");
  println("Channel: " + channel);
  println("Value: " + value);
  
  // Example action: change background color intensity based on pitch bend value
  background(map(value, 0, 16383, 0, 255)); 
}

/*
 * This function is called when a Polyphonic Key Pressure (Aftertouch) message is received.
 * Parameters:
 * - channel: The MIDI channel (1-16)
 * - pitch: The note pitch (0-127)
 * - pressure: The pressure value (0-127)
 */
void polyPressure(int channel, int pitch, int pressure) {
  println("Poly Pressure received:");
  println("Channel: " + channel);
  println("Pitch: " + pitch);
  println("Pressure: " + pressure);
}

/*
 * This function is called when a Channel Pressure (Aftertouch) message is received.
 * Parameters:
 * - channel: The MIDI channel (1-16)
 * - pressure: The pressure value (0-127)
 */
void channelPressure(int channel, int pressure) {
  println("Channel Pressure received:");
  println("Channel: " + channel);
  println("Pressure: " + pressure);
}