home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / SOUND / MISC / ADMENU20.ZIP / ADMENU.DOC next >
Encoding:
Text File  |  1990-09-16  |  9.8 KB  |  283 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 2.0
  22.  
  23.                           Released Sept. 16, 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 v2.0                          Page 1
  45.  
  46.  
  47. Revision History
  48.  
  49.  
  50.  
  51.          Version         Changes made
  52.          -------      --------------------
  53.            1.0        Initial release.
  54.  
  55.            1.1        Minor cosmetic changes.
  56.  
  57.            1.2        - Major cosmetic changes were made to the display.
  58.  
  59.                       - Added a "find" function to search for partial
  60.                         text in the song names.
  61.  
  62.                       - Pressing ALT + a letter (ie: ALT-B) takes you to
  63.                         the first song whose name begins with that letter
  64.                         (or, the next letter if no songs exist starting
  65.                         with the specified letter).
  66.  
  67.            2.0        - "ZIP comments" are now used (instead of the file
  68.                         name) as a way to give more meaningful titles to
  69.                         your songs.  If no comment is in the ZIP file for
  70.                         a given song, that file's name will appear as the
  71.                         title.  The maximum length of each comment is 25
  72.                         characters.
  73.  
  74.                       - Loading of the ZIP file is now about 80% faster.
  75.  
  76.                       - Maximum number of songs per ZIP file was reduced
  77.                         from 2048 to 1024, due to the overhead of allowing
  78.                         longer song names (25 characters instead of 8).
  79.  
  80.                       - Added an "Edit" button so that you can easily
  81.                         add comments (longer song titles) to your ZIP
  82.                         file.  PKZIP will be spawned to add each title.
  83.                         If you're doing lots of comment editing, it'll
  84.                         probably be a lot faster to do it yourself with
  85.                         PKZIP, as in:
  86.  
  87.                              C:> pkzip -c songs.zip b*.rol
  88.  
  89.                         which will allow you to add comments to all of
  90.                         your B*.ROL files in one shot.
  91.  
  92.                       - Added a "Sort song names" function, mostly to
  93.                         be used after you've "E"dited a bunch of song
  94.                         names.
  95.  
  96.  
  97.  
  98.                                  AdMenu v2.0                          Page 2
  99.  
  100.  
  101. Introduction
  102.  
  103.  
  104.  
  105.  
  106.     Thank you for taking the time to try out AdMenu v2.0.  I just recently
  107. purchased an Adlib Music card, and I couldn't believe how quickly I ate up
  108. disk space with various song files (".ROL" files).  In just the first week
  109. after purchasing the Adlib card, I had 496 song files eating up over 4 MB
  110. of precious space on my hard drive.
  111.  
  112.  
  113.     So, one day I got to thinking (yes, I know how dangerous that is!) ...
  114. "Hmmm...wouldn't it be great if there was some way for me to ZIP down all of
  115. these song files, yet still play them quickly and painlessly?".
  116.  
  117.  
  118.     And (surprise, surprise), AdMenu was my answer to my own needs.  AdMenu
  119. allows you to ZIP down all of your .ROL files into one ZIP file, yet still
  120. play them from AdMenu's powerful menu system.   AdMenu will present you with
  121. a scrollable menu of each file within your song ZIP file, which you can
  122. easily play at the touch of a button.   AdMenu also supports (but does not
  123. require) a Microsoft compatible mouse.   AdMenu will support up to 2,048
  124. files within a single ZIP file.  If you have more files than this, simply
  125. create multiple ZIP files and tell AdMenu through the command line parameter
  126. which one you want to use.
  127.  
  128.  
  129.     AdMenu doesn't do all of the work itself, so the following two programs
  130. are REQUIRED to use AdMenu:  PLAYROL.EXE and PKUNZIP.EXE.  Both of these
  131. programs are readily available on both GEnie and CompuServe.
  132.  
  133.  
  134.  
  135.                                  AdMenu v2.0                          Page 3
  136.  
  137.  
  138. How It Works
  139.  
  140.  
  141.  
  142.  
  143.  
  144.     AdMenu works hand-in-hand with two other programs which you must have
  145. somewhere in your PATH chain.  When AdMenu boots up, it reads all of the
  146. ".ROL" filenames present in the ZIP file that you told it to use.  It will
  147. then present you with a menu from which you can select song(s) to be played.
  148. When you select a song, AdMenu does the following steps:
  149.  
  150.           o   It creates a temporary directory on drive C:\.
  151.               (See below if you need to change it to another drive).
  152.  
  153.           o   It calls PKUNZIP to extract the file selected into the
  154.               temporary directory just created.
  155.  
  156.           o   It calls PLAYROL.EXE to play the song just extracted.
  157.  
  158.           o   It deletes the extracted file and the temporary directory.
  159.  
  160.     You must make sure that both PKUNZIP.EXE and PLAYROL.EXE are somewhere in
  161. your PATH.   Just to make sure, AdMenu checks this for you when it's first
  162. invoked, and will refuse to run if these programs aren't found.   Also, AdMenu
  163. DOES NOT load SOUND.COM for you; you must make sure that your sound driver is
  164. installed before running AdMenu.
  165.  
  166.  
  167.     If you would prefer that AdMenu create the temporary files on a drive
  168. other than drive C:, you can set an environment variable named AD_DRIVE.  For
  169. example, to tell AdMenu to use drive D: instead of drive C:, you would do the
  170. following:
  171.  
  172.                     "set ad_drive=D"
  173.  
  174. The easiest way to do this is to put the above command into your AUTOEXEC.BAT
  175. file, so it will always get set at bootup time.
  176.  
  177.  
  178.                                  AdMenu v2.0                          Page 4
  179.  
  180.  
  181. Setting It Up and Running It
  182.  
  183.  
  184.  
  185.     OK, enough of that boring stuff.  Let's get our ZIP file set up and try
  186. AdMenu out.   In this example, we will assume that:
  187.  
  188.                  (a) all of your .ROL files are in a subdirectory
  189.                      named C:\ADLIB\SONGS.
  190.  
  191.                  (b) that your STANDARD.BNK file is in C:\ADLIB.
  192.  
  193.  
  194.     First, you would change to your C:\ADLIB\SONGS subdirectory and enter in
  195. the following command:
  196.  
  197.                        "pkzip -m Songs.Zip *.rol"
  198.  
  199.     This command will create a ZIP file named SONGS.ZIP, and will move each
  200. .ROL file into the ZIP file and then delete them.   Go ahead and execute this
  201. command......there, that should have freed up TONS of disk space!
  202.  
  203.  
  204.     Now, make sure that your SOUND.COM sound driver is installed, and then
  205. simply invoke AdMenu with the following command:
  206.  
  207.  
  208.             "AdMenu c:\adlib\songs\songs.zip c:\adlib\standard.bnk"
  209.  
  210.  
  211.     With this command line, you have told AdMenu that (a) your song ZIP file
  212. is named "c:\adlib\songs\songs.zip", and that you want to use the bank file
  213. named "c:\adlib\standard.bnk".  If you have PKUNZIP and PLAYROL in your PATH
  214. directories, then AdMenu will proceed to load in the filenames from your ZIP
  215. file and present you with a menu of each song available.
  216.  
  217.  
  218.                                  AdMenu v2.0                          Page 5
  219.  
  220.  
  221. Working With the Menu
  222.  
  223.  
  224.  
  225.  
  226.      You should now be looking at AdMenu's main menu.   You will notice a
  227. scroll box in the middle of the screen with the different song names in it.
  228. You can scroll up and down these names with either of the following ways:
  229.  
  230.               o   The up and down cursor keys
  231.               o   The PgUp and PgDn keys
  232.               o   Clicking on the scroll-bar arrows
  233.               o   Clicking on the PgUp or PgDn boxes
  234.  
  235.      The song name that is highlighted in red is the current song that you
  236. wish to act on.   You can do the following:
  237.  
  238.  
  239.               o   Press <Return>, <P>, click the left mouse button, or
  240.                   click on the Play box to play this one song.
  241.  
  242.               o   Press <M>, click the right button, or click on the
  243.                   Mark box to mark this song for playing.
  244.  
  245.               o   Press <A> or click on the Play All Marked box to play
  246.                   all songs that you have marked (this option will only
  247.                   be available if you have at least one song marked).
  248.  
  249.  
  250.      If you are playing "All marked songs", you will be given roughly ten
  251. seconds at the end of each song to abort the playing.  If you don't press a
  252. key within this time, the program will continue on playing the next song.
  253.  
  254.                                  AdMenu v2.0                          Page 6
  255.  
  256.  
  257. That's All, Folks!
  258.  
  259.  
  260.  
  261.  
  262.      That's about it for AdMenu.  I think the program is pretty easy to
  263. catch on to, so I'm not going to go on with page after page of documentation.
  264. While this program is copyrighted by me, it may be distributed freely by any
  265. individual or club as long as no more than $2 is charged for the service.
  266.  
  267.  
  268.      If you have any comments about this program, or have specific things that
  269. you'd like to see added to it, please drop me a line at any of the places
  270. mentioned on the first page of this document.
  271.  
  272.  
  273.      If you feel that you'd like to contribute some money for this program,
  274. it would be graciously accepted.  You can mail it to the address given on the
  275. first page.   If you don't send money, at least drop me some Email and let me
  276. know that you are using the program and benefitting from it (if you're not
  277. benefitting from it, tell me why so I can fix it!).
  278.  
  279.  
  280.                                            Enjoy!
  281.  
  282.                                            Keith Ledbetter
  283.