mtr

In any inlet other than the left inlet: If the track is currently being recorded, numbers received in that track's inlet are combined with a delta time (the number of milliseconds elapsed since the previous event) and stored in mtr.

In any inlet other than the left inlet: If the track is currently being recorded, numbers received in that track's inlet are combined with a delta time (the number of milliseconds elapsed since the previous event) and stored in mtr.

In any inlet other than the left inlet: If the track is currently being recorded, lists received in that track's inlet are stored in mtr, preceded by the delta time.

In any inlet other than the left inlet: If the track is currently being recorded, symbols received in that track's inlet are stored in mtr, preceded by the delta time.

Although mtr can record individual bytes of MIDI messages received from midiin, it stores each byte with a separate delta time, and does not format the MIDI messages the way seq does. If you want to record complete MIDI messages and edit them later, seq is better suited for the task. On the other hand, mtr is perfectly suited for recording sequences of numbers, lists, or symbols from virtually any object in Max: specialized MIDI objects such as notein or pgmin, user interface objects such as number box, slider, and dial, or any other object.

In order for a file to be read into mtr for playback, it must be in the proper format. An mtr multi-track sequence can even be typed in a text file, provided it adheres to the format. The contents of the different tracks are listed in order in an mtr file, and the format of each track is as follows. Note that a semicolon (;) ends each line.

Line 1: track <track number>; (Track in which to store subsequent data)
Line 2, etc.: <delta time> <message>;
Last line: end; (End of this track's data)

In left inlet: Erases the contents of mtr. The word clear, followed by one or more track numbers, clears those tracks.

In other inlets: Erases the track that corresponds to the inlet.

In left inlet: The word delay, followed by a number of milliseconds, sets the first delta time value of each track to that number, so that all tracks begin playing back that amount of time after the play message is received.

In other inlets: Sets the initial delta time of the track that corresponds to the inlet.

In left inlet: The word first, followed by a number of milliseconds, causes mtr to wait that amount of time after a play message is received before playing back. Unlike delay, first does not alter the delta time value of the first event in a track, it just waits a certain time (in addition to the first delta time) before playing back from the beginning.

In left inlet: Causes each track to output only the next message in its recorded sequence. When a next message is received, the track number and the delta time of each message being output are sent out the leftmost outlet as a list. The word next, followed by one or more track numbers, outputs the next message stored in those tracks.

In other inlets: Outputs the next message stored on the track that corresponds to the inlet.

In left inlet: Causes mtr to stop producing output, while still continuing to "play" (still moving forward in the sequence). The word mute, followed by one or more tracks, mutes those tracks.

In other inlets: Mutes the track that corresponds to the inlet.

In left inlet: Plays back all messages recorded earlier, sending them out the corresponding outlets in the same rhythm and at the same speed they were recorded. The word play, followed by one or more track numbers, begins playing those tracks.

In other inlets: Plays back all messages on the track that corresponds to the inlet.

In left inlet: Calls up the standard Open Document dialog box, so that a previously saved file can be read into mtr.

In other inlets: Opens a file containing only the track that corresponds to the inlet.

In left inlet: Begins recording all messages received in the other inlets. The word record, followed by one or more track numbers, begins recording those tracks.
In other inlets: Begins recording messages on the track that corresponds to the inlet.

In left inlet: Resets mtr to the beginning of its recorded sequence. This command is used to return to the beginning of the sequence when stepping through messages with next. To return to the beginning of a sequence while playing or recording, just repeat the play or record message. When mtr is playing or recording, a stop message should precede a rewind message. The word rewind, followed by one or more track numbers, returns to the beginning of those tracks.

In other inlets: Returns the pointer to the beginning of the track that corresponds to the inlet.

In left inlet: Stops mtr when it is recording or playing. The word stop, followed by one or more track numbers, stops those tracks.

In other inlets: Stops the track that corresponds to the inlet.

In left inlet: Undoes any previously received mute messages. The word unmute, followed by one or more track numbers, unmutes those tracks.

In other inlets: Unmutes the track that corresponds to the inlet.

In left inlet: Calls up the standard Save As dialog box, allowing the contents of mtr to be saved as a separate file. Note that the only way to save the contents of mtr is with the write message; the object's contents cannot be embedded in a patcher file.

In other inlets: Writes a file containing only the track that corresponds to the inlet.