rtmidi/out

src/rtmidi/out.tur

defn

midi-out-open

(midi-out-open [mo :int i :int name :cstr] :ptr<void>)

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 [mo :int name :cstr] :ptr<void>)

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 [mo :int] :void)

close the currently open MIDI output port.

Parameters

MIDI output handle (ok-val from midi-out-new)

Returns

void

Example

(midi-out-close mo)

Since: RM0

defn

(midi-out-send [mo :int bytes :cstr len :int] :ptr<void>)

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.