home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / msdos / midi / play2 / play.hlp < prev    next >
Text File  |  1989-09-05  |  11KB  |  144 lines

  1.                                                                               
  2.  ** Function key usage **                                                     
  3.                                                                               
  4.    F1     - Display this help information.                                    
  5.    F3     - Exit program.                                                     
  6.    F4     - Save configuration information to disk for quicker                
  7.              start up the next time this file is played.                      
  8.    F5     - Rewind to beginning (00:00).                                      
  9.    F6     - Fast forward (advances 10 seconds at a time).                     
  10.    F7     - Toggles between play and pause.                                   
  11.    F9     - Decrease value of current field.                                  
  12.    F10    - Increase value of current field.                                  
  13.    Home   - Move to first screen cell (File).                                 
  14.    Alt-F3 - Push to DOS (suspends playing).                                   
  15.                                                                               
  16.  ** Editing **                                                                
  17.                                                                               
  18.  Use the arrow keys to move the large block cursor around the screen to       
  19.  select the available data fields or "cells".  On a color monitor, the data   
  20.  in cells which can be changed will appear yellow.  Note the input area near  
  21.  the bottom of the screen, indicated by ">" and the small blinking cursor.    
  22.  To enter or change a selected cell, type into the input area and press       
  23.  return.  The value entered will then appear in the cell (if the input was    
  24.  valid).  A description of the valid input for the current cell will always   
  25.  appear on the line above the input area.                                     
  26.                                                                               
  27.  Use the following keys for editing:                                          
  28.                                                                               
  29.   Return    - Retrieves the current contents of a cell and places it in the   
  30.                 input area for modification (if the input area is empty).     
  31.   Insert    - Toggles between character insert and overwrite modes.           
  32.   Delete    - Deletes the character at the cursor.                            
  33.   BackSpace - Deletes the character before the cursor.                        
  34.   End       - Moves to the end of the character string.                       
  35.   Home      - Moves to the beginning of the character string.                 
  36.   Escape    - Erases the input area.                                          
  37.                                                                               
  38.  ** Operation **                                                              
  39.                                                                               
  40.  To load a MIDI file, move to the "File:" cell (press Home).  Then type the   
  41.  name of the file and press return.  If no extension is given, ".MFF" is      
  42.  assumed.  After the file has been loaded, it will be scanned for the various 
  43.  types of data described below.  This will take some time, unless the data    
  44.  has been previously saved for this file using the F4 function.  Press F7 to  
  45.  begin playing.  Note that any operation may be performed while a song is     
  46.  playing.                                                                     
  47.                                                                               
  48.  Data cells:                                                                  
  49.                                                                               
  50.  - Length:  Duration of the song in minutes and seconds.                      
  51.                                                                               
  52.  - Position:  The current song position in minutes and seconds.  This cell is 
  53.    updated every second while playing is in progress.  It may be selected and 
  54.    changed at any time.  It may take a few seconds to skip to a new position, 
  55.    depending on how far away it is.  Selecting an earlier location requires   
  56.    scanning from the beginning.  The F6 (fast forward) function advances the  
  57.    position 10 seconds at a time.  F10 may also be used when this cell is     
  58.    selected to advance 1 second.  F9 (decrease) is not recommended.           
  59.                                                                               
  60.  The numbered rows show channel data as follows:                              
  61.                                                                               
  62.  - Chan:  MIDI channel number (1-16).                                         
  63.                                                                               
  64.  - Notes:  Maximum number of notes played concurrently on the channel (as     
  65.    determined by note on/off messages).                                       
  66.                                                                               
  67.  - Lo/Hi:  Lowest and highest note pitches used on the channel.               
  68.                                                                               
  69.  - Vol:  Maximum volume of notes played on the channel, from 0 to 100 percent 
  70.    (determined by note velocities).  If this value is changed, subsequent     
  71.    note volumes will be adjusted *relative* to the original maximum value.    
  72.                                                                               
  73.  - Map:  Channel to which the original output for this channel is to be       
  74.    redirected (1 to 16).  Default is the same channel.                        
  75.                                                                               
  76.  - Chg:  Determines whether program changes are allowed for the channel. "On" 
  77.    indicates changes enabled.                                                 
  78.                                                                               
  79.  - Xpos:  The number of half steps that notes on the channel are to be        
  80.    transposed.  From -127 to +127.  Notes transposed below 0 or above 127     
  81.    will not be played.                                                        
  82.                                                                               
  83.  - Tracks:  Lists the MIDI file track numbers which contain messages for the  
  84.    channel.  (There may be more than can be displayed - use the program in    
  85.    line mode to get full track information.)  Note that track 1 typically     
  86.    contains only tempo information and will probably not appear.              
  87.                                                                               
  88.  - Info:  Originally contains textual information found while scanning the    
  89.    track(s) corresponding to the channel.  This information may be changed as 
  90.    desired to record information about the file for future reference.  It can 
  91.    be saved along with the rest of the screen data by using the F4 function.  
  92.                                                                               
  93.                                                                               
  94.  ** Saving **                                                                 
  95.                                                                               
  96.  When the F4 (save) function key is pressed, the current data on the screen   
  97.  will be saved to a file.  The same name as the current file is used, but     
  98.  with the extension ".PLA".  If a .PLA file corresponding to the MIDI file    
  99.  being loaded is found, that data will be used and the (sometimes slow)       
  100.  initial scan step is eliminated.  F4 will replace the existing .PLA file     
  101.  whenever it is pressed.                                                      
  102.                                                                               
  103.  ** Command line usage **                                                     
  104.                                                                               
  105.  PLAY <filename> <mode> <options>                                             
  106.                                                                               
  107.  If <filename> is specified, PLAY is run non-interactively (i.e., the file is 
  108.  just played, without the full-screen editing display).  Interactive mode is  
  109.  selected simply by leaving off the file name.                                
  110.                                                                               
  111.  <mode> may only be specified if a file name is given.  If <mode> is a number 
  112.  from 1 to 16, it indicates the channel to which all channel messages will be 
  113.  redirected.  This is useful for quick "auditioning" of a file when the       
  114.  actual channels are unknown, or when they do not match the equipment         
  115.  settings.  For more control, run PLAY interactively.                         
  116.                                                                               
  117.  If <mode> is the letter "S", no playing is done, but the file is scanned and 
  118.  pertinent channel and track information is listed (similar to that displayed 
  119.  in interactive mode).  To capture scan output to a file, use standard DOS    
  120.  output redirection:  play midifile s >outfile                                
  121.                                                                               
  122.  <options> may be "-r" and/or "-p", and may be specified for either           
  123.  interactive or non-interactive mode.  "-r" indicates that the Roland MPU     
  124.  compatible interface is to be used if an IBM Music Feature card is also      
  125.  present.  "-p" followed by a hexidecimal number defines the base I/O address 
  126.  to be used for the MPU interface.  Note that MIDI hardware interrupts are    
  127.  not used, so the IRQ setting of the interface is not relevant.               
  128.                                                                               
  129.  Examples:                                                                    
  130.                                                                               
  131.    play                     (Runs the program interactively)                  
  132.                                                                               
  133.    play test.mff            (Plays the file non-interactively)                
  134.                                                                               
  135.    play test.mff s          (Just scans the file and lists data)              
  136.                                                                               
  137.    play test.mff 3          (Maps all channels to channel 3)                  
  138.                                                                               
  139.    play -p336               (Runs interactively; forces MPU I/O address 336)  
  140.                                                                               
  141.    play test.mff -r         (Plays file, forcing MPU mode)                    
  142.                                                                               
  143.  ---------------------------------------------------------------------------  
  144.