m:clients()

fetch table of clients

m=wmidi.create()

Returns nil,error if something goes wrong so can be used with assert otherwise returns a midi object.

m:destroy()

Free the midi and associated memory. This will of course be done automatically by garbage collection but you can force it explicitly using this function.

str = m:event_to_string(event)

Convert an event to a single line string for printing to the console.

m:get()

get all values for this connection and store them in m

m:peek(it)

Returns a event if there is one or null if none are currently available.

p = m:port_create(name,caps,type)

Create a port with the given name and capability bits and type.

bits and type are either a number or a table of bitnames.

Returns the number of the port created which should be used in port_destroy or nil if something went wrong.

m:port_destroy(num)

Destroy a previously created port. Returns nil on failure, true on success.

m:pull(it)

Receive an input midi event, blocking until there is one.

Occasionally, for "reasons" this may return nil.

m:push(it)

Send an output midi event.

m:set()

set all values for this connection from values found in m

client,port = m:string_to_clientport(str)

Convert a "client:port" string to two numbers client,port this can either be two decimal numbers or, if a m:scan() has been performed, then a partial case insensitive matching to the name of existing clients and ports may get a port number.

Will return a nil if we can not work out which client or port you mean.

m:subscribe{
    source_client=0,	source_port=0,
    dest_client=1,		dest_port=0,
}

m:subscribe{
    source="0:0",
    dest="1:0",
}

Creates a persistent subscription between two ports.

m:unsubscribe{
    source_client=0,	source_port=0,
    dest_client=1,		dest_port=0,
}

m:unsubscribe{
    source="0:0",
    dest="1:0",
}

Removes a persistent subscription from between two ports.