MIDI WIP

Author: victor-shepardson

examples/iipyper/iipyper-tutorial.py

@@ -1,5 +1,8 @@
 from iipyper import OSC, MIDI, repeat, run
 
+# TODO: MIDI
+# TODO: loops are broken, why?
+
 def main(osc_host='127.0.0.1', osc_port=9999, loop_time=1, loop_msg='hello'):
     # loop API:
     # use the @repeat decorator to define functions which run every n seconds
@@ -11,25 +14,22 @@ def _():
     def _():
         print('looping every 1.5 sec')
 
-    # midi = MIDI()
+    midi = MIDI()
     # # MIDI API:
     # # midi.note_on, midi.cc, etc
 
-    # # use as a decorator to make a midi handler
-    # @midi.handle.note_on
-    # def _(pitch, velocity, channel):
-    #     print(pitch, velocity, channel)
-
-    # # above is kind of an abuse of python syntax, could do this instead:
-    # # (which would allow filtering on port, even note)
-    # @midi.handle.note_on(pitch=range(1,128), channel=0, port='')
-    # def _(pitch, velocity, channel):
-    #     print(pitch, velocity, channel)
+    # # decorator to make a midi handler:
+    # # here filtering for pitch > 0, channel = 0
+    @midi.handle.note_on(pitches=range(1,128), channels=0)
+    def _(pitch, velocity, channel):
+        print(pitch, velocity, channel)
 
-    # use as a function to send MIDI
+    # function to send MIDI:
+    midi.note_on(pitch=60, velocity=100, channel=0)
+    midi.cc(control=0, value=127, channel=1)
 
     # @repeat(1)
-    # def step():
+    # def _():
     #     midi.note_on(pitch=60, velocity=100, channel=0)
     #     midi.cc(number=0, value=127, channel=1)
 

iipyper/iipyper/__init__.py

@@ -39,6 +39,7 @@ async def _run_async():
     # for osc in OSC.instances:
     #     osc.close_server()
 
-def run(main):
-    fire.Fire(main)
+def run(main=None):
+    if main is not None:
+        fire.Fire(main)
     asyncio.run(_run_async())

iipyper/iipyper/midi.py

@@ -12,7 +12,11 @@ def _get_filter(item):
 class MIDI:
     """"""
     def __init__(self, in_ports=None, out_ports=None, verbose=True):
-        """"""
+        """
+        Args:
+            in_ports: list of input devices (uses all by default)
+            out_ports: list of output devices (uses all by default)
+        """
         self.verbose = verbose
         # type -> list[Optional[set[port], Optional[set[channel]], function]
         self.handlers = defaultdict(list)
@@ -39,6 +43,11 @@ def __init__(self, in_ports=None, out_ports=None, verbose=True):
 
         self.handle = MIDIHandlers(self)
 
+    # TODO: filtering needs to work for all message types...
+    # maybe there should be just one decorator
+    # which can accept any filter, including on type?
+    # and which just takes a mido message?
+
     def get_midi_callback(self):
         """callback for mido MIDI handling"""
         # close over `self``
@@ -82,22 +91,54 @@ def decorator(f):
 
         return decorator if f is None else decorator(f)
 
-    # TODO: MIDI send
-    def note_on(self, pitch, velocity=64, channel=0):
-        pass
+    # send on all ports by default
+    def _send(self, port, *a, **kw):
+        ports = self.out_ports.values() if port is None else [self.out_ports[port]]
+        for p in ports:
+            p.send(mido.Message(*a, **kw))
+
+    # see https://mido.readthedocs.io/en/latest/message_types.html
+
+    def note_on(self, note, velocity=64, channel=0, port=None):
+        self._send(port, 'note_on', channel=channel, note=note, velocity=velocity)
+
+    def note_off(self, note, velocity=64, channel=0, port=None):
+        self._send(port, 'note_off', channel=channel, note=note, velocity=velocity)
+
+    def control_change(self, control, value, channel=0, port=None):
+        self._send(port, 'control_change', channel=channel, control=control, value=value)
+
+    def cc(self, *a, **kw):
+        self.control_change(*a, **kw)
+
+    def program_change(self, program, channel=0, port=None):
+        self._send(port, 'program_change', channel=channel, program=program)
+
+    def polytouch(self, note, value=64, channel=0, port=None):
+        self._send(port, 'polytouch', channel=channel, note=note, value=value)
+
+    def aftertouch(self, value=64, channel=0, port=None):
+        self._send(port, 'aftertouch', channel=channel, value=value)
+
+    def pitchwheel(self, pitch=0, port=None):
+        self._send(port, 'pitchwheel', pitch=pitch)
+
+    def pitchbend(self, *a, **kw):
+        self.pitchwheel(*a, **kw)
+
 
-# this is effectively part of MIDI, 
+# this is effectively part of MIDI class, 
 # it is only a separate class for naming aesthetics
 class MIDIHandlers:
     """specific MIDI handler decorators"""
     def __init__(self, midi):
         self.midi = midi
 
-    def note_on(self, ports=None, channels=None, pitches=None, velocities=None):
-        return self.midi._decorator('note_on', ports, channels, pitches, velocities)
+    def note_on(self, ports=None, channels=None, notes=None, velocities=None):
+        return self.midi._decorator('note_on', ports, channels, notes, velocities)
 
-    def note_off(self, ports=None, channels=None, pitches=None, velocities=None):
-        return self.midi._decorator('note_off', ports, channels, pitches, velocities)
+    def note_off(self, ports=None, channels=None, notes=None, velocities=None):
+        return self.midi._decorator('note_off', ports, channels, notes, velocities)
 
     def control_change(self, ports=None, channels=None, controls=None, values=None):
         return self.midi._decorator('control_change', ports, channels, controls, values)