home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / SOUND / MISC / ADMENU.ZIP / ADMENU.DOC next >
Encoding:
Text File  |  1990-08-11  |  7.6 KB  |  229 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                          AdLib ZIP Menu Version 1.0
  22.  
  23.                           Released August 11, 1990
  24.  
  25.  
  26.  
  27.                      Written by Keith Ledbetter
  28.                                 4240 Ketcham Drive
  29.                                 Chesterfield, VA  23832
  30.                                 (804) 674-0780
  31.                                 (6:00pm - 10:00pm Eastern Time)
  32.  
  33.  
  34.                     Electronic mail on      GEnie: ORION.MICRO
  35.                                        CompuServe: 72240,1221
  36.  
  37.  
  38.           Program and Documentation Copyright 1990 by Keith Ledbetter.
  39.                              All rights reserved.
  40.  
  41.       Portions Copyright Borland, International.   Written in Turbo C v2.0.
  42.  
  43.  
  44.                                  AdMenu v1.0                          Page 1
  45.  
  46.  
  47. Introduction
  48.  
  49.  
  50.  
  51.  
  52.     Thank you for taking the time to try out AdMenu v1.0.  I just recently
  53. purchased an Adlib Music card, and I couldn't believe how quickly I ate up
  54. disk space with various song files (".ROL" files).  In just the first week
  55. after purchasing the Adlib card, I had 496 song files eating up over 4 MB
  56. of precious space on my hard drive.
  57.  
  58.  
  59.     So, one day I got to thinking (yes, I know how dangerous that is!) ...
  60. "Hmmm...wouldn't it be great if there was some way for me to ZIP down all of
  61. these song files, yet still play them quickly and painlessly?".
  62.  
  63.  
  64.     And (surprise, surprise), AdMenu was my answer to my own needs.  AdMenu
  65. allows you to ZIP down all of your .ROL files into one ZIP file, yet still
  66. play them from AdMenu's powerful menu system.   AdMenu will present you with
  67. a scrollable menu of each file within your song ZIP file, which you can
  68. easily play at the touch of a button.   AdMenu also supports (but does not
  69. require) a Microsoft compatible mouse.   AdMenu will support up to 2,048
  70. files within a single ZIP file.  If you have more files than this, simply
  71. create multiple ZIP files and tell AdMenu through the command line parameter
  72. which one you want to use.
  73.  
  74.  
  75.     AdMenu doesn't do all of the work itself, so the following two programs
  76. are REQUIRED to use AdMenu:  PLAYROL.EXE and PKUNZIP.EXE.  Both of these
  77. programs are readily available on both GEnie and CompuServe.
  78.  
  79.  
  80.  
  81.                                  AdMenu v1.0                          Page 2
  82.  
  83.  
  84. How It Works
  85.  
  86.  
  87.  
  88.  
  89.  
  90.     AdMenu works hand-in-hand with two other programs which you must have
  91. somewhere in your PATH chain.  When AdMenu boots up, it reads all of the
  92. ".ROL" filenames present in the ZIP file that you told it to use.  It will
  93. then present you with a menu from which you can select song(s) to be played.
  94. When you select a song, AdMenu does the following steps:
  95.  
  96.           o   It creates a temporary directory on drive C:\.
  97.               (See below if you need to change it to another drive).
  98.  
  99.           o   It calls PKUNZIP to extract the file selected into the
  100.               temporary directory just created.
  101.  
  102.           o   It calls PLAYROL.EXE to play the song just extracted.
  103.  
  104.           o   It deletes the extracted file and the temporary directory.
  105.  
  106.     You must make sure that both PKUNZIP.EXE and PLAYROL.EXE are somewhere in
  107. your PATH.   Just to make sure, AdMenu checks this for you when it's first
  108. invoked, and will refuse to run if these programs aren't found.   Also, AdMenu
  109. DOES NOT load SOUND.COM for you; you must make sure that your sound driver is
  110. installed before running AdMenu.
  111.  
  112.  
  113.     If you would prefer that AdMenu create the temporary files on a drive
  114. other than drive C:, you can set an environment variable named AD_DRIVE.  For
  115. example, to tell AdMenu to use drive D: instead of drive C:, you would do the
  116. following:
  117.  
  118.                     "set ad_drive=D"
  119.  
  120. The easiest way to do this is to put the above command into your AUTOEXEC.BAT
  121. file, so it will always get set at bootup time.
  122.  
  123.  
  124.                                  AdMenu v1.0                          Page 3
  125.  
  126.  
  127. Setting It Up and Running It
  128.  
  129.  
  130.  
  131.     OK, enough of that boring stuff.  Let's get our ZIP file set up and try
  132. AdMenu out.   In this example, we will assume that:
  133.  
  134.                  (a) all of your .ROL files are in a subdirectory
  135.                      named C:\ADLIB\SONGS.
  136.  
  137.                  (b) that your STANDARD.BNK file is in C:\ADLIB.
  138.  
  139.  
  140.     First, you would change to your C:\ADLIB\SONGS subdirectory and enter in
  141. the following command:
  142.  
  143.                        "pkzip -m Songs.Zip *.rol"
  144.  
  145.     This command will create a ZIP file named SONGS.ZIP, and will move each
  146. .ROL file into the ZIP file and then delete them.   Go ahead and execute this
  147. command......there, that should have freed up TONS of disk space!
  148.  
  149.  
  150.     Now, make sure that your SOUND.COM sound driver is installed, and then
  151. simply invoke AdMenu with the following command:
  152.  
  153.  
  154.             "AdMenu c:\adlib\songs\songs.zip c:\adlib\standard.bnk"
  155.  
  156.  
  157.     With this command line, you have told AdMenu that (a) your song ZIP file
  158. is named "c:\adlib\songs\songs.zip", and that you want to use the bank file
  159. named "c:\adlib\standard.bnk".  If you have PKUNZIP and PLAYROL in your PATH
  160. directories, then AdMenu will proceed to load in the filenames from your ZIP
  161. file and present you with a menu of each song available.
  162.  
  163.  
  164.                                  AdMenu v1.0                          Page 4
  165.  
  166.  
  167. Working With the Menu
  168.  
  169.  
  170.  
  171.  
  172.      You should now be looking at AdMenu's main menu.   You will notice a
  173. scroll box in the middle of the screen with the different song names in it.
  174. You can scroll up and down these names with either of the following ways:
  175.  
  176.               o   The up and down cursor keys
  177.               o   The PgUp and PgDn keys
  178.               o   Clicking on the scroll-bar arrows
  179.               o   Clicking on the PgUp or PgDn boxes
  180.  
  181.      The song name that is highlighted in red is the current song that you
  182. wish to act on.   You can do the following:
  183.  
  184.  
  185.               o   Press <Return>, <P>, click the left mouse button, or
  186.                   click on the Play box to play this one song.
  187.  
  188.               o   Press <M>, click the right button, or click on the
  189.                   Mark box to mark this song for playing.
  190.  
  191.               o   Press <A> or click on the Play All Marked box to play
  192.                   all songs that you have marked (this option will only
  193.                   be available if you have at least one song marked).
  194.  
  195.  
  196.      If you are playing "All marked songs", you will be given roughly ten
  197. seconds at the end of each song to abort the playing.  If you don't press a
  198. key within this time, the program will continue on playing the next song.
  199.  
  200.                                  AdMenu v1.0                          Page 5
  201.  
  202.  
  203. That's All, Folks!
  204.  
  205.  
  206.  
  207.  
  208.      That's about it for AdMenu.  I think the program is pretty easy to
  209. catch on to, so I'm not going to go on with page after page of documentation.
  210. While this program is copyrighted by me, it may be distributed freely by any
  211. individual or club as long as no more than $2 is charged for the service.
  212.  
  213.  
  214.      If you have any comments about this program, or have specific things that
  215. you'd like to see added to it, please drop me a line at any of the places
  216. mentioned on the first page of this document.
  217.  
  218.  
  219.      If you feel that you'd like to contribute some money for this program,
  220. it would be graciously accepted.  You can mail it to the address given on the
  221. first page.   If you don't send money, at least drop me some Email and let me
  222. know that you are using the program and benefitting from it (if you're not
  223. benefitting from it, tell me why so I can fix it!).
  224.  
  225.  
  226.                                            Enjoy!
  227.  
  228.                                            Keith Ledbetter
  229.