home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / DOS / SS_PLAY / HOT15.ZIP / HOT.DOC < prev    next >
Encoding:
Text File  |  1995-07-15  |  12.1 KB  |  305 lines
  1.  
  2.                           -=-=-=-=-=-=-=-=-=-=-=-=-
  3.                             HOTCAKES MUSIC PLAYER
  4.                           -=-=-=-=-=-=-=-=-=-=-=-=-
  5.  
  6.              Copyright 1995 Melvin Douglas All Rights Reserved
  7.                            Version 1.5 JULY 1995
  8.  
  9.  
  10.  
  11. -----------
  12. WHAT IS IT?
  13. -----------
  14.  
  15. HOTCAKES  (HOT.EXE)   is a music player for DOS that  will  play  digitized
  16. MODule  music.   HOTCAKES supports all of the most popular MODule  formats,
  17. including  MED,   STM,  ULT,  S3M,  MOD,  MTM,  FAR and  669  music  files.
  18.  
  19. Acknowledgements:
  20.  
  21. Many  thanks  to Edward Schlunder and his BWSB project team  without  which
  22. this  program  would  not  be  possible.    CONFIG.EXE  and  2GDM.EXE  (aka
  23. HOT!01.exe)  are excellent examples of BWSB's quality and  professionalism.
  24. The following disclaimer of warranty is extended to include Mr.   Schlunder
  25. and the BWSB project.
  26.  
  27. -----------
  28. LEGAL STUFF:
  29. -----------
  30.  
  31.      Users of HOTCAKES (HOT.EXE) must accept this disclaimer of warranty:
  32.  
  33.      THE AUTHOR OF HOTCAKES (HOT) DISCLAIMS ALL WARRANTIES RELATING TO THIS
  34.      SOFTWARE, WHETHER EXPRESSED OR  IMPLIED,  INCLUDING BUT NOT LIMITED TO
  35.      ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  36.      PURPOSE, AND  ALL  SUCH  WARRANTIES  ARE  EXPRESSLY  AND  SPECIFICALLY
  37.      DISCLAIMED.   NEITHER THE AUTHOR NOR ANYONE ELSE WHO HAS BEEN INVOLVED
  38.      IN THE CREATION, PRODUCTION,  OR  DELIVERY  OF  THIS SOFTWARE SHALL BE
  39.      LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES  ARISING
  40.      OUT  OF  THE  USE OR INABILITY TO USE SUCH SOFTWARE EVEN IF THE AUTHOR
  41.      HAS BEEN ADVISED OF THE POSSIBILITY  OF SUCH DAMAGES OR CLAIMS.  IN NO
  42.      EVENT SHALL THE AUTHOR'S LIABILITY FOR ANY  DAMAGES  EVER  EXCEED  THE
  43.      PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM
  44.      OF  THE CLAIM.  THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE
  45.      QUALITY AND PERFORMANCE OF THE SOFTWARE.
  46.  
  47.        To register this copy, print and complete the REGISTER.FRM file
  48.        and send it along with the registration fee of $20 directly to:
  49.  
  50.                            Melvin Douglas
  51.                            Post Office Box 141
  52.                            Uniondale, New York 11553-0141
  53.  
  54.     All trademarks are registered property of their respective owners.
  55.  
  56.                PROGRAM FILES: (Disk One)
  57.                ~~~~~~~~~~~~~
  58.                  HOT.EXE      - Executable music program
  59.                  HOT.DOC      - Documentation
  60.                  HOT!01.EXE   - Support file
  61.                  HOT!02.DAT   - Support file
  62.                  CONFIG.EXE   - Sound card configuration file
  63.                  *.MSE        - Sound Card Music Engine
  64.  
  65.  
  66. NOTE:  HOT.EXE, HOT!01.EXE and HOT!02.DAT must be in the current directory
  67.        when you run HOT.EXE since they all work together.
  68.  
  69. ---------------------
  70. HARDWARE REQUIREMENTS:
  71. ---------------------
  72.  
  73.     o  A 386/486 CPU
  74.        (486-33 is recommended).
  75.  
  76.     o  640K Conventional System Memory
  77.        and EXPANDED memory if available.
  78.  
  79.     o  EGA/VGA Video Adaptor.
  80.  
  81.     o  One floppy disk drive and one hard drive.
  82.  
  83.     o  A mouse is optional.
  84.  
  85.     o  One of the following sound cards (or 100% compatible):
  86.  
  87.          GUS -   Gravis Ultrasound
  88.          SB1 -   Sound Blaster 1.x
  89.          SB2 -   Sound Blaster 2.x
  90.      * SBPRO -   Sound Blaster Pro
  91.         SB16 -   Sound Blaster 16
  92.          PAS -   Pro Audio Spectrum
  93.  
  94.       * Suggested choice for compatible sound cards that support it.
  95.  
  96. ----------------------
  97. SETUP USING CONFIG.EXE:
  98. ----------------------
  99.  
  100. Using HOT.EXE is a straight forward intuitive process.   However,  prior to
  101. using  the program,  YOU MUST RUN THE CONFIG PROGRAM (only once)   so  that
  102. HOT.EXE will recognize and use your sound card properly.  Follow these easy
  103. steps:
  104.  
  105. After installing the program as outlined above, follow these steps:  At the
  106. DOS  prompt,   type  "CONFIG"  and press ENTER.   Step  through  each  menu
  107. selection until all choices are completed,  i.e.   identify your sound card
  108. from the available choices.   Most compatible sound cards will emulate  the
  109. Sound Blaster Pro.   If you are not sure,  make your selection and use  the
  110. TEST  option to determine success or failure.   Once your have made all  of
  111. your selections,  select "SAVE..."  and press ENTER.   A configuration file
  112. will be created in the current directory.   This configuration file,  along
  113. with  one  of  the included ".MSE"  files are BOTH required  in  order  for
  114. HOT.EXE to run.
  115.  
  116. ---------------
  117. (F)iles Command: - Select Music Files:
  118. ---------------
  119.  
  120. NOTE: YOU MUST "TAG" A FILE IN ORDER TO PLAY IT.  IF NO FILES ARE TAGGED IN
  121. THE FILE SELECTION WINDOW, PRESSING ENTER OR ESCAPE WILL RETURN TO THE MAIN
  122. PROGRAM SCREEN WITH NO MUSIC SELECTED.
  123.  
  124. YOU  MAY  NOT  TAG  MORE  THAN 5 FILES  IN  THE  SHAREWARE VERSION.  (The
  125. registered version supports 500+ files and allows play from a ZIP file.)
  126.  
  127. To  Tag  a  selection,   simply  use the  SPACEBAR  when  the  filename  is
  128. highlighted.  You may press the SPACEBAR again to Un-Tag the filename.  Use
  129. Ctrl + Left Arrow to Tag ALL filenames or Ctrl + Right Arrow to Un-Tag  ALL
  130. filenames.
  131.  
  132. Pressing RETURN or the RIGHT BUTTON after selecting files will  immediately
  133. begin  music play.   If you press ESCape after making a selection(s),   the
  134. selected  file(s)  will be abandoned and you will be returned to  the  main
  135. menu.
  136.  
  137. Sorting is easy,  just pick a number (as follows).   The number  represents
  138. the position of the area to sort on:
  139.  
  140.     1 = Sort by file Name.
  141.     2=  Sort by file Extension.
  142.     3 = Sort by file Size.
  143.     4 = Sort by file Date.
  144.     5 = Sort by file Time.
  145.  
  146. You  may  press ALT-R to allow the above keys to perform  a  REVERSE  sort.
  147. Press  ALT-R  and  then use any of the above sort keys (1, 2, 3,  4  or  5).
  148.  
  149. -------------
  150. COMMAND KEYS:
  151. -------------
  152.  
  153. To start HOTCAKES , simply type "HOT" and press ENTER.   After HOTCAKES has
  154. found and used the information contained in the Configuration File,  it  is
  155. ready  for  any of the following commands (press the first  letter  of  the
  156. command,    or   click  on  the  highlighted  letter   of   the   command):
  157.  
  158. Files   -  Select music file(s) to be played.  A list of eligible files will
  159.            be presented for selection.  Move the cursor (or mouse) up or down
  160.            to navigate.  Select a highlighted file by pressing the SPACEBAR.
  161.            Pressing the SPACEBAR again will Un-select it.  Press ENTER to
  162.            begin play after making your selections.
  163.  
  164.            Each different file type (MOD, S3M etc.) is displayed in a unique
  165.            color for easy visual separation which is maintained during any
  166.            sorting.
  167.  
  168. C       -  Displays a count of all music files in the current directory.
  169.  
  170. D (DOS) -  Temporarily Shell out to DOS.  (Type "EXIT" to return to HOTCAKES).
  171.            It's OK to change directories while in DOS.  HOTCAKES will know
  172.            where to find it's support files.
  173.  
  174. Q       -  Quit to DOS.
  175.  
  176.  
  177. D (DATA)-  Display available file information about the current music file.
  178.            To return to the PLAY screen after viewing the Data screen, press
  179.            "M".  If you press ESCape or "S" (Stop), music will be terminated.
  180.  
  181.            Note that the Music-Data screen will automatically be displayed
  182.            approximately half way through the current selection.
  183.  
  184. V       -  (ON or OFF) Toggle between Selection Counts and Mini-Bargraph.
  185.  
  186. M       -  Exit from Music Data screen and return to Play screen
  187.  
  188. PgUp
  189. PgDn    -  Increase, decrease or match the default music tempo.  Note that
  190.            the Tempo may take a several notes before it catches up to a
  191.            new tempo.  Rapid key presses will have unpredictable results.
  192.  
  193. Up or
  194. Down    -  ARROW KEYS: Increase or Decrease audio Volume.
  195.  
  196. Right or
  197. Left    -  ARROW KEYS: Previous or Next Music Order.
  198.  
  199. +       -  Jump to the NEXT music Pattern.
  200.  
  201. -       -  Jump to the PREVIOUS music Pattern.
  202.  
  203. E       -  RESTART current music file immediately.
  204.  
  205. B       -  Change the character used to draw the "percent completed" bargraphs.
  206.            There are several choices.  Press "B" to toggle through them.
  207.  
  208. R       -  Sets the replay flag ON or OFF.  Replay begins when the current
  209.            song ends. This is a delayed replay.  You may also use "E" for
  210.            an immediately replay.
  211.  
  212. P       -  Will temporarily Pause or Un-Pause the current music.
  213.  
  214. N       -  Abandons the current song and plays the NEXT song in the queue.
  215.  
  216. S       -  Stops the music and returns to the main screen.
  217.  
  218. Use the Up-Arrow or the Down-Arrow on the KeyPad to control the Volume.
  219.  
  220. --------
  221. PROBLEMS:
  222. --------
  223.  
  224. The shareware version of HOTCAKES will not play more than five (5) music
  225. files.  This is a planned limitation to encourage registration.
  226.  
  227. HOTCAKES   will   load  required  data  from  HOT!01.EXE   and   HOT!02.DAT
  228. "on-the-fly",   so make sure that these files are in the same directory  as
  229. HOTCAKES.EXE and your configuration files.
  230.  
  231. The minimum files required to run HOTCAKES are:
  232.  
  233.     HOT.EXE     - Executable program
  234.     HOT!01.EXE  - Support file
  235.     HOT!02.DAT  - Support file
  236.     MSE.CFG     - File created after you run CONFIG.EXE
  237.     ?.MSE       - Sound engine that supports your sound card (ie, SBPRO.MSE)
  238.                  ..and probably a music file or two.
  239.  
  240. If you experience "Out of memory" problems after selecting a mixed group of
  241. songs to play, this indicate's that not enough Conventional and/or Expanded
  242. Memory is available.  Some of your selections may play OK before this error
  243. occurs,   but larger files will cause a memory error.   When this  type  of
  244. error occurs,  it often causes the remaining files not to play even  though
  245. they  should fit into available memory.   Play will be stopped if  HOTCAKES
  246. detects 5 Out-of-memory errors.
  247.  
  248. If an "Out of memory" error occurs after changing directories from the DOS
  249. (Shell) option and attempting to play music, exit the program completely 
  250. and restart it.
  251.  
  252. --------------
  253. ERROR MESSAGES:
  254. --------------
  255.  
  256. Hopefully  you will not experience an error messages while using  HOTCAKES.
  257. But in the event that you do, here's what they mean:
  258.  
  259.  "Module is corrupt"                   - The music file is corrupt.
  260.  "Could not autodetect module type"    - Music type not supported.
  261.  "Bad format ID"                       - Similar to above
  262.  "Out of memory"                       - Conventional and/or EXPANDED memory.
  263.  "Cannot unpack samples"               - Conversion difficulties.
  264.  "AdLib samples not supported"         - Just what is says.
  265.  "Unknown Load Error:"                 - Could not determine error.
  266.  "Compressed file failure"             - PKUNZIP.EXE failed.
  267.  "No sound selected in CONFIG etc..."  - You did not run CONFIG before using
  268.                                          HOTCAKES (for the first time), or you
  269.                                          did not SAVE your selections in the
  270.                                          CONFIG program.
  271.  "Cannot find HOT???.???"              - HOTCAKES cannot run if it can't find
  272.                                          it's support files as explained above.
  273.                                          directory.
  274.  
  275. Screen  garbage  or  other  mysterious errors may  be  an  indication  that
  276. HOT!02.DAT  has  become corrupted.   Simply reload a good  copy  from  your
  277. original disk.
  278.  
  279. NOTE TO TROPEZ OWNERS:  If you experience a lack of sound, try using the
  280.                         Tropez Mixer TZACMIX (TROPEZ\DOSAPPS\TZACMIX)
  281.                         and enter the following command:
  282.  
  283.                         TZACMIX W=80 (or 100 for full volume)
  284.  
  285. Development system:     486-33, Tropez sound card, BSR 3-way speakers, Yamaha
  286.                         sub-woofer.  Programming Compiler: QuickBasic V4.5
  287.                         and the BWSB Library from Edward Schlunder.
  288.  
  289.        -------------------------------------------------------------
  290.        Comments or problems? My direct FAX number is (516)-538-2633.
  291.        -------------------------------------------------------------
  292.                     Internet:  melvin.douglas@execnet.com
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.