home *** CD-ROM | disk | FTP | other *** search
/ Action Ware 12: Heretic & Hexen / actionware12.iso / acware12 / sounds / mus_play / musplay.doc < prev    next >
Text File  |  1994-10-29  |  5KB  |  124 lines
  1.  
  2.             MUS Player  Version 1.50
  3.             ========================
  4.  
  5.              by Vladimir (Wladows) Arnost
  6.                   QA-Software
  7.  
  8.          Internet: xarnos00@dcse.fee.vutbr.cz
  9.  
  10. This is the first public release of my DOOM music player. All you have to do
  11. is to unpack this archive and run MUSPLAY.EXE with proper parameters.
  12.  
  13.  
  14. Demo Songs:
  15. ----------
  16.  
  17.   This release contains two demo songs taken from wide-spread WAD files.
  18.   Namely, DEMO1.MUS is taken from CLASSIC2.WAD (collected by Scott Kearney)
  19.   and DEMO2.MUS comes from INVADE1.WAD (by Andy Chen and Claude Martins).
  20.   I did not include any of the original DOOM songs to avoid violating the
  21.   id's copyright. If you have DOOM (everyone has ...), you also have those
  22.   songs. The only task is to extract the songs from DOOM.WAD. In later
  23.   releases, I will include a program which will do this for you. (But I have
  24.   to write it, first).
  25.  
  26.  
  27. Command Line Parameters:
  28. -----------------------
  29.  
  30.   MUS File Player  Version 1.50  (c) 1994 QA-Software
  31.   Syntax:
  32.     MUSPLAY filename.MUS [/B[path]GENMIDI.OP2] [/1] [/M] [/Ccmd] [/L]
  33.   Options:
  34.       /Bbank    set different instrument bank
  35.       /1        don't use double-voice instruments
  36.       /M        play in mono -- thru Adlib instead of SoundBlaster Pro II
  37.       /Ccmd     exec DOS command cmd during replay
  38.       /L        play continuously (loop forever)
  39.  
  40.  
  41. Options in detail:
  42. -----------------
  43.   /Bbankname
  44.         This tells MUSPLAY to look for different instrument bank file than
  45.         the default GENMIDI.OP2. Use this also if you run MUSPLAY from other
  46.         than the current directory.
  47.  
  48.   /1
  49.         Disables so called "double-voice" instruments. This feature uses two
  50.         output channels instead of one to create each sound. These two
  51.         channels use distinct values to create richer sounds. This improves
  52.         sound quality slightly, but uses more channels. Generally you can
  53.         leave this setting enabled, but if you have a good reason for it,
  54.         you can turn it off.
  55.  
  56.   /M
  57.         Disables SoundBlaster Pro II extensions. The player uses only
  58.         standard Adlib 9-channel mono synth. Use this if autodetection
  59.         fails.
  60.  
  61.   /Ccommand
  62.         Perhaps the strongest feature. This allows any program to be run
  63.         while the player is replaying the song on the background. Extensive
  64.         testing was performed to make this reliable and non-conflicting with
  65.         other DOS applications. MUSPLAY is guaranteed to run even under
  66.         DOS-extended games like DOOM (if you disable DOOM's own music, of
  67.         course :-). It is not wise to run any other application that uses
  68.         FM music under MUSPLAY -- the program will not hang up (probably),
  69.         but the two songs played at once would sound horribly.
  70.  
  71.   /L
  72.         Useful for terrorizing your enemies -- let some song play forever...
  73.  
  74.  
  75. Keys:
  76. ----
  77.   Esc           Stop playing immediately and return back to DOS
  78.   C             Invoke COMMAND.COM. Does not stop playing.
  79.   Alt-SysRq     Fast forward (skip some part of a song). Especially useful
  80.                 when MUSPLAY plays on the background.
  81.  
  82.  
  83. Sample Program Output:
  84. ---------------------
  85.  
  86.   MUS File Player  Version 1.50  (c) 1994 QA-Software
  87.   Sound Blaster Pro II detected (18 channels stereo)
  88.   Reading file DEMO1.MUS ...
  89.   Reading file GENMIDI.OP2 ...
  90.   Playing ... mm:ss:ttt  pp (cc)
  91.  
  92.   where 'mm:ss:ttt' is playing time (m-minutes, s-seconds, t-milliseconds),
  93.   'pp' is the number of notes being played and 'cc' is the number of output
  94.   channels used.
  95.  
  96.  
  97. Hardware and Software Requirements:
  98. ----------------------------------
  99.     * processor 386 or higher (if you have DOOM ...)
  100.     * sound card (Adlib or SB Pro II compatible)
  101.     * PC-AT compatible machine (with standard Real-Time Clock chipset and
  102.       CMOS memory layout)
  103.  
  104.     * MS-DOS version 3.0+
  105.     * about 128 KB of free conventional memory
  106.  
  107.  
  108. Future Plans:
  109. ------------
  110.     * digital playback (to use samples instead of FM synthesis)
  111.       BTW. if you have a nice set of MIDI instrument samples, you (especially
  112.       GUS owners) could contact me, I would like to have some
  113.     * full screen display (not console-like) with graphical bars and blobs
  114.     * MIDI file support
  115.     * OPL4 support -- if anyone knows something about it, let the world know
  116.     * EMS or XMS support (to play songs not stored in conventional memory)
  117.  
  118.  
  119. Known Bugs:
  120. ----------
  121. File D_INTROA.MUS from original DOOM.WAD is not played correctly (some voices
  122. sound too loud). I can't figure out why.
  123.  
  124.