xeq  class


xeq   <sequence-name>

Arguments

<sequence-name> Optional.  Identifier of a sequence hosted by this xeq object.  All friends point to this sequence through a <sequence-name>.  If xeq is used as a player object, this is also its reference name.

Methods

tracks <track-template>.  Sets playback track template to a <track-template> symbol.  This is a freezable playback parameter used for track filtering.
tracks Reports current value of playback track template.
transpo <shift>.  Sets playback transposition to an integer <shift>, which may be positive or negative.  This is a freezable playback parameter used for shifting a sequence by <shift> MIDI keys.
tempo <factor>.  Sets tempo factor to a non negative float <factor>.  Original tempo of a sequence is multiplied by tempo factor during playback.  This is a freezable playback parameter.
bang Starts one-shot playback from current playhead position.
next Moves stephead to next event, after:  1. sending all messages of current event (MIDI messages through 2nd outlet, other messages remotely);  2. sending delta vector of next event (through 1st outlet).
loop <begin-time> <end-time>.  Starts loop playback from <begin-time> (this is also restart-point of a loop).  Sets loop end-point to <end-time>.  Both arguments are sequence times.
loop Cancels current looping.  Continues playback in one-shot mode.
rewind Stops playback.  Moves both playhead, and stephead to the sequence beginning.  Note, that since rewinding does not imply flushing, applying rewind to a MIDI sequence in most cases needs to be followed with a flush message.
stop Stops playback without moving the heads.  Note, that since stopping does not imply flushing, applying stop to a MIDI sequence in most cases needs to be followed with a flush message.
flush Sends all pending note-offs through 2nd outlet.
locate <locator> <sequence-time>.  Sets current <locator> position to <sequence-time>.  The locators are: auto (the playhead), step (the stephead), bloop (looping start-point), eloop (looping end-point), bedit (start of selection), and eedit (end of selection).
locate <sequence-time>.  Same as locate  auto <sequence-time>.
locate <locator> <reference-locator>.  Sets current <locator> position to that of <reference-locator>.
locate <locator>.  Reports current <locator> position.
locate Reports current positions of the locators.
locafter <locator> <relative-time>.  Same as locate  <locator> (<current-locator-position>+<relative-time>).
locafter <relative-time>.  Same as locafter  auto <relative-time>.
find <message>.  Looks in a sequence for first event containing a <message>.  Reports whatever outcome of a search and, if a message is found, sets bedit locator to point to the event.
clear Empties the sequence.
clone <sequence-name>.  Replaces current sequence with a sequence hosted by another xeq object, having an identifier <sequence-name>.
addclone <sequence-name>.  Appends, to the end of current sequence, a sequence hosted by another xeq object, having an identifier <sequence-name>.
set <message>.  Replaces current sequence with a single <message>.
add
add2
addline
append
edit
editok
read
write
mfread <file-name> <track-template>.  Loads a sequence from standard MIDI file.  The tracks are renamed and/or ignored according to <track-template>.
mfwrite <file-name> <track-template>.
print

Outlets

1st Delta vector, sent only in step mode.
2nd Raw MIDI data stream.  May be connected to a midiout object.
3rd Bang sent when xeq reaches end of sequence during playback or in step mode.  Sent also at loopover.

to be continued...


complaints to this address