** Function key usage ** Mouse F1 - Display this help information. [Help] F2 - Start recording. [Record] F3 - Exit program. [Exit] F9 - Decrement cell value. F10 - Increment cell value. Alt-F2 - Toggle MIDI thru mode off/on (default is on). [Thru] Alt-F3 - Push to DOS (suspends playing). [Push] ** Editing ** Use the arrow keys to move the large block cursor around the screen to select the available data fields or "cells". On a color monitor, the data in cells which can be changed will appear yellow. Note the input area near the bottom of the screen, indicated by ">" and the small blinking cursor. To enter or change a selected cell, type into the input area and press return. The value entered will then appear in the cell (if the input was valid). A description of the valid input for the current cell will always appear on the line above the input area. Use the following keys for editing: Return - Retrieves the current contents of a cell and places it in the input area for modification (if the input area is empty). Insert - Toggles between character insert and overwrite modes. Delete - Deletes the character at the cursor. BackSpace - Deletes the character before the cursor. End - Moves to the end of the character string. Home - Moves to the beginning of the character string. Escape - Erases the input area. ** Operation ** When RECORD is run without specifying a file name on the command line, it executes interactively. Several options can be specified by filling in the data cells on the screen prior to recording. To begin recording, press F2 (or click the [Record] block at the bottom of the screen). Recording begins with the first MIDI event received, and continues until a key is pressed (on the computer keyboard). Data cells: - File: The name of the MIDI output file. The default name is "out.mff". Recording can be initiated repeatedly and the output file will be replaced each time unless the name is changed. - Title: A short descriptive note to be included in the file for use by a MIDI file-capable sequencer or other reader. - Tempo: The base tempo assigned to the sequence. The default is 120 quarter note beats per minute. - Format: One of 3 possible MIDI file formats - 0, 1, or 2. The output is basically unchanged, regardless of this setting, though some sequencers expect a specific format number. Most will accept format 0. RECORD will write a single track in all cases. - Delay: Allows a pause to be inserted at the beginning of the sequence. Normally, the first MIDI event will be recorded at time 0, but if this value is non-zero, the first event will start at the specified time (in tenths of a second). ** Mouse usage ** When a Microsoft-compatible mouse is available and the mouse driver software properly loaded, operations using the mouse will be enabled. The mouse may be used to select an input cell on the screen by positioning the small mouse cursor on the cell and single clicking either button. The cell will be highlighted, just as if the cell had been selected using the arrow keys. Any cell which can be changed using the F10/F9 keys to increment/decrement, may be changed in a similar manner using the mouse. Once a cell is selected by clicking on it, subsequent clicking of the left button will decrement the cell value, and clicking of the right button will increment it. In mouse mode, the function key designations normally displayed at the bottom of the screen are changed to selector blocks for each available function. Clicking on a block will perform the indicated function. All functions may still be invoked via the normal keyboard equivalents. If mouse operations are not desired, add the -k option on the command line when the program is run to force keyboard mode. ** Command line usage ** RECORD If is specified, RECORD is run non-interactively (i.e., recording is begun and the given file is used for the MIDI file output). Recording begins when the first MIDI event is received, and continues until a key is pressed (on the computer keyboard). Interactive mode is selected simply by leaving off the file name. may be any of the following: -r indicates that the Roland MPU compatible interface is to be used if an IBM Music Feature card is also present. -p followed by a hexidecimal number defines the base I/O address to be used for the MPU interface. Note that MIDI hardware interrupts are not used, so the IRQ setting of the interface is not relevant. -k forces keyboard mode if a mouse is present. -m forces monochrome mode (mono mode is automatically detected). Separate all options with at least one space. Examples: record (Runs the program interactively) record test.mff (Begins recording to file test.mff) record -p336 (Runs interactively; forces MPU I/O address 336) record test.mff -r (Records to file, forcing MPU mode) ---------------------------------------------------------------------------