home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / mppno101.zip / READ.ME < prev    next >
Text File  |  1993-09-24  |  6KB  |  153 lines
  1.                         MPU Piano for OS/2
  2.                               v 1.01
  3.              Copyright (C) 1993, Delta Music Systems, Inc.
  4.  
  5.  
  6. The MPU Piano program allows you to play an 85 key video "keyboard" to
  7. your MPU-401 compatible interface, as well as play Standard MIDI Format
  8. files.  It is distributed as ShareWare.
  9.  
  10. Features:
  11.   Presentation Manager
  12.     
  13.   On-Line Help
  14.  
  15.     MPU Piano has complete on-line help, just hit F1 or a Help button at
  16.     any time.  Keyboard shortcuts for all the menu options are also included.
  17.  
  18.   Smart Window Positioning
  19.  
  20.     MPU Piano uses a personal INI file to remember all of your settings and
  21.     window positions between sessions.
  22.  
  23.   Multi-threaded
  24.  
  25.     Several different threads are used to achieve a higher quality
  26.     MIDI playback.
  27.  
  28.  
  29. System Configuration/Installation
  30.  
  31.   You must have an MPU-401 compatible interface, and the DMS MPU Device
  32.   Driver installed and working.  MMPM/2 is not required.  Please note that
  33.   this means true MPU-401 compatibility, not the MPU-401 compatibility that
  34.   many sound cards claim, which is nothing more than support for UART mode -
  35.   one function of the hundreds of features of the MPU-401.  For more
  36.   information, feel free to call us at the number at the bottom.
  37.  
  38.   If you will be running MPU Piano from the Workplace Shell, copy
  39.   MPUPIANO.EXE and MPUPIANO.HLP to any directory in your system.  Open
  40.   the templates folder and drag (with mouse button 2, normally the right
  41.   mouse button) a Program template out to the desktop.  When the settings
  42.   window opens, enter the full path to where you copied the files, and the
  43.   name of the executable in the "Path and File Name" box.  e.g.
  44.   C:\MPUPNO\MPUPIANO.EXE
  45.  
  46.   Enter just the path name in the working directory box, e.g. C:\MPUPNO
  47.  
  48.   If you are just going to start MPU Piano from the command line, you will
  49.   need either start MPU Piano from the directory in which it resides, or 
  50.   add that directory to your PATH and HELP environment variables, set in
  51.   CONFIG.SYS.
  52.  
  53.   You may wish to set an environment variable, MPUPIANO_INI, to a directory
  54.   and file that you wish to use to store session settings.  If this variable
  55.   is not set, the current directory, and the name MPUPIANO.INI is used.
  56.  
  57.   For example, in your config.sys, add the line:
  58.   SET MPUPIANO_INI=C:\MYPIANO.INI
  59.  
  60.  
  61. Notes
  62.  
  63.   There are several different formats for Standard MIDI Files.  The
  64.   unregistered version of this program can only play files in format 0.
  65.   Support for format 1 is included in the registered version.  See 
  66.   the next section and the file regist.frm for information on registering
  67.   MPU Piano.
  68.  
  69.   This program sends a program change on startup.  This can be disabled,
  70.   but only after the program is running.  This is done to make sure
  71.   the tone generator/synthesizer is synchronized to the display.  See
  72.   The online help for the Filters dialog for more information.
  73.  
  74.   While playing a MIDI file, striking notes on the video keyboard is 
  75.   not going to do what you expect, due to the buffering and thread
  76.   manipulation needed to play the song correctly.
  77.  
  78.   Short events will not affect MIDI playback, but lengthy disk I/O has
  79.   a definite, marked, negative result.  This is due to the thread starvation
  80.   by the OS/2 scheduler.
  81.  
  82. Registration
  83.  
  84.   Registration is 20.00(USD).  If you register, you will receive a version
  85.   that is capable of understanding MIDI Format 1 files, as well as a
  86.   command line MIDI File player.  Please print the file REGIST.FRM, fill
  87.   it out, and send it in with your check.
  88.  
  89. Known bugs
  90.  
  91.   After continuing a songs, the first few notes played may be arhythmic.
  92.   This is due to a logic flaw in our handling of the hardware, and will
  93.   be addressed in a future version.
  94.  
  95. Revision History
  96.  
  97.   v 1.01   The Playback LED does not turn off at the end of a song that
  98.            has been "Continued".
  99.  
  100.            Excessively long interval between playback start and MIDI output.
  101.  
  102.            Added "All Notes Off" messages as an interim measure for improved
  103.            "Stop" handling.  Some Synths ignore this message in OMNI mode.
  104.  
  105.            PB LED wasn't changing to its third state during MIDI File
  106.            interpretation.  (Difficult to see, since it's usually pretty
  107.            fast)
  108.  
  109. Future Features
  110.  
  111.   Features being considered for inclusion in a future release (see next
  112.   section for more information on release dates).  If you have any ideas,
  113.   please feel free to let us know.
  114.  
  115.     SysEx support - the current version does not support SysEx messages.
  116.  
  117.     Play Lists - If the file opened is a text file, it will be treated as
  118.       a list of MIDI files to play.
  119.  
  120.     Improve "Stop" feature - to do a rollback on the play buffer, and
  121.       send note offs
  122.  
  123.     Improve keyboard - to display keys in a "down" position as they are
  124.       struck.
  125.  
  126.     Drag-n-Drop - Drop a file on MPU Piano to open it.
  127.  
  128.     Improve buffering and thread priority - to work around the thread
  129.        starvation problem.
  130.  
  131.  
  132. Finally
  133.  
  134.   Delta Music Systems, Inc does not support the art of VaporWare.  The
  135.   increasing trend of announcing products years before they are ready is
  136.   abhorrent.  We will not announce products that only exist on paper.  We
  137.   aim for zero-defect code.  If you find any errors in any Delta Music
  138.   Systems product, please let us know so we may correct it immediately.
  139.   If you are the first to detect a new bug, you will be given a free
  140.   registration.
  141.  
  142.  
  143. Thank you,
  144.  
  145. Delta Music Systems, Inc.
  146. 2615 Ginghamsburg-Frederick Rd.
  147. Tipp City, OH  45371-9650
  148. (513) 698-5108
  149.  
  150.  
  151. OS/2 is a trademark of International Business Machines, Incorporated
  152. MMPM/2 is a trademark of International Business Machines, Incorporated
  153.