<html>
<HEAD>
<TITLE>MidiFile Module</TITLE>
</HEAD>
<BODY BGCOLOR="#AAFFFF" TEXT="#000000" LINK="#3333AA" VLINK="#6666FF"> 

<H2>
<A NAME="MidiFile">MidiFile</A>
</H2>
Basic Recorder and player for standard Midifiles.
<h4>
Inputs
</h4>
<UL Type="none">
<LI> <B>Record Midi</B> -- Event stream to be recorded
<LI> <B>Control</B> -- May be used to trigger recording or playback
</UL>
<BR>
<h4>
Outputs
</h4>
<UL Type="none">
<LI> <B>Play Midi</B> -- Playback of recorded sequence
<LI> <B>Record Midi</B> -- Pass-through of incoming MIDI stream.
<LI> <B>Control</B> -- Pass-through of control events
</UL>
<P>
<BR>
<h3>
Control Panel
</h3>
The box at top of the control panel indicates the file currently loaded into
the element's memory; the name only appears here when a file is loaded
or saved.  Immediately below the Load, Rewind, and Save buttons is a Song-position
indicator that displays the progress of playback. Below this are two text fields:  
in the (approcimate) centre is one showing he current state of the element;
on the right the length of the current contents in seconds is shown.

<h4>
Buttons
</h4>
<UL Type="none">
<LI> <B>Load...</B> -- Opens a file panel to select a midifile
to be loaded. (A file may also be dragged onto the Midifile Control Panel
itself to load it.)
<LI> <B>Save...</B> -- Opens a file panel to specify a name under which to
save the currently recorded sequence as a midifile.
<LI> <B>Rewind</B> -- Sets the current sequence back to the beginning.  Only
functional if the sequence is stopped and not already rewound.
<LI> <B>STOP</B> -- Immediately stops recording or playback.  Clicking it a second
time after stopping output causes 'All Notes Off' to be sent, silencing any
notes that may have been left hanging.
<LI> <B>PLAY</B> -- Begins, or resumes, playing the current sequence.  A new or
rewound sequence is played from the beginning. A stopped sequence is resumed from
the current point.  This button is enabled at all times when the element is
stopped (whatever the setting of the PlayMode popup -- below). 
<LI> <B>RECORD</B> -- Sets the element into Recording mode.  Whether recording
begins immediately or not depends on the RecordMode popup setting (below).
Note though that activating this button
<i>immediately</i> erases any currently stored sequence. 
</UL>
<h4>
Popup Selectors:
</h4>
<UL Type="none">
<LI> <i>Play Mode</i> (bottom right) -- Determines what (besides the
<B>PLAY</B> button itself) will initiate playback.
<UL Type="none">
<LI> <B>Manual</B> -- (default) Playback can only be initiated by 'pressing'
the <B>PLAY</B> button.
<LI> <B>Play on MIDI</B>  -- Playback will be initiated by the first MIDI
event to arrive (on the <B>Record Midi</B> input) while the sequence is AT START.
(Independent of the <B>PLAY</B> button -- set back to Manual to avoid autostart.)
<LI> <B>Play on Control</B> --  Playback will be initiated by the first
event of any kind to arrive on the <B>Control</B> input while the sequence is
AT START.
(Independent of the <B>PLAY</B> button -- set to Manual to avoid autostart.)
</UL>

<LI> <i>Record Mode</i> (below <B>RECORD</B> button) -- Determines what
will initiate recording.
<UL Type="none">
<LI> <B>Immediate</B> -- Recording begins at the moment the <B>RECORD</B>
button is 'pressed'.
<LI> <B>Trig on MIDI</B> -- (default) Recording begins on the first MIDI
event to arrive after the <B>RECORD</B> button is activated.
<LI> <B>Trig on Control</B> -- Recording begins on the first event (of
<i>any</i> kind) to arrive at the <B>Control</B> input
after the <B>RECORD</B> button is activated.
</UL>

</UL>



For more information, see
<A HREF="../../Documentation/Newer_MIDI.html#MidiFile">MidiFile</A>
in the "Newer_MIDI" documentation.
<BR>

</body>
</html>
