Jazz-Soft.net

We make it sound!

Home » Documentation » JZZ.js » MIDI-Thru

MIDI-Thru

All MIDI nodes, including Widgets, MIDI-In and MIDI-Out share the same API.

They can stand on either side of the connect() and disconnect() functions, and/or receive MIDI messages via the send() and various helpers.

NOTE: Nodes connected after the MIDI-Out port, will most likely receive nothing, since, by default, MIDI-Out will consume the messages sent to it;

Messages sent to the MIDI-In port will appear unchanged on its other end.

However, this default behavior can be changed by redefining the object's _receive() function.

Creating MIDI nodes

JZZ.Widget(arg) - create a new MIDI node (widget).

Works with or without the new keyword.

If arg is a not empty object, its properties will be copied to the new node.

Possible properties:

Example

var logger = JZZ.Widget();
logger._receive = function(msg) { console.log(msg.toString()); };

// or

var logger = JZZ.Widget({ _receive: function(msg) {
  console.log(msg.toString());
}});

// ...

JZZ().openMidiIn().connect(logger);

emit()

_emit(msg), emit(msg) - send MIDI event to the descendant nodes; _emit(msg) is synchronous, emit(msg) - asynchronous.

These functions are most often used by gadgets emulating MIDI-In devices.

Example

var delay = JZZ.Widget();
delay._receive = function(msg) { this.wait(500).emit(msg); };

addMidiIn()

JZZ.addMidiIn(name, widget) - register widget as MIDI-In port.

name must be a unique name for the new MIDI port.

addMidiOut()

JZZ.addMidiOut(name, widget) - register widget as MIDI-Out port.

name must be a unique name for the new MIDI port.

Example

var logger = JZZ.Widget({ _receive: function(msg) { console.log(msg.toString()); }});
JZZ.addMidiOut('Console Logger', logger);

// now it can be used as a port:
var port = JZZ().openMidiOut('Console Logger');
// ...

// if required, substitute the native MIDIAccess
// to make virtual ports visible to the Web MIDI API code:
navigator.requestMIDIAccess = JZZ.requestMIDIAccess;

See also