home *** CD-ROM | disk | FTP | other *** search
/ In'side Shareware 1995 March / ish0395.iso / os2 / midilab / readme.txt < prev   
Text File  |  1994-11-05  |  9KB  |  188 lines
  1.  
  2.                  ** MidiLab/2 Installation and Notes **
  3.  
  4. ------------IMPORTANT---------------IMPORTANT----------------IMPORTANT---------
  5. Beginning with release 2.30,  MidiLab/2 requires that the OS/2 V2.1 Multimedia
  6. Presentation Manager (MMPM/2) be installed. These are the last two diskettes
  7. provided with the OS/2 2.1 set.
  8.  
  9. MidiLab/2 supports the Roland MPU-401 family of hardware MIDI interfaces in
  10. >>ONLY<< the "intelligent co-processor", or non-UART, mode of operation. If you
  11. have a hardware device which claims to be MPU-401 compatible, you must furthur
  12. determine whether or not the compatibility claim supports this mode. If it
  13. doesn't, MidiLab/2 will not function.  (See the NOTE under step 4)
  14. ------------IMPORTANT---------------IMPORTANT----------------IMPORTANT---------
  15.  
  16. MidiLab/2 should be installed within an OS/2 2.1 environment, in its own
  17. directory.  Install as follows:
  18.  
  19. 1. Create a directory for MidiLab/2 on a drive of your choice.  The following
  20.    examples and instructions assume the directory is named MLABPM, and it is
  21.    set as the current directory.
  22.  
  23. 2. After copying MLABVxxx.EXE into the MLABPM directory, simply execute it.
  24.    It's a self-extracting ZIP file, and will install all required files.
  25.  
  26. 3. Create a MidiLab/2 icon by dragging a program template to an existing folder
  27.    (or to the desktop) specifying the following settings:
  28.  
  29.    Program
  30.      - Path and file name: [d:]\MLABPM\MLABPM.EXE
  31.      - Parameters: /P=[d:]\songlib
  32.      - Working directory: [d:]\MLABPM
  33.    General
  34.      - Title: MidiLab/2
  35.  
  36.    The optional /P parameter is used to specify a default directory for loading
  37.    and saving MIDI data files.  Extensions of .MID (standard MIDI format 1) and
  38.    .ML (MidiLab/2 native format) are supported.
  39.    See 'Invoking MidiLab/2' under the Help Index for other optional parameters.
  40.  
  41. 4. Add a DEVICE statement to CONFIG.SYS for the MidiLab/2 MPU device driver:
  42.       DEVICE=[d:]\MLABPM\MPU401DD.SYS I=n
  43.    where:
  44.     n is the interrupt for which the MPU hardware is wired. (usually 2 or 5)
  45.  
  46.     NOTE:  MidiLab/2 will run in a 'demo' mode if you don't have the MPU-401
  47.     hardware.  The play and record functions will be disabled, but the file
  48.     manager, editor, and most of the dialog boxes and windows will be available.
  49.     The DEVICE statement is not required in this case, but a parameter of /Z
  50.     should be used to avoid warning messages.
  51.  
  52.     For a user without the MPU hardware, this mode can still provide some
  53.     useful facilities, such as examining, editing, or even creating MIDI files.
  54.  
  55. 5. After re-booting your system, MidiLab/2 will be ready to run by mousing the
  56.    MidiLab/2 icon created in step 3.
  57.  
  58.    A sample songfile (5THSYM.ML) created by MidiLab/2 is included, to be placed
  59.    in a directory of your choice. This songfile is NOT a standard general MIDI
  60.    file.  It is highly unlikely that it will play with the correct voicing on
  61.    your synthesizer; however, it provides you the opportunity to familiarize
  62.    yourself with some of MidiLab/2's functions to voice the tracks properly.
  63.  
  64. ------------------------------------------------------------------------------
  65. The online HELP contains the documentation and description of the product,
  66. as well as an introductory MIDI tutorial. Everything (I hope) you need to know
  67. is contained in the help support.  Most, if not all, dialogs and pull-downs
  68. have at least some basic verbage on their functions.
  69.  
  70. IMPORTANT: MidiLab/2 is designed for an XGA high-resolution display (1024 X 768).
  71.            There are currently some problems achieving Display device
  72.            independence.  If the MidiLab/2 main window is incorrectly
  73.            positioned when first started, reposition it with the mouse (or
  74.            Alt-F7) and then exit the program.  This will save the current
  75.            window position, and it will be subsequently positioned correctly.
  76.  
  77.            A related problem is that some of the dialog box text may be
  78.            truncated.  Dragging a Helv 8 font from the Font Palette to the
  79.            affected dialog box may correct the problem.
  80.  
  81. MidiLab/2 has evolved over a seven year period, starting out as a DOS program,
  82. then OS/2 1.3 non-PM, and finally on to 2.0 32 bit.  Your comments and
  83. suggestions are welcome, either on MIDILAB FORUM (VM), PC-TIE, or Compuserve.
  84.  
  85. Or write to:
  86.              Far Pavilions Studio
  87.              PO Box 2314
  88.              Saratoga, Ca. 95070-0314
  89.  
  90. ------------------------------------------------------------------------------
  91. Release 2.60 notes:   October 1994
  92.  
  93.   - Add graphical song editor
  94.     (Note: some functions of this editor are not yet implemented)
  95.  
  96. Release 2.40 notes:   March 1994
  97.  
  98.   - Preserve original time base when saving non-std value
  99.   - Allow playing of certain files with MPU-incompatible time bases
  100.   - Expand Jumbo Measures Display to include total measures in song
  101.  
  102. Release 2.30 notes:   February 1994
  103.  
  104.   - Allow MIDI-THRU / OMNI mode setting to be saved in .INI.
  105.   - Disallow SysReset if function is active
  106.   - Position Edit list box to current index position at entry
  107.   - Implement 'Measures to play' and PlayLoop function
  108.   - Set YESNOCANCEL for Confirm, allow abort on INI change
  109.   - Added Reset button for 'starting_measures' group box
  110.   - Convert main window pushbuttons to MMPM/2 graphic style
  111.   - Implement Fast-Fwd (finally)
  112.   - Put in bitmapped visual metronome
  113.   - Set file search string to "*.M*" instead of "*.*"
  114.  
  115. Release 2.21 notes:   September 1993
  116.  
  117.   - Provided for saving main window position in MLABPM.INI.
  118.   - Update main window tempo box when tempo control slider is moved.
  119.   - Insert Measure-End marks into MIDI 1.0 files to aid editing.
  120.   - Miscellaneous bug and performance fixes.
  121.  
  122. Release 2.10 notes:   August 1993
  123.  
  124.   - Fixed major I/O bug which was causing intermittent system hang
  125.   - Added Track Erase function by double-clicking on index field.
  126.   - Now packaging product using Self-Extracting ZIP file.
  127.  
  128. Release 2.00 notes:   July 1993
  129.  
  130.   - Support for 16 tracks added.
  131.   - Maximum capacity of each track increased to 999,999 bytes.
  132.   - Option to display track text data during load
  133.   - Track name field increased to 16 characters.
  134.   - Track size parameters eliminated when invoking MidiLab/2. Track sizes are
  135.     now specified via a dialog box by double clicking the track size field.
  136.  
  137. Release 1.20 notes:   June 1993
  138.  
  139.   - Added Jumbo measure display
  140.   - Primitive font support
  141.   - Miscellaneous bug and performance fixes.
  142.  
  143. Release 1.10 notes:   April 1993
  144.  
  145.   - Added improvements to Editor, including ability to easily mark large blocks.
  146.   - Added MLABPM.INI; initialization file.
  147.   - Added Remote Control facility, enabling MidiLab/2 to be controlled from a
  148.     MIDI device.
  149.   - Track capacity extended to 65K
  150.   - Miscellaneous bug and performance fixes.
  151.  
  152. ------------------------------------------------------------------------------
  153.  
  154. Miscellaneous usage notes:
  155.  
  156.   - If errors occur immediately following installation, the most likely cause
  157.     is an incorrect IRQ setting for the MPU hardware and/or the DEVICE
  158.     statement in CONFIG.SYS.  Other common problems are incompatabile MIDI
  159.     hardware, or in some cases, a back-level MLABPM.INI file. In the last case,
  160.     deleting the file will permit a new one to be allocated.
  161.  
  162.   - The MidiLab/2 device driver and the WIN/OS2 MPU-401 driver cannot coexist.
  163.     One must be deactivated in order to use the other. When running MidiLab/2,
  164.     insure WIN/OS2 is not active, and vice-versa. In some cases, it may be
  165.     necessary to REM out the MidiLab/2 driver statement in CONFIG.SYS in order
  166.     to run WIN/OS2 MIDI applications.
  167.  
  168.   - If performance problems occur, try turning off the index display from the
  169.     'Utilities' pull-down.
  170.  
  171.   - Time bases greater than 192 PPQ (pulses per quarter note) are supported
  172.     only if they are an even multiple of 120, e.g.: 240, 480, etc.
  173.  
  174.   - MidiLab/2 supports a maximum of sixteen virtual tracks, and will load only
  175.     the first seventeen tracks of a Format 1 MIDI file containing more than 17.
  176.     The first track is assumed to contain setup information such as tempo, etc.
  177.  
  178.   - In Edit, the event list box is limited to approx. 2000 events.  This is
  179.     due to an OS/2 limitation of 65K for list box contents.  This
  180.     limitation is expected to be lifted in a future release of OS/2.
  181.  
  182. ------------------------------------------------------------------------------
  183.  
  184. James L. Bell
  185. Far Pavilions Studio
  186. Compuserve: 71034,3001
  187. Tel: (408) 378-9649
  188.