home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / MIDI_PAT / MTOOLS.ZIP / MTHELP.EXE / WATCH2.HLP < prev   
Encoding:
Text File  |  1993-09-14  |  16.7 KB  |  215 lines
  1.                           ┌┬────────────────────┬┐                            
  2.                           ││ Watch: Programming ││                            
  3.                           └┴────────────────────┴┘                            
  4.                                                                               
  5.     Function key usage                                       Mouse            
  6.                                                                               
  7.    F1     - Display this help information.                  [Help]            
  8.    F3     - Exit program.                                   [Exit]            
  9.    F4     - Reset channel and message filtering.            [Channels]        
  10.    F5     - Reset send keys definitions.                    [Send keys]       
  11.    F6     - Return to MIDI monitor screen.                  [Monitor]         
  12.    F7     - Toggle MIDI thru on/off.                        [Thru]            
  13.    F8     - Toggle real-time messages on/off.               [RealTime]        
  14.    F9     - Decrease value of selected cell.                <Left button>     
  15.    F10    - Increase value of selected cell.                <Right button>    
  16.    Alt-F2 - Same as F7.                                                       
  17.    Alt-F3 - Push to DOS.                                    [Push]            
  18.    Alt-F8 - Send all-notes-off message (on all channels).   [Quiet]           
  19.    Home   - Go to top of screen.                                              
  20.    Alt-R  - Set other cells in row the same as current cell.                  
  21.    Alt-1,...Alt-9, Alt-0 -                                                    
  22.             Send MIDI data defined for corresponding key.                     
  23.                                                                               
  24.                                                                               
  25.  ┌─────────┐                                                                  
  26.  │ Editing │                                                                  
  27.  └─────────┘                                                                  
  28.                                                                               
  29.  Use the arrow keys to move the large block cursor around the screen to       
  30.  select the available data fields or "cells".  On a color monitor, the data   
  31.  in cells which can be changed will appear yellow.  Note the input area near  
  32.  the bottom of the screen, indicated by ">" and the small blinking cursor.    
  33.  To enter or change a selected cell, type into the input area and press       
  34.  return.  The value entered will then appear in the cell (if the input was    
  35.  valid).  A description of the valid input for the current cell will always   
  36.  appear on the line above the input area.                                     
  37.                                                                               
  38.  Use the following keys for editing:                                          
  39.                                                                               
  40.   Return    - Retrieves the current contents of a cell and places it in the   
  41.                input area for modification (if the input area is empty).      
  42.   Insert    - Toggles between character insert and overwrite modes.           
  43.   Delete    - Deletes the character at the cursor.                            
  44.   BackSpace - Deletes the character before the cursor.                        
  45.   End       - Moves to the end of the character string.                       
  46.   Home      - Moves to the beginning of the character string.                 
  47.   Escape    - Erases the input area.                                          
  48.                                                                               
  49.  ┌───────────┐                                                                
  50.  │ Operation │                                                                
  51.  └───────────┘                                                                
  52.                                                                               
  53.  This screen allows incoming MIDI messages to be selectively filtered out or  
  54.  modified.  [Note that Thru:On must be specified if the modified data is to   
  55.  be resent.]  Each of the 16 available MIDI channels is listed across the     
  56.  top.  The matrix below permits modification or filtering by channel for      
  57.  specific classes of messages listed on the left:                             
  58.                                                                               
  59.  - Enable: All messages for the channel may be enabled (on) or disabled       
  60.    (off).  If enabled, the following items may be used to filter specific     
  61.    messages.                                                                  
  62.                                                                               
  63.  - Map: Messages received for the channel indicated at the top of the column  
  64.    will be redirected to the channel specified.  Default is the same channel. 
  65.                                                                               
  66.  - Transpose: Note messages received on the channel (before mapping) will be  
  67.    transposed by the specified number of half steps (+ or -).  Resulting      
  68.    notes below C-2 or above G8 are discarded.                                 
  69.                                                                               
  70.  - Velocity: This value has two distinct uses.  Note velocities on the        
  71.    channel will be scaled by the given percentage if the value is greater     
  72.    than zero.  100% is the original velocity and indicates no modification.   
  73.    Notes may be scaled up to maximum velocity.  If the value is negative, its 
  74.    absolute value is taken as a velocity threshold below which note messages  
  75.    are filtered out.  Both forms assume decimal values.  Ex: A value of 200   
  76.    can double the velocity, and 50 will halve it.  A value of -64 will filter 
  77.    out notes having a velocity less than 64.                                  
  78.                                                                               
  79.  - Low note: The lowest note in the range C-2 to G8 which will be received    
  80.    (prior to transposing).  C3 = middle C = MIDI note 60.                     
  81.                                                                               
  82.  - High note: The highest note which will be received.                        
  83.                                                                               
  84.    The following enable or disable specific message classes on the channel.   
  85.                                                                               
  86.  - Note Msgs: All note messages.                                              
  87.                                                                               
  88.  - Aftertouch: All aftertouch messages - poly or mono (channel pressure).     
  89.                                                                               
  90.  - Ctrl change: All control change messages.                                  
  91.                                                                               
  92.  - Prog change: All program change messages.                                  
  93.                                                                               
  94.  - Pitch wheel: All pitch bend messages.                                      
  95.                                                                               
  96.  ┌─────────────────┐                                                          
  97.  │ System Messages │                                                          
  98.  └─────────────────┘                                                          
  99.                                                                               
  100.  The following system messages can be selectively filtered:                   
  101.                                                                               
  102.   Exc:  System exclusive                                                      
  103.   Qrt:  Quarter Frame      ───┐                                               
  104.   Pos:  Song position         │  System                                       
  105.   Sel:  Song select           │  common                                       
  106.   Tun:  Tune request       ───┘                                               
  107.   Clk:  MIDI clock         ───┐                                               
  108.   Str:  Start                 │                                               
  109.   Cnt:  Continue              │  System                                       
  110.   Stp:  Stop                  │  real-time                                    
  111.   Act:  Active sensing        │                                               
  112.   Res:  System Reset       ───┘                                               
  113.                                                                               
  114.    Overall filtering of real-time data is controlled using the F7 function    
  115.    key.  If RealTime:Block is selected, no real-time data is passed.  For     
  116.    RealTime:Pass, only those messages above specifically enabled are passed.  
  117.                                                                               
  118.  All filtering and modifications are applied BEFORE data is displayed on the  
  119.  monitor screen and saved in the buffer.  Also, the data displayed is what is 
  120.  output when MIDI thru is enabled.  Note that data received while on the      
  121.  programming screen continues to be stored in the buffer.                     
  122.                                                                               
  123.  ┌───────────────────┐                                                        
  124.  │ Sending MIDI data │                                                        
  125.  └───────────────────┘                                                        
  126.                                                                               
  127.  Up to 10 keys may be assigned specific MIDI send functions.  The bottom      
  128.  section of the screen allows the keys Alt-1 thru Alt-9, and Alt-0 (see note) 
  129.  to be defined as arbitrary MIDI data.  When one of these keys is pressed,    
  130.  the associated data is sent.  Each key may be defined as a short string of   
  131.  hexadecimal digits or the name of a MIDI data file.  If a sequence is        
  132.  entered directly, it may be a continuous string of 2-digit hex numbers with  
  133.  no separators, or 1- or 2-digit hex numbers separated by spaces or commas.   
  134.  Messages up to 13 bytes may be entered this way.  For longer messages, a     
  135.  string may be continued into the next key's definition by entering a plus    
  136.  (+) as the last item in the string.  Up to 9 continuations are possible, for 
  137.  a total possible message length of 120 bytes.                                
  138.                                                                               
  139.  If the first character in the string is "@", a file name is expected to      
  140.  follow.  When the key is pressed, the named file will be sent.  The file may 
  141.  be a standard MIDI format file, or may be a binary data file containing a    
  142.  sequence of MIDI bytes.  Continuation does not apply in this case.  If just  
  143.  the "@" character is entered, or the file name includes a wildcard character 
  144.  (* or ?), a list of files from which to choose is displayed.  Move to the    
  145.  desired file and press return (or click if using a mouse).  The selected     
  146.  file name will be entered in the send key definition cell.  The same rules   
  147.  used by DOS for file matching apply.                                         
  148.                                                                               
  149.  MIDI sequences defined here may be sent from either the Programming or       
  150.  Monitor screen.  Press Alt and a digit to send the defined sequence.  If     
  151.  using a mouse, click on one of the 10 digits at the bottom of the Monitor    
  152.  screen.                                                                      
  153.                                                                               
  154.  Note:  The Alt-0 key has slightly different usage from the rest of the send  
  155.         keys.  As a shortcut to avoid the need to switch to the programming   
  156.         screen to define it, the program will prompt for its contents         
  157.         (displaying the last entered string).  That string may be modified    
  158.         or sent as is by pressing return.  To cancel the send, press escape   
  159.         to blank the string and press return.                                 
  160.                                                                               
  161.  ┌────────┐                                                                   
  162.  │ Delays │                                                                   
  163.  └────────┘                                                                   
  164.                                                                               
  165.  Send delays may be specified using the "SysEx wait" and "Bytes/sec" values.  
  166.  These may be necessary to allow certain MIDI devices to properly accept bulk 
  167.  data transmissions.  SysEx wait specifies the amount of time in milliseconds 
  168.  to wait before sending any sysex message.  A delay of up to 9999 (10 sec.)   
  169.  can be entered.  The overall transmission rate can be specified by setting   
  170.  the Bytes/sec value, thus reducing the standard MIDI transmission rate of    
  171.  3125 bytes per second.                                                       
  172.                                                                               
  173.  Delays as applied to the transmission of standard MIDI files are slightly    
  174.  altered due to the real-time nature of the files.  The basic transmission    
  175.  rate only applies to system exclusive data.  The system exclusive wait is    
  176.  not applied to the special "running" or "sub-message" sysex events which     
  177.  should already have built-in transmission times.                             
  178.                                                                               
  179.  ┌──────────────────────────┐                                                 
  180.  │ Saving the configuration │                                                 
  181.  └──────────────────────────┘                                                 
  182.                                                                               
  183.  All filter selections, key definitions, and the overall status (thru,        
  184.  real-time, hex/dec) are saved when the program ends.  They are restored the  
  185.  next time the program is run.  The original channel status may be reset      
  186.  using the Reset Channels function.  This also resets the system message      
  187.  filtering to allow all messages.  The Reset Keys function will blank all the 
  188.  send key definitions.  Settings are saved in the file "WATCH.STP".  This     
  189.  file should not be altered, or results may be unpredictable.                 
  190.                                                                               
  191.  ┌─────────────┐                                                              
  192.  │ Mouse usage │                                                              
  193.  └─────────────┘                                                              
  194.                                                                               
  195.  When a Microsoft-compatible mouse is available and the mouse driver software 
  196.  properly loaded, operations using the mouse will be enabled.  The mouse may  
  197.  be used to select an input cell on the screen by positioning the small mouse 
  198.  cursor on the cell and single clicking either button.  The cell will be      
  199.  highlighted, just as if the cell had been selected using the arrow keys.     
  200.                                                                               
  201.  Any cell which can be changed using the F10/F9 keys to increment/decrement,  
  202.  may be changed in a similar manner using the mouse.  Once a cell is selected 
  203.  by clicking on it, subsequent clicking of the left button will decrement the 
  204.  cell value, and clicking of the right button will increment it.              
  205.                                                                               
  206.  In mouse mode, the function key designations normally displayed at the       
  207.  bottom of the screen are changed to selector blocks for each available       
  208.  function.  Clicking on a block will perform the indicated function.  All     
  209.  functions may still be invoked via the normal keyboard equivalents.          
  210.                                                                               
  211.  If mouse operations are not desired, add the -k option on the command line   
  212.  when the program is run to force keyboard mode.                              
  213.                                                                               
  214.  ---------------------------------------------------------------------------  
  215.