rtmidi/in
src/rtmidi/in.tur
defn
midi-in-open
(midi-in-open [mi : int i : int name : cstr] :)
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] :)
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] :)
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] :)
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] :)
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] :)
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.