rtmidi/out
src/rtmidi/out.tur
defn
midi-out-open
(midi-out-open [mo : int i : int name : cstr] :)
open a physical MIDI output port by index.
Parameters
| mo | MIDI output handle (ok-val from midi-out-new) | |
| i | port index (0-based, must be < midi-out-port-count) | |
| name | client name to register with the system |
Returns
(ok 0) on success; (err 0) on failure.
Example
(let [r (midi-out-open mo 0 "Turmeric Out")]
(if (ok? r) ... (println "open failed")))
Since: RM0
defn
midi-out-open-virtual
(midi-out-open-virtual [mo : int name : cstr] :)
open a virtual MIDI output port.
Parameters
| mo | MIDI output handle (ok-val from midi-out-new) | |
| name | name for the virtual port |
Returns
(ok 0) on success; (err 0) on failure.
Example
(let [r (midi-out-open-virtual mo "My Virtual Out")]
(if (ok? r) ... (println "virtual open failed")))
Since: RM0
defn
midi-out-close
(midi-out-close [mo : int] :)
close the currently open MIDI output port.
Parameters
| mo | MIDI output handle (ok-val from midi-out-new) |
Returns
void
Example
(midi-out-close mo)
Since: RM0
defn
midi-out-send
(midi-out-send [mo : int bytes : cstr len : int] :)
send a raw MIDI message buffer on the output port.
Parameters
| mo | MIDI output handle (ok-val from midi-out-new) | |
| bytes | pointer to raw MIDI bytes as :cstr (e.g. msg-bytes from rtmidi/msg) | |
| len | number of bytes to send (e.g. msg-len from rtmidi/msg) |
Returns
(ok 0) on success; (err 0) on failure.
Example
(let [m (msg-note-on 0 60 127)]
(midi-out-send mo (msg-bytes m) (msg-len m))
(msg-free m))
Since: RM0
Internal definitions
__ok-- create an ok result wrapping integer value v.__err-- create an err result wrapping integer error value e.