home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / MIDI_PAT / MIDIM208.ZIP / README.TXT < prev   
Encoding:
Text File  |  1993-10-19  |  5.6 KB  |  137 lines
  1. MIDI Monitor 
  2. Version 2.08
  3. DRAFT 19-OCT-93
  4.  
  5.  
  6. MIDI Monitor is a Windows 3.1 program.  It displays incoming MIDI streams,
  7. and passes the data to a MIDI output driver or the MIDI Mapper.  The 
  8. program was originally included in the MS Windows 3.1 SDK, but has been 
  9. extensively modified.
  10.  
  11. This ZIP file contains the source code for the current version of
  12. MIDIMON, plus the executables.  The CTL3D stuff is from Microsoft
  13. and the source is not available.  The CTL3DV2.DLL MUST be installed in
  14. the Windows SYSTEM library.
  15.  
  16. This document is a very brief overview of MIDIMON and how to install it.
  17. If you require more extensive information or have any questions you may
  18. contact me via Compuserve [73030,351], telephone, or mail:
  19.  
  20. Jamie O'Connell
  21. 191 Park Drive #44
  22. Boston, MA 02215
  23. (617) 267-4556
  24.  
  25. INSTALLATION
  26.  
  27. This zip file contains:
  28.  
  29.  MIDIMON.EXE        The program
  30.  MIDIMCBK.DLL       Callback DLL
  31.  MSCROLL.DLL        Custom Control DLL
  32.  CTL3DV2.DLL        3d effects DLL
  33.  README.TXT        This file
  34.  
  35. To install the program, unzip the files to a directory.  The DLL files 
  36. must either be in the same directory as MIDIMON.EXE, the Windows System 
  37. directory, or in a directory named in the PATH environment variable. 
  38. IMPORTANT: The CTL3DV2.DLL must reside in the Windows SYSTEM directory. 
  39.  
  40. Next, start Windows (unless it's already running), and click on the group 
  41. you want to put MIDIMON in.  Pull down File/New... (Main menu item: File, 
  42. submenu: New) and choose "Program Item".  A dialog box is displayed 
  43. containing 4 items.  The only essential one to fill in is "Command Line".
  44. You can type in the whole pathname (ex: C:\PATH\MIDIMON.EXE where PATH is
  45. where you put the program), or you can choose "Browse" and graphically 
  46. find the program.  After you have entered the command line, click on OK, 
  47. and the icon will be added to the group.  You can then double click on the
  48. program icon to start it.  See the Windows 3.1 _User's Guide_, Chapter 3,
  49. "Creating a Program Item" if any of this is unclear.
  50.  
  51. MIDI Drivers
  52.  
  53. You can choose which MIDI drivers to monitor, by opening 
  54. Options/MIDI Devices... all installed MIDI drivers will be displayed 
  55. in 2 list boxes.  You may select any number of input devices, but
  56. only one output device (you can change the output device at any time).
  57. You can also choose the MIDI Mapper for the output device.  Be sure
  58. to check the "Output On" box, if you want MIDI input passed through
  59. to MIDI output.  
  60.  
  61. Control Panel
  62.  
  63. The Control Panel is opened by choosing Options/Control Panel... It
  64. allows you to send MIDI events to both the display, and MIDI output.
  65. By using it you can send Patch changes, volume, pan etc. in real 
  66. time.  It is a non-modal dialog box, which means you can keep it open
  67. all the time the program is running.  If the "Auto Send Value" box
  68. is checked, the events are sent as soon as the value changes.  You can
  69. use the up and down arrow keys (as well as page-up and page-down) to 
  70. change the "Spin" controls (in addition to clicking on the up or down
  71. arrowheads).  The "Panic" button will send 128 note-offs on each MIDI
  72. channel, as well as _all notes off_ and _reset controllers_ on each
  73. channel -- this may take a few seconds to complete.
  74.  
  75. Filters
  76.  
  77. The filtering functions only affect the display -- all input is passed
  78. to output.  If an item on the menu is checked, it is filtered.  Active 
  79. sensing (FE) and Realtime messages (F8) are filtered by default -- you
  80. can turn them on by unchecking the menu.
  81.  
  82. Display
  83.  
  84. The Monitor Display shows a TimeStamp -- A value of "MIDIMon" is used
  85. for events sent from the Control Panel; Port number -- the number 
  86. corresponds to the order of the MIDI Input devices; Status, Value1,
  87. and Value2 contain the actual hexadecimal MIDI values; Channel is 
  88. numbered between 1 and 16; Event shows a textual description of the
  89. MIDI Event.  For Note Events, the Note and Octave are displayed.  Which
  90. octave is displayed can be controlled by the Options/Middle C Octave 
  91. menu switch.
  92.  
  93.  
  94. Notes
  95.  
  96. When the program is minimized to an icon, the icon will animate when
  97. MIDI data is received.  
  98.  
  99. You can  temporarily release, and later re-attach,  MIDI devices from 
  100. the system menu, if you wish to use other programs which require MIDI 
  101. devices, without closing MIDIMON.  
  102.  
  103. If you choose Options/Save Setup, the current configuration is saved 
  104. to MIDIMON.INI in the Windows directory.  
  105.  
  106. Currently, only one instance of MIDIMON may be opened.  Attempts to
  107. start another instance, will activate the first instance.
  108.  
  109. DISCLAIMER
  110.  
  111. In the source code for MIDIMON, Microsoft corporation gives permission to 
  112. distribute the program or modified versions of the program as long as no 
  113. liability is incurred by Microsoft.  I extend that permission so you may 
  114. use and distribute this version of the program freely, as long as you 
  115. agree that Microsoft and Jamie O'Connell have no warranty obligations or 
  116. liability resulting from the use or misuse of MIDIMON.
  117.  
  118. RECENT CHANGE HISTORY
  119.  
  120. 19-OCT-93
  121.  
  122. Someone discovered that the Green Text on Black Background did not 
  123. display on a Mono display screen.  I've added 2 parameters to the
  124. DisplayWindow section of the MIDIMon INI file to allow selection 
  125. of these colors -- if you want to change these you'll have to edit 
  126. the MIDIMON.INI by hand.  The values form an RGB triple - Red,Green,Blue:
  127.  
  128.   [DisplayWindow]
  129.   BackGround=0,0,0  ; Screen Background - Black is the default
  130.   TextColor=0,255,0 ; Text Color - Green is the default
  131.  
  132. In addition the Labels background uses statndard windows 
  133. COLOR_APP_WORKSPACE and the Labels text uses COLOR_WINDOW_TEXT.
  134.  
  135.  
  136.  
  137.