matrix-midi-xy

A Pu(rr) Data patch to transform XY blob-tracking to Midi CC channels

🐯 Overview

Extendeding the original Pure Data patch for the eTextile multi-touch matrix sensor this patch both unpacks the blob extracted from the SLIP-OSC connection, and now it interpolates the XY values based on each UID (generally fingers) and outputs them across multiple MIDI CC channels.

🎼 Features

• Unpack blob data.
• XY values for 3 UIDs (default: 0 - 2 )
• 6 MIDI CC Channels (default: 0 - 5)
• Linear interpolation (default: XY[0 - 60] -> MIDI[1 - 127])

🎚️ Instructions

MIDI Bus

We're going to need a virtual MIDI device in order to route the output from Pure Data to a DAW or other software.

The setup varies depending on your operating system. Ableton have a great guide for both Windows and macOS.

https://help.ableton.com/hc/en-us/articles/209774225-How-to-setup-a-virtual-MIDI-bus

Once you've setup a virtual MIDI device, be sure to have it selected whenever you open Pure Data.

Pure Data

1. The patch attempts to establish a connection with the eTextile Matrix using a virtual COM port. object. There are no assumptions made about which port the e256 Matrix is available on, so be sure to adjust open # where "#" is your COM port.

   • 
   • Select devices to view available COM ports.
   • Enter Edit Mode
     • To toggle edit mode, the user can select the function by clicking “Edit” menu and selecting Edit mode.
     • Alternative Command + E (Mac OS X). or Ctrl + E (Win).
     • Update Open object with correct value.

2. You're now ready to trigger the ON/OFF object to establish a connection with the e256 Matrix.

   • 
   • The embedded e256_SLIP-OSC_input sub-patch handles communication with the e256 Matrix via SLIP encoded OSC. There are 3 UI objects to adjust for calibration, on/off and threshold adjustment.

3. The UID 0 1 2 sub-patches should light-up with data whenever the e265 is touched.

   • 
   • You can adjust the range of the XY/MIDI interpolation by entering Edit Mode (described above) and alternating the values for either objects.

4. It's now time to load-up a DAW or any software capable of receiving MIDI and you're away! 🛫☁️

• 

💿 Requirements

Recommended

• Purr Data
  • Jonathan Wilkes’ Purr Data based on Ico Bukvic’s Pd-l2ork, which in turn is a fork of Hans-Christoph Steiner’s Pd-extended.

Optional Alternative

• Pure Data
  • Miller S. Puckette's "vanilla" distribution of Pd is perfect.
• Externals
  • comport, for Virtual COMs
  • mrpeach, for SLIP encoding
  • OSC, for OSC packing