rtmidi/in
src/rtmidi/in.tur
defn
midi-in-open
(midi-in-open [mi :int i :int name :cstr] :ptr<void>)
open a physical MIDI input port by index.
Parameters
| mi | MIDI input handle (ok-val from midi-in-new) | |
| i | port index (0-based, must be < midi-in-port-count) | |
| name | client name to register with the system |
Returns
(ok 0) on success; (err 0) on failure.
Example
(let [r (midi-in-open mi 0 "Turmeric In")]
(if (ok? r) ... (println "open failed")))
Since: RM0
defn
midi-in-open-virtual
(midi-in-open-virtual [mi :int name :cstr] :ptr<void>)
open a virtual MIDI input port.
Parameters
| mi | MIDI input handle (ok-val from midi-in-new) | |
| name | name for the virtual port |
Returns
(ok 0) on success; (err 0) on failure.
Example
(let [r (midi-in-open-virtual mi "My Virtual In")]
(if (ok? r) ... (println "virtual open failed")))
Since: RM0
defn
midi-in-close
(midi-in-close [mi :int] :void)
close the currently open MIDI input port.
Parameters
| mi | MIDI input handle (ok-val from midi-in-new) |
Returns
void
Example
(midi-in-close mi)
Since: RM0
defn
midi-in-set-callback
(midi-in-set-callback [mi :int callback :int] :void)
register a callback to receive incoming MIDI messages.
Parameters
| mi | MIDI input handle (ok-val from midi-in-new) | |
| callback | RtMidiCCallback function pointer as :int |
Returns
void
Example
(midi-in-set-callback mi my-midi-handler)
Since: RM0
defn
midi-in-cancel-callback
(midi-in-cancel-callback [mi :int] :void)
remove the previously registered MIDI input callback.
Parameters
| mi | MIDI input handle (ok-val from midi-in-new) |
Returns
void
Example
(midi-in-cancel-callback mi)
Since: RM0
defn
midi-in-ignore-types
(midi-in-ignore-types [mi :int sysex :bool timing :bool active-sense :bool] :void)
configure which MIDI message types to ignore.
Parameters
| mi | MIDI input handle (ok-val from midi-in-new) | |
| sysex | if true, suppress SysEx messages | |
| timing | if true, suppress MIDI timing clock messages | |
| active-sense | if true, suppress Active Sensing messages |
Returns
void
Example
(midi-in-ignore-types mi true true true)
Since: RM0
Internal definitions
__ok-- create an ok result wrapping integer value v.__err-- create an err result wrapping integer error value e.