This project is read-only.


There is a beta version available for download under Branches\midiversion to use Mercury in combination with the MIDI.
Using MIDI, you are able to control (bind) every parameter of your Mercury particle engine to a MIDI Note or MIDI Control Change (CC).

This page describes the steps to get you up and running.

Basic setup.

  1. Download the latest version from subversion.
  2. Build the Branches\midiversion particle engine.
  3. Before starting, attach a midi device to your computer and power it on.
  4. Start Mercury using the freshly compiled Effecteditor user interface.

If everything went ok, you should have an midi configuration panel as shown in:

midi_ui1.png midi_ui2.png

Select the MIDI input event

  1. Press the add button to add a MIDI binding to the list.
  2. Press the edit source button to configure the MIDI input event.
  3. If your midi drivers were installed properly, you should see your input devices listed in the top left corner. You can troubleshoot your midi driver installation using MIDIOX if you cannot see any devices.
  4. by rotating a knob or pressing a note, the corresponding midi event is shown in the list.
  5. Select an event from the list and press the ok button to select the midi event as source input event.


Select a mercury parameter.

  1. Press the edit target button to select a mercury target parameter.
  2. Go to Tab 2. A tree of selectable parameters is shown in a tree-view.
  3. Select a parameter from the tree view. Make sure you select a numeric parameter. Valid options are integers, floats, ... and also boolean values.


Configure the conversion between the MIDI signal and the Mercury parameter.

You now see in the list that a MDI CC 16 (value) is mapped to the TriggerOffset.X parameter.
  • MIDI values are values between 0 and 127
  • TriggerOffset.X can range between i.e. -100 and 100.
  • To map these ranges, change the range values via the edit conversion configuration panel.


Checking the result.

  1. Click with your mouse in the middle of the black canvas.
  2. Rotate the midi knob. You will now see the particle emitter move.
  3. Save your patch: Exporting the particle effect will also save the midi mapping.

Additional remarks.

  1. Note On has 2 mappable parameters!
    1. Note pressed is a boolean value, converted to a numeric value. Off is 0 en On is 1.
    2. Velocity is a parameter between 0 and 127. (the harder you hit a note, the higher the velocity)


Last edited Nov 7, 2011 at 9:31 PM by Redlen, version 16