Home Banner image
Home

Project MIDI Connections Tutorial

Project MIDI Connections Dialog

Now that Project MIDI is installed, we need to check the connections.

Project MIDI allows you to connect the various events (or inputs) in your setup to any of the possible actions (or outputs) that Project MIDI can perform.

Default Connections

When you install and run Project MIDI for the first time, it creates a set of default connections. You can use the Connections dialog to change these connections or to add new connections.

MIDI Port and Device Connections

Project MIDI is designed to work equally well in setups with only a single MIDI device as well as in setups with multiple MIDI interface ports and multiple MIDI devices. By default, all MIDI devices are connected to all MIDI ports. To configure a setup with multiple ports and devices, you will need to delete the default connection, and create a connection from each port to the device attached to that port.

When Project MIDI starts up, it opens each available MIDI input port and creates an Event for it. You can create a connection to that Event to route data from that port to an associated device or any other assembly that accepts input MIDI data.

Likewise, each output MIDI port has an Action associated with it that can be used to connect output MIDI data to that port.

Image of TaskBar menu

A MIDI device assembly that is capable of both input and output MIDI data should have its MIDI Input Action connected to the MIDI port's Event, and its output MIDI data Event connected to the MIDI port's Action.

Playing with Connections

In order to get a feel for how Connections work, I have created a Sample Assembly that supports several Events and Actions. If you did not choose to install the Sample Assembly, you can go back and do so now by rerunning Setup.exe.

Make sure that the Connections dialog, the Sample dialog, and the SongSet dialogs are all visible. If not, then right-click on the Project MIDI icon in the Task Bar to bring up the icon menu. Selecting any of the names listed in the Assemblies submenu will cause the associated assembly to alternately be displayed or hidden.

Image of Sample Assembly

First let's establish a connection from the SongSet song number to the sample assembly's text box. This way, whenever anything changes the song number, it will be displayed in the Sample Assembly text box.

  1. Right click on the ID column of any connection on the Connection dialog. Select the New Connection menu item. This will create a new connection.
  2. Click on the ID column header to sort the connections list by ID number. Then scroll down to the bottom of the list to display the newly created connection.
  3. Right-click on each of the columns of the new connection and select the SongSet assembly, song number event and the Sample dest assembly Text Box Action.
  4. s

Test the connection by selecting different songs in the Song Set dialog. As each song is selected, it's number should be displayed in the text box.

Now lets connect the TrackBar to the song number.

  1. Right click on the ID column of any connection on the Connection dialog. Select the New Connection menu item. This will create a new connection.
  2. Click on the ID column header to sort the connections list by ID number. Then scroll down to the bottom of the list to display the newly created connection.
  3. Right-click on each of the columns of the new connection and select the SongSet assembly, song number event and the Sample dest assembly Track Bar Action.
  4. Using the same procedure, create another new connection and connect the Sample assembly TrackBar event to the SongSet assembly Song Number Action.

Now the TrackBar is connected as both an Event and an Action to the Song Number.

Menu Connections

Let's create some Sample Assembly context menu entries to select the next or previous songs.

Menu items can be added directly to a menu. Alternatively a submenu can be created, and menu items added to the submenu.

For this example we will create a "Song" submenu, and add items to select the next or previous song.

  1. Create a new connection.
  2. Set the source of this connection the Sample assembly ContextMenu event.
  3. Now make this connection a submenu by right-clicking on the dest assembly and selecting SubMenu.
  4. Right-click on this new submenu connection item, and select "Edit Context Menu". This will allow you to edit the name of this item. Change the name to "Song".
  5. Close the menu editor.
  6. Now create new connections from the Sample assembly Song event. This event is in fact the submenu you just created. Create connections from it to the SongSet assembly Prev Song and Next Song actions.
Image of Sample Context Menu

Now when you right-click on the Sample Assembly dialog, a context menu will be displayed with 2 menu items: Set next song and Set previous song in a "Song" submenu.



Next page