Open or re-initialize the MIDI environment. The first five keyword arguments specify size limits for various data structures internal to the environment and hence force an implicit shutdown and re-opening if re-set in runtime. More precisely. max-logical-channels, max-routes and max-connections determine the dimensions of the internal channel and route maps, max-mappings the maximal number of mappings that may be established across both maps, and queue-size the number of events that may be queued for output before calls to midi-write-message block.

channel-map, route-map and connections initialize or re-set the internal data structures. port is provided for backwards compatibility only and its use is deprecated.

All keyword parameters take their defaults from global variables that may (and should) be customized by users to simplify opening MIDI. See their respective documentation for more info on the data expected by each parameter.

Calling midi-open while MIDI is already open closes MIDI first, then re-opens it again.

midi-open returns t if MIDI is open or nil if it is not (i.e., the updated value of midi-open?.)

See Also:

*midi-default-max-logical-channels*, *midi-default-max-routes*, *midi-default-max-connections*, *midi-default-max-mappings*, *midi-default-queue-size*, *midi-default-channel-map*, *midi-default-route-map*, *midi-default-connections*, midi-open?

See Also:

midi-open?

MIDI Environment

Use this function to update the MIDI environment if you've added new devices to the system such as a new MIDI client that you want to receive messages.

Print a summary of the current MIDI environment to stream. verbosity may be one of 0 (terse), 1 (default), or 2 (technical). stream must be either :stdout or :stderr, requesting output on either *standard-output* or *standard-error, respectively.

midi-get-environment-info takes as arguments any number of keyword info selectors in selectors and returns the query results for each selector as multiple values.

Possible information selectors are:

:mi_d-max-logical-channels

maximum number of channels

mi_d-max-routes

maximum number of routes

mi_d-max-connections

maximum number of connections

mi_d-max-map-cells

total number of mapping cells to disposal. Note that this number is twice the number specified in the max-mappings parameter to midi-open, since each mapping is registered in both, a standard map and its inverse map.

mi_d-map-cells-in-use

maximum number of mapping cells currently in use

:mi_d-queue-size

maximum number of events in the queue

:mi_d-nr-of-interfaces

number of interfaces currently known to the system

:mi_d-interface-info

list of each interface name string and its direction: 1 (input), 2 (output) or 3 (bidirectional)

:mi_d-input-interfaces

list of configured input interfaces

:mi_d-output-interfaces

list of configured output interfaces

:mi_d-channel-map

list of current mappings in the channel map

:mi_d-inv-channel-map

list of current mappings in the inverse channel map

:mi_d-route-map

list of current mappings in the route map

:mi_d-inv-route-map

list of current mappings in the inverse route map

Example:

? (midi-get-environment-info :mi_d-max-logical-channels
	                     :mi_d-max-routes
		             :mi_d-max-connections
			     :mi_d-max-map-cells
			     :mi_d-queue-size)
120
10
10
400
20000
  

See Also:

midi-open

Performs an environment consistency check. Returns t if no inconsistencies were found, nil otherwise.

Associate connection connection with the interface named by interface. direction will be one of :input, :output or :bidirectional.

See Also:

midi-set-connections

MIDI I/O

Schedules the message encoded in msg for output at time time. If time is not specified, it defaults to 0, i.e. the message is sent immediately.

See Also:

midi-write-note, midi-write-sysex, *midi-sysex-refcounter*

Schedules a system exclusive message for output at time time. vector contains a complete system exclusive message in form of an array of type

(simple-array (unsigned-byte 8) (*))

If the client wishes to free sysex data after sending it, she is encouraged to pass a refcounter object in refcounter whose value field may be initialized to any number that is meaningful to the client--typically 0. write-sysex increments the counter, schedules the message, and returns immediately, i.e., the message is written out asynchronously. The counter is decremented as soon as the message is written out completely. This mechanism allows the client to write a sysex message to different destinations at different times, while sharing the message's data across calls. After the counter has been decremented it will be safe to deallocate the data. refcounter defaults to *midi-sysex-refcounter*. Additional refcounter objects may be constructed by calling

mi_d:make-refcounter initial-value

See Also:

*midi-sysex-refcounter*, make-sysex-message

Convenience function that schedules a note-on and note-off message pair given a note description.

Remove pending messages from the input queue and optionally map the function fun over each message. fun's lambda list must be compatible with

(msg &optional time &key data length &allow-other-keys)

Example

 ? (midi-read-messages #'midi-print-message)

See Also:

*midi-read-hook*, midi-receive, midi-print-message

Discards ("flushes") events pending in the input queue.

Discards ("flushes") events pending in the output queue.

Broadcast "All Notes Off", "All Sound Off", and "Reset All Controllers" control messages on all active output connections. Note that this does not work with some older MIDI devices that are unaware of these messages. These devices continue to need note-off messages on every channel and key number.

midi-hush is equivalent to a calling midi-all-notes-off followed by midi-flush-input and midi-flush-output.

Return the current MIDI time in milliseconds.

Set the MIDI timer to ms milliseconds.

Provided for backwards compatibility. This function does not do anything.

Start the MIDI timer. Equivalent to (midi-set-time 0).

Prints MIDI messages in a slightly different format than midi-print-messageonto *standard-output*

See Also:

midi-print-message