home *** CD-ROM | disk | FTP | other *** search
/ Chip: Special Sound & MIDI / Chip-Special_Sound-und-Midi-auf-dem-PC.bin / dostools / cdbox / cd-box.doc < prev    next >
Text File  |  1993-01-16  |  87KB  |  1,826 lines
  1. ╒════════════════════════════════════════════════════════════════════════════╕
  2. │              Welcome to CD-Box v2.20 - (C) Jeffrey Belt, 1992              │
  3. ├────────────────────────────────────────────────────────────────────────────┤
  4. │ .CMF/.MDI/.MOD/.MUS/.ROL/.VOC/.WAV player & shell for AdLib/SB - Shareware │
  5. ╘════════════════════════════════════════════════════════════════════════════╛
  6. Quick start:
  7.  
  8.   0. You must have a VGA display (color) and an Adlib or SoundBlaster card (or
  9.        better) - a hard disk and a mouse are also highly recommended.
  10.  
  11.   1. Create a directory in which you put all CD-BOX.* files, and every music
  12.        file (.CMF, .MDI, .MOD, .MUS, .ROL, .VOC and .WAV) you can find, either
  13.        as is or stored in .ARC, .ARJ and/or .ZIP files. Also make sure
  14.        SBFMDRV.COM, SOUND.COM, PLAY.EXE, SPUTROL.COM or INTUNE.EXE,
  15.        CT-VOICE.DRV, PLAYFILE.EXE, ARCE.COM, ARJ.EXE and PKUNZIP.EXE (if you
  16.        don't have them all, do the best you can) are on the PATH (or the SOUND
  17.        environment variable) somewhere.
  18.  
  19.   2. Type CD-BOX and press Enter (the first time CD-Box is run, the directory
  20.        scan may take a looooong time, especially if you have many songs - be
  21.        patient, it will go much faster the second time).
  22.  
  23.   3. Fool around and see what CD-Box can do.
  24.  
  25. If you have trouble, see part V, troubleshooting.
  26.  
  27. If you have players others than those listed above, check out part VI.
  28.  
  29. If you use CD-Box, you have to register it; see part VIII (at the end).
  30.  
  31. If you want more details:
  32.  
  33.   * Type CD-BOX/? at the DOS prompt
  34.  
  35.   * Read the rest of this document!
  36.  
  37. ══════════════════════════════════════════════════════════════════════════════
  38. Acknowledgments
  39.  
  40.    AdLib Music Synthetizer Card is a registered trademark of AdLib, Inc. Also,
  41.      SOUND.COM is copyrighted by AdLib, Inc.
  42.  
  43.    SoundBlaster is a registered trademark of Creative Labs, Inc. Also,
  44.      SBFMDRV.COM and VPLAY.EXE are copyrighted by Creative Labs, Inc.
  45.  
  46.    ARCE is copyrighted by Vernon D. Buerg.
  47.    ARJ is copyrighted by Robert K Jung.
  48.    PKUNZIP is copyrighted by PKWARE, Inc.
  49.  
  50. ──────────────────────────────────────────────────────────────────────────────
  51. CD-Box supports by default the following drivers/players (you are free to
  52.   change this by reading part IV and editing the CD-BOX.CFG file):
  53.  
  54. .CMF driver: SBFMDRV.COM - Creative Labs, Inc.
  55.              Bundled with the SoundBlaster card
  56.  
  57. .ROL driver: SOUND.COM - AdLib, Inc.
  58.              Bundled with the AdLib Music Synthetizer card
  59.  
  60. .ROL player: Sputter's .ROL player (SPUTROL.COM) - Adrienne Cousins/Versaware
  61.              Part of the Sputter package (SPUT115A.ZIP)
  62.              Shareware, $25
  63.  
  64. .MUS player: PLAY.EXE
  65.              No info on this one - I got it from a FTP server somewhere which
  66.                IT got from THE TASTE/MG BBS, 718-252-4529, as ADLIBMUS.ZIP.
  67.  
  68. .VOC driver: CT-VOICE.DRV - Creative Labs, Inc.
  69.              Bundled with the SoundBlaster card
  70.  
  71. .WAV player: PLAYFILE.EXE - works on the PAS-16 only (as far as I know)
  72.              Bundled with the Pro Audio Spectrum
  73.  
  74. ──────────────────────────────────────────────────────────────────────────────
  75. Other drivers/players I have found that also work with CD-Box:
  76.  
  77. .ROL driver: SB-SOUND.COM - Creative Labs, Inc.
  78.              Almost no info on this one
  79.  
  80. .ROL player: InTune v2.50 (INTUNE.EXE) - Doug Brandon
  81.              (I did have a few problem with intruments but...)
  82.              Shareware, $20
  83.  
  84. .VOC player: Creative Disk Voice Playback (VPLAY.EXE) - Creative Labs, Inc.
  85.              Bundled with the SoundBlaster card
  86.  
  87. ──────────────────────────────────────────────────────────────────────────────
  88. Drivers/players I have found that don't work with CD-Box:
  89.  
  90. .ROL player: AdLib Command Line .ROL Player 1.2 (PLAYROL.EXE) - Tracy Harton
  91.              It switches to text mode!
  92.              "Relaxed" shareware
  93.  
  94. .WAV player: PLANY v0.9 - Bill Neisius
  95.              Plays .WAV too slowly on my SB... or is it only me?
  96.              Freeware
  97.  
  98. FTP addresses: saffron.inset.com, nic.funet.fi, snake.mcs.kent.edu
  99.  
  100. ══════════════════════════════════════════════════════════════════════════════
  101.  
  102.                            TABLE OF CONTENTS
  103.  
  104. ══════════════════════════════════════════════════════════════════════════════
  105.  
  106.            Part I:    How to use CD-Box
  107.            Part II:   How CD-Box works
  108.                         (including exactly which drivers/players are needed,
  109.                          some FTP addresses, how CD-Box interacts with
  110.                          them...)
  111.            Part III:  Keyboard support
  112.            Part IV:   CD-BOX.CFG, CD-Box's configuration file
  113.            Part V:    Trouble-shooting
  114.            Part VI:   Version history, how you can help, and thanks
  115.            Part VII:  License & absence of warranty
  116.            Part VIII: Registering CD-Box
  117.  
  118. ══════════════════════════════════════════════════════════════════════════════
  119. Compatibility
  120.  
  121. CD-BOX v2.20 IS FULLY COMPATIBLE WITH ALL VERSIONS OF CD-BOX ABOVE 2.00. You
  122.   can overwrite the old CD-Box files with the new ones, provided the old
  123.   version is v2.00, v2.01, v2.02, v2.10 v2.11 or v2.12. If you're one of those
  124.   who still have CD-Box v1.61 or below, CD-Box will ask you to delete the
  125.   SONGS.DAT file.
  126.  
  127. ══════════════════════════════════════════════════════════════════════════════
  128.  
  129.                         PART I: HOW TO USE CD-BOX
  130.  
  131. ══════════════════════════════════════════════════════════════════════════════
  132. *** What does CD-Box do?
  133. ──────────────────────────────────────────────────────────────────────────────
  134.  
  135. CD-Box is, stated simply, a program which plays back music files on the AdLib
  136.   Music Synthetizer Card and the SoundBlaster card. However, it is also very
  137.   pretty and fun to use - it runs in 256 colors and can use your mouse.
  138.  
  139. CD-Box's main features:
  140.  
  141.   - A pretty interface and fun animation - CDs pop up and down and start and
  142.       stop spinning, pages scroll... including random events I'll let you
  143.       discover!
  144.  
  145.   - Support for .CMF, .MDI, .MOD, .MUS, .ROL, .VOC and .WAV music/sound files 
  146.       (.CMF, .MOD, .VOC and .WAV files work with SoundBlaster only). These 
  147.       files can also be stored in .ARC, .ARJ and/or .ZIP files to save disk
  148.       space - CD-Box will find them and play them from the archive (using a
  149.       RAM drive if you want). .MOD also have volume control and skipping
  150.       backward and forward within the song.
  151.  
  152.   - CD-Box allows you to easily program a selection of songs; it waits for you
  153.       to select the songs you want to hear before starting to play the first
  154.       one.
  155.  
  156.   - Instead of selecting songs, you can tell CD-Box how long you want the
  157.       playback to last, and it will automatically select songs for you.  You
  158.       can even do that from the DOS command line (or a batch file), and CD-Box
  159.       will play the songs, then exit right back to DOS.
  160.  
  161.   - CD-Box makes it easy to choose files in which to pick songs - so if you
  162.       ARJed or ZIPped your songs by category, you can tell CD-Box which
  163.       categories to use!
  164.  
  165.   - No data file to keep to date; bank filenames and song titles can be
  166.       modified directly from CD-Box, which will save your changes to disk.
  167.       CD-Box also knows the titles and lengths of numerous songs, and when it
  168.       encounters unknown songs, can sometimes (it depends on the format)
  169.       extract data from the files on disk.
  170.  
  171.   - CD-Box is able to examine the SOUND environnment variable and of loading
  172.       drivers and player programs from there if necessary (as any good
  173.       SoundBlaster software should do).
  174.  
  175.  
  176. ──────────────────────────────────────────────────────────────────────────────
  177. And now, the fun part: how CD-Box works
  178.  
  179. Note that the explanations below, as with most of this documentation, supposes
  180.   you have a mouse and CD-Box is able to use it. If you use the keyboard, see
  181.   part III for mouse equivalents.
  182.  
  183. You run it by typing CD-BOX at the DOS prompt. Obvious, really. You are then
  184.   in...
  185.  
  186. ══════════════════════════════════════════════════════════════════════════════
  187. *** SELECT MODE: to select and play songs
  188. ──────────────────────────────────────────────────────────────────────────────
  189.  
  190.   - Move between the pages by clicking on the "Rewind" and "Forward" buttons 
  191.       (you can hold down these buttons with the mouse). Pressing the RIGHT
  192.       mouse button on "Rewind" and "Forward" brings you to the first and last
  193.       page, respectively.
  194.  
  195.   - Select one or more songs to play by clicking on the small button next to
  196.       the songs' names; they will be played back in the order you selected
  197.       them. The digital display changes color and displays the total length
  198.       time of your selection.
  199.  
  200.   - Click on "Loop" if you want your selection to be played over and over
  201.       again.
  202.  
  203.   - Click on "Play" to play the songs - you'll be in Play mode (see below).
  204.  
  205.   - Clicking on "Random" brings you into Random mode. You can then select the 
  206.       total playing time you wish, by pressing the "Rewind" and "Forward" 
  207.       buttons; pressing the RIGHT mouse button brings up the minimum and 
  208.       maximum playing time, respectively. Once the desired time is displayed
  209.       on the digital display, click on "Play". CD-Box will randomly select
  210.       additional songs until the desired time is reached, then play the songs.
  211.  
  212. ****************************************************************************** 
  213.  NOTE: Certain songs may be of unknown length (they were not known to CD-Box 
  214.  and they have never been played yet). When such a song is selected, CD-Box 
  215.  supposes the length is zero. Therefore, if you use the "Random" button and 
  216.  suchs songs are chosen, the actual playing time may be far longer than the 
  217.  playing time you entered (remember in such cases that Esc still works). Of 
  218.  course a way to compute all playing times is to use Random mode and choose 
  219.  the maximum playing time, in which case all songs will be played.
  220. ******************************************************************************
  221.  
  222.   - Clicking on "Random" while in Random mode, exits Random mode.
  223.  
  224.   - Clicking on the wide "Unselect" button will unselect ALL the songs.
  225.  
  226.   - Finally, click on "Eject" to quit.
  227.  
  228.  
  229. ══════════════════════════════════════════════════════════════════════════════
  230. *** PLAY MODE: while songs are being played back
  231. ──────────────────────────────────────────────────────────────────────────────
  232.  
  233.   - Each song is played in turn, and then de-selected, unless "Loop" is in the
  234.       down position, in which case they are reselected to be played again
  235.       later.
  236.  
  237.   - Pressing Esc while a song is playing interrupts the current song, and
  238.       CD-Box starts looking for the next one. If you press Esc between songs,
  239.       playback stops entirely (songs not yet played remain selected). You've
  240.       got to press Esc twice quite fast to stop the playback in fast mode (/F,
  241.       see below).
  242.  
  243. If the buttons have flipped to reveal another set of buttons, you also have 
  244.   access to the real-time clock and the following functions (.CMF, .MOD and 
  245.   .VOC for registered users):
  246.  
  247.   - Stop: stops playback entirely (same as pressing Esc between songs).
  248.  
  249.   - Skip: interrupts the current song (same as pressing Esc while playing).
  250.  
  251.   - Pause/Resume: toggle it once to pause the music, and toggle it again to
  252.       have it pick up where it left off.
  253.  
  254.   - Rem.: if pressed, the digital display shows the time left until the song
  255.       or the total selection ends (see next button), as far as CD-Box can
  256.       tell; if not, the digital display shows the time elapsed since the
  257.       beginning of the song or the total selection.
  258.  
  259.   - Total: if pressed, the digital display shows the time elapsed or left (see
  260.       previous button) for the current song; if not, it shows the time elapsed
  261.       or left for the whole selection. Got it?
  262.  
  263.   Registered version only and .MOD files only:
  264.  
  265.   - Volume control: press a button in the colored row to select the volume.
  266.       Volumes changes are not instantaneous (some .MOD files sometimes sound
  267.       weird while the volume is being changed). The higher the volume, the
  268.       better the quality.
  269.  
  270.   - Skipping backward/forward within the song: press the button to the left of
  271.       the volume control or the one to the right. CD-Box will "skip" a little
  272.       of the song in either way. Trying to skip back the beginning of the song
  273.       restarts the song, and trying to skip past the end stops it.
  274.  
  275. Play mode switches back to Select mode when playback ends (whether you
  276.   interrupted it or not).
  277.  
  278.  
  279. ══════════════════════════════════════════════════════════════════════════════
  280. *** MODIFY MODE: used to modify bank files and song titles
  281. ──────────────────────────────────────────────────────────────────────────────
  282.  
  283. Click on the wide "Modify..." button to enter Modify mode. All the songs will 
  284.   be unselected, and the row of buttons will flip and reveal another set of 
  285.   buttons. "Rewind" and "Forward" work the same as before.
  286.  
  287.   - You can display the song titles, bank files or filename by clicking on one
  288.       of the three buttons at the right.
  289.  
  290.   - If you click on the small button next to a song, a dot cursor will appear
  291.       and you will be able to modify whatever is displayed, using the keyboard
  292.       (Backspace, Enter and Escape do the ovious things). Any changes you type
  293.       in will be automatically saved to disk once you exit CD-Box.
  294.  
  295.  
  296. ══════════════════════════════════════════════════════════════════════════════
  297. *** GOTO MODE: used to jump to a specific title (or filename, see Files mode)
  298. ──────────────────────────────────────────────────────────────────────────────
  299.  
  300. Click on "Goto...", and an alphabetic set of buttons will appear. From there,
  301.   simply choose a letter, and CD-Box will "Rewind" or "Forward" directly to
  302.   the page containing the first song starting by the letter you selected, and
  303.   flash that song briefly. If no such song exists, CD-Box tries with the next
  304.   letter, and the next, and may finally give up by giving an error message.
  305.  
  306. When you exit Goto mode, either automatically, or by clicking on "Goto..." a 
  307.   second time, you will be brought back to the same mode you were in before
  308.   entering Goto mode. Goto is accessible from all modes.
  309.  
  310.  
  311. ══════════════════════════════════════════════════════════════════════════════
  312. *** FILES MODE: to (un)tag files for scanning
  313. ──────────────────────────────────────────────────────────────────────────────
  314.  
  315. Click on "Files...", and CD-Box will save any changes you have made (bank
  316.   files, song titles, whatever), and promptly forget all the songs in memory.
  317.   Files names will then be displayed instead of song titles. These files are
  318.   NOT the song files themselves, but the files CD-Box scanned to get the songs
  319.   in memory - the difference is that archive files (.ARC, .ARJ and .ZIP) will
  320.   be displayed as such, instead of having a separate entry for each file in
  321.   the archive (as is the case in Modify mode when the "File" button is
  322.   pressed).
  323.  
  324. All files are selected by default. You can browse through the list using
  325.   "Rewind" and "Forward" as usual, and "Goto..." a specific filename... and
  326.   when you click on "Rescan", CD-Box will rescan ONLY the files left selected.
  327.   Thus, if you left all the files selected, CD-Box will reload all the songs
  328.   and nothing will be changed. If you unselected them all, CD-Box will load no
  329.   songs.
  330.  
  331. This serves as a "filter" for the songs displayed in CD-Box, and used by (for 
  332.   instance) Random mode. If your songs are archived by category, switching to 
  333.   Files mode and choosing only certain files will tell CD-Box to display and
  334.   use only the songs in these categories. If you don't use archives at all,
  335.   then probably Files mode will not be of much use to you.
  336.  
  337. Note that the files displayed are not all the files in the directory, but
  338.   rather those that contain songs. Also, if you specified /L at startup, any
  339.   unplayable files in the directory will not be displayed. And, if you
  340.   specified file specifications at startup (for instance, CD-BOX *.MOD
  341.   Z*.ZIP), only the files matching these specifications will be displayed.
  342.   All this is cumulative, of course. The command line serves as a first
  343.   filter, and Files mode then enables you to choose the filtered files by
  344.   hand.
  345.  
  346. Files mode is much simpler to use than to describe, believe me... try it!
  347.  
  348.  
  349. ══════════════════════════════════════════════════════════════════════════════
  350. *** DEBUG MODE: to have a quick look at CD-Box's startup
  351. ──────────────────────────────────────────────────────────────────────────────
  352.  
  353. This is not really a mode in the sense of those described above, but is a
  354.   command-line parameter important enough to be included here. Typing CD-BOX/D
  355.   at the DOS prompt:
  356.  
  357.   * returns the registration number (if any!);
  358.  
  359.   * checks the CD-BOX.CFG file for errors, reporting any, so that you can
  360.       correct them;
  361.  
  362.   * displays, for each driver, player, and archive manager, whether it was
  363.       found or not;
  364.  
  365.   * scans the directory for songs, displaying each song name in turn, so that
  366.       you may find which song exactly makes CD-Box crash (if any).
  367.  
  368.  
  369. ══════════════════════════════════════════════════════════════════════════════
  370.  
  371.                         PART II: GENERAL QUESTIONS
  372.  
  373. ══════════════════════════════════════════════════════════════════════════════
  374. *** How does CD-Box play songs?
  375. ──────────────────────────────────────────────────────────────────────────────
  376.  
  377. It depends on the format. As a general rule, there are two possibilities:
  378.   either it plays them by itself, using its own code (internal support),
  379.   or it doesn't know how to play this format, and executes an external program
  380.   (the player), specific to each format. CD-Box currently provides internal
  381.   support for .CMF, .MOD and .VOC.
  382.  
  383. In greater detail, for each format, CD-Box follows these rules:
  384.  
  385.   * If there is a section about this format in CD-BOX.CFG ([<format>]), then
  386.       CD-Box will provide external support, and:
  387.  
  388.       * If there is a "Dual=yes" statement in the section, and CD-Box has
  389.           internal support for this format, then CD-Box will first try playing
  390.           such songs using its own routines, and, if this fails (error while
  391.           loading or whatever), use the external player.
  392.  
  393.       * If there is no such statement in the section, then CD-Box will ALWAYS
  394.           use this player to play the song, using the parameters given in
  395.           CD-BOX.CFG.
  396.  
  397.   * If there is no section on this format in CD-BOX.CFG, then CD-Box will use
  398.       its internal routines to play the song, if any. CD-Box currently
  399.       provides internal support for .CMF, .MOD and .VOC files.
  400.  
  401.   * In all other cases, CD-Box will NOT play songs of this format (the
  402.       corresponding pilot light above the song names is grayed).
  403.  
  404. Usually you'll want CD-Box to play songs by itself; it's by far the easiest
  405.   way, there's no player to install, and you can pause, resume and stop the
  406.   song using the mouse. However, you would use an external player if:
  407.  
  408.   * CD-Box provides no internal support for the corresponding format
  409.  
  410.   * Or the sound given by the player you have is better than that of CD-Box,
  411.       or the player supports a wider range of capabilities (what if you've got
  412.       the AdLib and have a player which can play .CMF on your card?), so you
  413.       might want to override CD-Box's routines for that format.
  414.  
  415. Note that even if CD-Box does have internal support for some formats, it may
  416.   still need the corresponding driver. See right below for details.
  417.  
  418. CD-BOX.CFG, CD-Box's configuration file, is explained in part IV.
  419.  
  420.  
  421. ══════════════════════════════════════════════════════════════════════════════
  422. *** Exactly what programs do I need for each song format?
  423. ──────────────────────────────────────────────────────────────────────────────
  424.  
  425. In addition to CD-BOX.EXE (the program) and CD-BOX.CFG (the configuration 
  426.   file), you need songs to play, and a player program in some cases. The
  427.   default (you can change that, see part IV for details) music playback 
  428.   programs supported by CD-Box and the corresponding song formats are:
  429.  
  430.     ┌───────────────┐
  431.     │ .ARC archives │ All formats
  432.     └───────────────┘
  433.         You need ARCE.COM, or ARC.EXE if you make a few changes in CD-BOX.CFG
  434.         (see part IV, and section on archives below).
  435.  
  436.     ┌───────────────┐
  437.     │ .ARJ archives │ All formats
  438.     └───────────────┘
  439.         You need ARJ.EXE (see section on archives below).
  440.  
  441.     ┌─────────────────────────────┐
  442.     │ Creative Music Files (.CMF) │ SoundBlaster only
  443.     └─────────────────────────────┘
  444.         You need the sound driver SBFMDRV.COM from Creative Labs, Inc, and it
  445.         has to be loaded in memory before CD-Box is run. (You can remove it by
  446.         typing SBFMDRV /U once you exit CD-Box). No other program is
  447.         necessary, .CMF routines are programmed directly into CD-Box.
  448.  
  449.     ┌────────────────────────────────┐
  450.     │ Single track MIDI files (.MDI) │ SoundBlaster only?
  451.     └────────────────────────────────┘
  452.         No, I haven't found any player yet, but I know they exist - those of
  453.         you who are lucky enough to have access to the net should find one!
  454.         Otherwise, I have hopes of implementing routines in CD-Box itself.
  455.  
  456.     ┌────────────────────────┐
  457.     │ Amiga MOD files (.MOD) │ SoundBlaster only
  458.     └────────────────────────┘
  459.         You need nothing except lots of memory; CD-Box is linked to internal
  460.         .MOD playing routines.
  461.  
  462.     ┌────────────────────┐
  463.     │ Music files (.MUS) │ AdLib & SoundBlaster
  464.     └────────────────────┘
  465.         You need PLAY.EXE. Each .MUS file also needs a .SND bank file, so be
  466.         sure to put them in the directory too. (ex: AGNES.MUS and AGNES.SND,
  467.         MULL.MUS and MULL.SND...)
  468.  
  469.         Note: .MUS bank files (.SND files) are different from Macintosh raw
  470.         sound files (.SND extension also) - the former contain instrument data
  471.         and the latter a complete digitized sound.
  472.  
  473.     ┌─────────────────────┐
  474.     │ ROLand files (.ROL) │ AdLib & SoundBlaster
  475.     └─────────────────────┘
  476.         You need SPUTROL.COM, and the sound driver SOUND.COM from AdLib, Inc;
  477.         but you don't have to load it before running CD-Box. SPUTROL will
  478.         itself load it if necessary, and unload it when done. .ROL files also
  479.         need at least one .BNK bank file, which usually is STANDARD.BNK.
  480.  
  481.         If you have SB-SOUND.COM from Creative Labs, Inc, rename it to
  482.         SOUND.COM so that SPUTROL can detect it (unless you use another player
  483.         which properly detects SB-SOUND...)
  484.  
  485.         Since many of you asked... ROL2CMF will convert .ROL to .CMF so you
  486.         can use CD-Box's internal routines instead of SPUTROL. ROL2CMF is
  487.         widely available on FTP servers, such as saffron.inset.com, directory
  488.         pub/sound/players.
  489.  
  490.     ┌─────────────────────────────────┐
  491.     │ SoundBlaster VOiCe files (.VOC) │ SoundBlaster only
  492.     └─────────────────────────────────┘
  493.         You need CT-VOICE.DRV, typically in the \VOC directory behind the
  494.         SOUND environment variable, but it may be anywhere on the path. .VOC
  495.         files are digitized sound files and not real music files, so the space
  496.         taken up on disk can be HUGE.
  497.  
  498.         Unregistered users need also VPLAY.EXE to play .VOC files bigger than
  499.         100 KB (using dual support, see part IV on how to do that). Registered
  500.         users can play without any external player .VOC files of any size, as
  501.         long as it fits in memory - this restriction will completely disappear
  502.         in the next version (I've got the code, it works, I just want to be
  503.         ABSOLUTELY sure before I put it in CD-Box).
  504.  
  505.         Digitized sounds in other formats (Macintosh .SND, Sun .AU and many
  506.         others) can be converted to .VOC using various utilities. I use and
  507.         recommend SOX (maintained by Lance Norskog), available at
  508.         garbo.uwasa.fi in pc/sound.
  509.  
  510.     ┌──────────────────────────────┐
  511.     │ Windows 3.1 WAV files (.WAV) │ PAS-16 only (SoundBlaster very soon!)
  512.     └──────────────────────────────┘
  513.         PLAYFILE.EXE, bundled with the PAS-16 (or so I've heard), can play
  514.         both .VOC and .WAV files on this card. I've found other players that
  515.         play .WAV on a SoundBlaster, but never perfectly... there MUST be one
  516.         around somewhere!
  517.  
  518.         In any case .WAV routines should be implemented in CD-Box very soon.
  519.  
  520.     ┌───────────────┐
  521.     │ .ZIP archives │ All formats
  522.     └───────────────┘
  523.         You need PKUNZIP.EXE (see section on archives below).
  524.  
  525.  
  526. All the song files have to reside in CD-Box's directory; the program files do
  527.   not have to, but make sure CD-Box has access to them (through a PATH
  528.   statement for instance). CD-Box also examines the SOUND environnment
  529.   variable and is able to load drivers and players from there if necessary.
  530.  
  531. To see if CD-Box detects properly your drivers and player programs, type
  532.   CD-BOX/D at the DOS prompt.
  533.  
  534.  
  535. ══════════════════════════════════════════════════════════════════════════════
  536. *** How do I tell CD-Box to support other drivers/players?
  537. ──────────────────────────────────────────────────────────────────────────────
  538.  
  539. If you have a player program that meets the following restrictions:
  540.  
  541.   - it can be run in "quiet" mode, i.e. no output of ANY kind while running,
  542.       no error messages, no nothing.
  543.  
  544.   - it does not switch to a specific video mode (for instance, text mode) when
  545.       run.
  546.  
  547.   then CD-Box can support it. Read part IV for how to do that.
  548.  
  549.  
  550. ══════════════════════════════════════════════════════════════════════════════
  551. *** How do I add or remove songs to CD-Box?
  552. ──────────────────────────────────────────────────────────────────────────────
  553.  
  554. The song titles displayed in CD-Box depend entirely on the music files in the
  555.   current directory (either in archives or not). If you want to add songs to
  556.   CD-Box, simply put them in the current directory. To remove them, delete the
  557.   files. In other words, CD-Box always reflects the current directory - only
  558.   the file names are replaced by song titles.
  559.  
  560. The above paragraph is modified by the fact that if you specify file
  561.   specifications on the command line (for instance, CD-BOX *.ZIP NEW*.*), the
  562.   song titles will be those found in the specified files only.
  563.  
  564.  
  565. ══════════════════════════════════════════════════════════════════════════════
  566. *** What's all this about .ARC, .ARJ and .ZIP files?
  567. ──────────────────────────────────────────────────────────────────────────────
  568.  
  569. CD-Box is able to look into .ARC, .ARJ and .ZIP files (hereafter called
  570.   "archives") to see if there are any songs there; if it finds any, the
  571.   corresponding title will appear on the main screen, and the song will be
  572.   treated just as any other song. This means your songs can be packed in
  573.   archives in CD-Box's directory to save space; CD-Box will find them anyway.
  574.  
  575.  
  576. *** When does CD-Box uncompress the songs stored in archives?
  577.  
  578. Unpacking occurs in two cases only:
  579.  
  580.   - at startup, if a song found in an archive is not known to CD-Box, it will 
  581.       exploded using the appropriate archiver (ARCE.COM, ARJ.EXE, PKUNZIP.EXE, 
  582.       or whatever you specified in CD-BOX.CFG) so that it can be analyzed. The
  583.       program will try to extract the most information from the file (title
  584.       and length in particular); the "Analyzing song" indicator is lit up.
  585.       When done, CD-Box will remove the unpacked file.
  586.  
  587.   - just before playing a song stored in an archive, the small "CD-BOX" on the
  588.       green reader at the top of the screen lights up and CD-Box invokes the
  589.       archiver to explode the song file, and the bank file if necessary. When
  590.       done playing, the unpacked files are removed also.
  591.  
  592.  
  593. *** Where are files exploded to?
  594.  
  595. Files temporarily extracted from archives files reside on:
  596.  
  597.   - the drive/directory specified by the Temp= statement in CD-BOX.CFG;
  598.  
  599.   - if Temp= is not specified, the drive/directory specified by the TEMP
  600.       environnment variable;
  601.  
  602.   - if TEMP doesn't exist, to the default drive/directory.
  603.  
  604. Always make sure there's enough room to hold the largest expanded song!
  605.   Otherwise you'll get an "Unable to explode song" message.
  606.  
  607.  
  608. *** What programs are necessary to take full advantage of this feature?
  609.  
  610. Any programs capable of extracting files from .ARC, ARJ and/or .ZIP files
  611.   (typically ARCE.COM, ARJ.EXE and PKUNZIP.EXE, but you might have others). If
  612.   you don't have the corresponding archive manager, or if it is not reachable
  613.   through a PATH statement, and if you have archives in CD-Box's directory,
  614.   the message "Unable to explode song" will appear. CD-Box may also crash at
  615.   startup.
  616.  
  617. The bottom line: using archives with CD-Box is pretty easy and 
  618.   straightforward. In the case of synthetized music files (.CMF, .MDI, .MUS 
  619.   and .ROL), it also saves an average of 80% of disk space!!! And if you 
  620.   archive your music files by category, you'll better take advantage of Files 
  621.   mode (described in part I).
  622.  
  623.  
  624. ══════════════════════════════════════════════════════════════════════════════
  625. *** Dual support? What's that?
  626. ──────────────────────────────────────────────────────────────────────────────
  627.  
  628. .CMF, .MOD and .VOC files: it means CD-Box can play this format by itself. So
  629.   you have three choices:
  630.  
  631.   * The easiest: just let it play the songs and don't worry about anything
  632.       else.
  633.  
  634.   * If CD-Box won't play this format on your particular computer, you can try
  635.       overriding its routines by telling it to use an external player (ex:
  636.       AdLib users might have a .CMF player that works on their card). You
  637.       simply have to insert the appropriate statements in CD-BOX.CFG.
  638.  
  639.   * CD-Box can also use both: try playing the format by itself, and if that
  640.       fails, use an external player; you have to insert whatever is needed to
  641.       run the player in CD-BOX.CFG, and add a "dual=yes" statement.
  642.  
  643. See part IV for how to tell CD-Box to use internal, external, or dual support.
  644.  
  645.  
  646. ══════════════════════════════════════════════════════════════════════════════
  647. *** Is there any way I can skip the animation?
  648. ──────────────────────────────────────────────────────────────────────────────
  649.  
  650. Indeed there is. Type CD-BOX/F at the DOS prompt.
  651.  
  652. You can also skip the title screen, but still have the animation, by pressing
  653.   a key while CD-Box is loading (before it switches to graphics mode).
  654.  
  655.  
  656. ══════════════════════════════════════════════════════════════════════════════
  657. *** Are there any shortcuts to make things happen more quickly?
  658. ──────────────────────────────────────────────────────────────────────────────
  659.  
  660. Try clicking the RIGHT mouse button. For instance, clicking the right mouse
  661.   button on a song button plays the song immediately, or clicking the right
  662.   mouse button on the "Rewind" and "Forward" buttons go to the beginning and
  663.   end of the song index, respectively. But if that's still too slow for you,
  664.   the /F parameter is even faster, but then you'll skip ALL the animations.
  665.  
  666. Right clicking is not available from the keyboard.
  667.  
  668.  
  669. ══════════════════════════════════════════════════════════════════════════════
  670. *** What does that "XXX duplicate!" message at startup mean?
  671. ──────────────────────────────────────────────────────────────────────────────
  672.  
  673. This can only happen if you use archives (.ARC, .ARJ or .ZIP files); it means
  674.   you have two or more files which have exactly the same filename in the
  675.   CD-Box directory. CD-Box ignores all duplicate filenames and remembers only
  676.   the first one found. It's not an error, it's a warning, but it can be
  677.   annoying.
  678.  
  679. You have the same file twice or more in the directory (one in an archive,
  680.   another in another archive or simply in the directory). So delete one or
  681.   rename the other.
  682.  
  683.  
  684. ══════════════════════════════════════════════════════════════════════════════
  685. *** How does CD-Box remember the title and length of songs?
  686. ──────────────────────────────────────────────────────────────────────────────
  687.  
  688. Files found in the current directory are the ones loaded, and the bank file
  689.   and title given depend on the following criteria:
  690.  
  691.   - If there is a SONGS.DAT file in the directory, and if it contains that
  692.       song, CD-Box loads the data from it (SONGS.DAT is an external database
  693.       CD-Box uses to remember songs).
  694.  
  695.   - Otherwise, if CD-Box knows that song intrisically (there is another
  696.       database directly programmed into CD-BOX.EXE), the data is read from
  697.       there.
  698.  
  699.   - If all this fails, then CD-Box tries to make the best possible guesses:
  700.  
  701.       + bank file: usually BNK974.BNK, or filename.SND, or none.
  702.  
  703.       + song title: extracted from disk (.CMF and .MOD), otherwise same as
  704.           filename.
  705.  
  706.       + length: 0 (unknown), except for .ROL and .VOC files, where the length
  707.           is computed directly from the file on disk.
  708.  
  709. All this is recorded in CD-Box's external database (SONGS.DAT); if the
  710.   database doesn't exist, it is created. Any changes you make, and of course
  711.   the changes in length as computed when playing the song, take over the
  712.   default values, and are recorded as well.
  713.  
  714. All changes are actually written to disk when you quit CD-Box (Eject).
  715.  
  716. At the time of this writing, CD-Box intrinsically knows about 150 songs, but
  717.   this number keeps changing. Type CD-BOX/I at the DOS prompt to know exactly
  718.   how many.
  719.  
  720.  
  721. ══════════════════════════════════════════════════════════════════════════════
  722. *** How can I tell CD-Box to load only the song files my system supports?
  723. ──────────────────────────────────────────────────────────────────────────────
  724.  
  725. If you're missing some drivers or player programs, you might want CD-Box to
  726.   load only the files it can play, instead of loading them all and issuing an
  727.   error message each time. Give it the /L parameter at startup (CD-BOX /L).
  728.   Note that in this case CD-Box will also ignore songs in archives if the 
  729.   corresponding archive manager cannot be found.
  730.  
  731. Unplayable songs (i.e. missing driver or player) are grayed when you select
  732.   them in CD-Box.
  733.  
  734.  
  735. ══════════════════════════════════════════════════════════════════════════════
  736. *** What are the command line parameters?
  737. ──────────────────────────────────────────────────────────────────────────────
  738.  
  739. CD-BOX/? gives you a quick summary. Otherwise, here are the details:
  740.  
  741.  
  742.   * filespec: instead of scanning the entire directory, CD-Box will scan only
  743.         the files matching your file specifications. For instance, if you want
  744.         CD-Box to load the .MUS and .ROL files only, type CD-BOX *.MUS *.ROL;
  745.         or if you just got a brand new archive containing new songs called
  746.         ALLNEW.ZIP, and you want CD-Box to scan only that archive, type CD-BOX
  747.         ALLNEW.ZIP. An alternative is to use Files mode (see above). The
  748.         default for filespec is, of course, *.*.
  749.  
  750.  
  751.   * /D: This is a debugging tool which displays:
  752.  
  753.           - whether your copy of CD-Box is registered, and to whom;
  754.  
  755.           - whether any errors were found in CD-BOX.CFG;
  756.  
  757.           - the complete paths to all the drivers and players specified in
  758.               CD-BOX.CFG, if found; a [I] means the driver/player is necessary
  759.               for internal support, a [E] means it's for external support, and
  760.               [D] means it's for external support when internal support fails 
  761.               (dual support).
  762.  
  763.           - the complete paths to all supported archive managers, if found;
  764.  
  765.           - the name of each file as it is read and analyzed from the 
  766.               directory when CD-Box starts up. I put this because CD-Box 
  767.               almost never checks whether a music file is valid or not before 
  768.               analyzing it (to speed things up). So, if you try to run CD-Box 
  769.               and you get a "CRASH!", try using /D, and chances are you'll 
  770.               spot the file which is invalid. REMOVE THIS FILE FROM THE
  771.               DIRECTORY!
  772.  
  773.             There are a few checking routines to prevent this, however, so you
  774.               might get an "Invalid .ROL file" message or equivalent. In that
  775.               case, remove the file too.
  776.  
  777.             Duplicate songs are also displayed and reported.
  778.  
  779.  
  780.   * /F: All non-essential animation is skipped, including the title screen,
  781.         CDs popping up and down, buttons flipping over, .MOD level bars...
  782.         Use this parameter if CD-Box runs too slowly on your computer, or if
  783.         you're a little short on memory (you get thrown back to DOS with
  784.         messages like "Not enough memory to load..." or "VGA Sprite Manager
  785.         has run out of memory!").
  786.  
  787.         If you don't specify the /F parameter, you can still skip the title
  788.         screen by pressing a key while CD-Box is loading (before it switches
  789.         to graphics mode).
  790.  
  791.  
  792.   * /I: Displays how much memory CD-Box detects and reserves for animation
  793.         purposes, and also how many songs are in the internal and external
  794.         databases.
  795.  
  796.  
  797.   * /L: Tells CD-Box NOT to load the song formats which cannot be played (i.e.  
  798.         a driver is not loaded or missing or a player program is missing). In
  799.         other words, CD-Box does not load songs which corresponding pilot
  800.         light is grayed. This includes archive files; they will not be scanned
  801.         if the corresponding archive manager cannot be found.
  802.  
  803.  
  804.   * /M: Tells CD-Box not to use a mouse, even if it is able to detect one. 
  805.         This will remove the warning that no mouse is detected if none is 
  806.         present, and also will enable you to use the keyboard without having
  807.         your mouse wrecking havoc on the screen, if your mouse driver is one
  808.         of those which CD-Box doesn't like.
  809.  
  810.  
  811.   * /P: Loads CD-Box, plays n minutes of music by switching to Random mode,
  812.         and then exits back to DOS upon completion of the last song. If Esc is
  813.         pressed between songs, playback interrupts just as usual, and normal
  814.         operation is resumed: you can then use the mouse to choose songs,
  815.         change titles...
  816.  
  817.  
  818.   * /R: Removes the files specified on the command line from the external
  819.         database (SONGS.DAT). You have to specify the filenames (wildcards
  820.         accepted), not the song titles. For instance, to remove the files
  821.         IMPACT7.MOD and all Z*.ROL from SONGS.DAT, you would type CD-BOX /R
  822.         IMPACT7.MOD Z*.ROL. CD-BOX /R * would delete all the songs in
  823.         SONGS.DAT - it's easier to erase the file. You shouldn't ever need to
  824.         use /R, except in extremely rare cases where CD-Box would have fouled
  825.         up and recorded a song length of 456324875 hours for a specific
  826.         song...
  827.  
  828.  
  829.   * /V: Displays the contents (filename, bank filename, title and length) of
  830.         the external database (SONGS.DAT) on the screen, pausing when the
  831.         screen is full. The songs displayed match the file specifications on
  832.         the command line - default is * (all). Blank entries in the Bank
  833.         column indicate the file does not need any bank file (.CMF, .MOD and
  834.         .VOC), and blank entries in the Length column indicate the length of
  835.         the song is not known (0). If you want to save this listing to a file,
  836.         specify a filename, like this:
  837.  
  838.                                CD-BOX /V=filename
  839.  
  840.         Output will be saved to the file filename.TXT.
  841.  
  842.  
  843. ══════════════════════════════════════════════════════════════════════════════
  844. *** I have an AdLib, is there a way I can play the files for SoundBlaster?
  845. ──────────────────────────────────────────────────────────────────────────────
  846.  
  847. Yes... if you have a player which can do that. CD-Box can't. If you have FTP
  848.   or News access, ask around, I've heard of an AdLib .CMF player, and of
  849.   something to make the AdLib play .MODs. Whether they exist, and can be made
  850.   to run with CD-Box (using CD-BOX.CFG) is another matter.
  851.  
  852.  
  853. ══════════════════════════════════════════════════════════════════════════════
  854. *** Is there anything else I should know about CD-Box?
  855. ──────────────────────────────────────────────────────────────────────────────
  856.  
  857. Well... there is. There are random animations happening at irregular
  858.   intervals. If you don't use the /F parameter and are patient, you should see
  859.   some from time to time.
  860.  
  861.  
  862. ══════════════════════════════════════════════════════════════════════════════
  863.  
  864.                          PART III: KEYBOARD SUPPORT
  865.  
  866. ══════════════════════════════════════════════════════════════════════════════
  867.  
  868. CD-Box can be used without the mouse entirely, although it was intended from
  869.   the start to run with a mouse. In fact, versions up to v2.10 (inclusive)
  870.   required a mouse; it was not optional. I added keyboard support since
  871.   somehow I have not been able to have routines that support ALL Microsoft
  872.   compatible mouse drivers out there (the vast majority work but not all).
  873.  
  874. Some random animations lose much of their interest without a mouse; sometimes 
  875.   a gray arrow will appear to simulate the mouse, as in the "lighter" 
  876.   animation.
  877.  
  878. The keyboard is active even with a mouse. What CD-Box does when a key is
  879.   pressed is find which button to activate, then simulate a left button click.
  880.  
  881. Most buttons can be clicked on by pressing their first letter, the notable
  882.   exceptions being Rewind and Forward, which are PgUp and PgDn, respectively.
  883.   The long rectangular button under the main button menu work the same, but
  884.   with the Alt key held down. The control buttons for .MOD files work with the
  885.   Ctrl key held down.
  886.  
  887. The exact keys to click on the various buttons are:
  888.  
  889. * SELECT MODE: Play: P             Rewind: PgUp        Forward: PgDn
  890.                Loop: L             Random: R           Eject: E
  891.  
  892. * PLAY MODE:   Stop: Esc           Skip: S             Pause/Resume: P
  893.                Rem: R              Total:  T
  894.                .MOD FILES ONLY: volume control: Ctrl A (min) to Ctrl L (max)
  895.                                 skip backward: Ctrl-left
  896.                                 skip forward: Ctrl-right
  897.  
  898. * MODIFY MODE: About: A            Rewind: PgUp        Forward: PgDn
  899.                File: F             Bank: B             Title: T
  900.  
  901. * FILES MODE:  Rewind: PgUp        Forward: PgDn       Rescan: R
  902.  
  903. Song buttons:  1 to 8 (1 to 4 in the first column, 5 to 8 in the second)
  904.  
  905. Mode buttons:  Files: Alt F        Goto: Alt G
  906.                Modify: Alt M       Unselect: Alt U
  907.  
  908. Esc will stop the song being played back, even if the Stop button is not
  909.   displayed.
  910.  
  911.  
  912. ══════════════════════════════════════════════════════════════════════════════
  913.  
  914.                             PART IV: CD-BOX.CFG
  915.  
  916. ══════════════════════════════════════════════════════════════════════════════
  917. *** The purpose of CD-BOX.CFG.
  918. ──────────────────────────────────────────────────────────────────────────────
  919.  
  920. CD-BOX.CFG is a file in which you can define many of CD-Box's parameters.
  921.   Mainly, you can specify what driver/player programs to use, and also how to
  922.   extract songs from archives, and various other things. CD-Box has default
  923.   values for most of these parameters, but you can override them with
  924.   CD-BOX.CFG.
  925.  
  926. Two important remarks:
  927.  
  928.   * Errors in CD-BOX.CFG are skipped; CD-Box will simply give a warning
  929.       message at startup and go on anyway. But these errors may hinder CD-Box
  930.       when extracting or playing songs. A complete error report may be
  931.       obtained by typing CD-BOX/D.
  932.  
  933.   * Programs run as subshells by CD-Box (archivers and player programs) must 
  934.       produce NO OUTPUT OF ANY KIND. The reasons, I think, are obvious (CD-Box 
  935.       runs in VGA and it wouldn't do to have big ugly characters messing up 
  936.       and maybe scrolling the screen each time you play a song). Therefore,
  937.       make sure the archivers and player programs won't print anything, either 
  938.       using a parameter from the archiver or the player itself (for instance, 
  939.       /Q or -q), or by redirecting output to null, void, nothing, emptiness (> 
  940.       nul).  This last solution doesn't always work; check under DOS.
  941.  
  942.  
  943. ══════════════════════════════════════════════════════════════════════════════
  944. *** General syntax
  945. ──────────────────────────────────────────────────────────────────────────────
  946. * COMMENTS
  947. All blank lines and everything after a semicolon (;) are ignored.
  948.  
  949. ──────────────────────────────────────────────────────────────────────────────
  950. * PARAMETER SETTINGS
  951. Most parameters are set by typing the parameter name, an equal sign (with no
  952.   space before nor after), and the parameter value. For instance:
  953.  
  954. Temp=D:\
  955. player=PLAY.EXE
  956.  
  957. Case is not important in the parameter name, but it may be in the value; "/q" 
  958.   and "/Q" might not mean the same thing to a player program. CD-Box always 
  959.   preserves case when passing parameters to the programs it runs, except for 
  960.   filenames, which are always in uppercase.
  961.  
  962. ──────────────────────────────────────────────────────────────────────────────
  963. * SECTION IDENTIFIERS
  964.  
  965. Some commands like Player=, Parameters=, and so on, need to know which format
  966.   you're refering to. Special lines like:
  967.  
  968. [ROL]
  969.  
  970. means that the following parameter settings are intended for the .ROL format.
  971.   You can have a different section for each song format, and each archive
  972.   format.
  973.  
  974.  
  975. ══════════════════════════════════════════════════════════════════════════════
  976. *** Command reference
  977. ──────────────────────────────────────────────────────────────────────────────
  978. * SYSTEM PARAMETERS
  979.  
  980. MixingSpeed=n
  981.  
  982. This will set CD-Box's .MOD playing routines to n Hz per second. Lower values
  983.   will run better on slower computers, while higher values enhance playback
  984.   quality. Values higher than 22000 Hz don't make much sense since instruments
  985.   in .MOD files are sampled at a rate of 22 KHz anyway. The default is 15909.
  986.   This affects .MOD files only.
  987.  
  988. MODDevice=n
  989.  
  990. This set the output device .MODs are played to, n being:
  991.         0       PC Speaker (sounds awful under CD-Box)
  992.         1       D/A converter on LPT1
  993.         2       D/A converter on LPT2
  994.         3       D/A converter on LPT3
  995.         4       D/A converters on LPT1 and LPT2 (stereo)
  996.         5       D/A converters on LPT1 and LPT2 (mono)
  997.         7       Soundblaster card
  998.         10      Stereo-on-1 card
  999.         11      Disney Sound Source on LPT1
  1000.         12      Disney Sound Source on LPT2
  1001.         13      Disney Sound Source on LPT3
  1002.         255     No sound
  1003. The default is 7 (SoundBlaster). This affects .MOD files only.
  1004.  
  1005. Temp=path
  1006.  
  1007. This sets the path on which files extracted from archives temporarily reside.
  1008.   Make sure it's big enough to hold your largest song (and its bank file if
  1009.   necessary). If omitted, the temporary path defaults the current directory
  1010.   (or the directory in your TEMP environment variable).
  1011.  
  1012. ──────────────────────────────────────────────────────────────────────────────
  1013. * PARAMETERS FOR ARCHIVERS
  1014.  
  1015. The only case you should have to insert commands like the following is if you
  1016.   have a different archiver than those I planned to handle .ARC, .ARJ and .ZIP
  1017.   files. I put these commands in for completeness' sake, and just in case the
  1018.   upgrade to an archiver use a different syntax than the previous version
  1019.   (it's very unlikely but you never know).
  1020.  
  1021. [ARC]
  1022. archiver=ARCE.COM
  1023. parameters=$zipfile $files /R /Q > nul
  1024.  
  1025. This means that the archiver for .ARC files is ARCE.COM, and when you extract
  1026.   the files "ABCD.TXT EFG.MOD" from the "HELLO.ARC" archive, you type at the
  1027.   DOS prompt:
  1028.  
  1029. ARCE HELLO.ARC ABCD.TXT EFG.MOD /R /Q > nul
  1030.  
  1031. $zipfile and $files are replaced at runtime by the appropriate names. $zipfile
  1032.   will always be a single filename (the name of the archive itself), while
  1033.   $files is a string of filenames separated by spaces (the names of the files
  1034.   to extract). Note that the "> nul" prevents ARCE from displaying anything on
  1035.   the screen, thereby preserving CD-Box's splendid graphics and stupendous
  1036.   animation (well, maybe I'm overdoing it a little... :-)
  1037.  
  1038. The same things applies to all other archivers of course.
  1039.  
  1040. If you use ARC.EXE instead of ARC.COM, insert the following commands:
  1041.  
  1042. [ARC]
  1043. archiver=ARC.EXE
  1044. parameters=x $zipfile $files > nul
  1045.  
  1046. ──────────────────────────────────────────────────────────────────────────────
  1047. * EXTERNAL DRIVERS AND PLAYERS
  1048.  
  1049. The syntax is very similar:
  1050.  
  1051. [ROL]
  1052. driver=SOUND.COM
  1053. player=SPUTROL.COM
  1054. parameters=$song $bank /Q1
  1055.  
  1056. This means that the player necessary to play .ROL files is SPUTROL.COM, and
  1057.   gives the parameters. $song is replaced by the song filename at runtime, and
  1058.   $bank by the bank filename (if any). Moreover, SPUTROL will need to load
  1059.   SOUND.COM, so the statement "driver=SOUND.COM" is given in CD-BOX.CFG so
  1060.   that CD-Box can detect whether it can be found or not, thus whether .ROL
  1061.   files can be played or not.
  1062.  
  1063. If no driver is needed, omit the Driver= command. Otherwise, if you start a
  1064.   song section, you have to put in a Player= and a Parameters= command.
  1065.  
  1066. There are three other song format-specific commands:
  1067.  
  1068. shell=yes
  1069.  
  1070. Instead of running the player, CD-Box will run a COMMAND.COM that will itself 
  1071.   run the player (COMMAND /C player parameters...). The advantage is that if 
  1072.   the player is not very well written, COMMAND.COM will try to clean up the 
  1073.   mess when shutting down and returning to CD-Box; the drawback is, of course, 
  1074.   increased memory usage. Fortunately, such instances are rare, but SPUTROL, 
  1075.   for example, leaves files open; when run many times without COMMAND.COM from 
  1076.   CD-Box, it decreases the number of available file handles until nothing can 
  1077.   be run anymore.
  1078.  
  1079. dual=yes
  1080.  
  1081. The simple fact that there is a song section in CD-BOX.CFG disables completely
  1082.   CD-Box's internal support for the corresponding format; it will rely
  1083.   entirely on what you specify as Driver= and Parameters= to play the format.
  1084.   Specifying "dual=yes" re-activates internal support. When encountering a
  1085.   song of the corresponding format, CD-Box will first try to play it using its
  1086.   own routines; if this fails for a specific song, it will switch to external
  1087.   support, using what you put in CD-BOX.CFG. An example of how to use this
  1088.   follows.
  1089.  
  1090. swap=yes
  1091.  
  1092. Before running the player, CD-Box will first swap itself and all its data into
  1093.   EMS memory; if not available, into XMS, or a temporary file on the path
  1094.   specified in the TEMP environment variable, or the current directory, in
  1095.   that order. The difference is that instead of gobbling about 250 KB of main
  1096.   memory before running the player, CD-Box will use only about 5 KB, leaving
  1097.   all the rest to the player. An example of how to use this follows.
  1098.  
  1099. This swapping feature has not been entirely tested - if it doesn't work on 
  1100.   your machine, then remove all "swap=yes" statements from CD-BOX.CFG. I 
  1101.   included it in this version as a kind of beta-test - it works fine on the 
  1102.   computers I've tried.
  1103.  
  1104. Another example:
  1105.  
  1106. [MOD]
  1107. player=MP.COM
  1108. parameters=-q $song
  1109. dual=yes
  1110. swap=yes
  1111.  
  1112. If CD-Box fails to play a .MOD, it will run (dual=yes) an external player 
  1113.   (player=MP.COM) using the given parameters (parameters=...), swapping itself 
  1114.   out of main memory first (swap=yes). The explanation: if CD-Box tries to 
  1115.   play a huge .MOD that doesn't fit in memory, the internal routines will fail
  1116.   (returning a Out of memory error); CD-Box will then free most of main
  1117.   memory, and run MP.COM, which will have about 600 KB on a 386+ (560 KB on a
  1118.   286) to load and play the .MOD file.
  1119.  
  1120.  
  1121. ══════════════════════════════════════════════════════════════════════════════
  1122.  
  1123.                           PART V: TROUBLE-SHOOTING
  1124.  
  1125. ══════════════════════════════════════════════════════════════════════════════
  1126.                         CRASHES DURING SONG ANALYSIS
  1127. ══════════════════════════════════════════════════════════════════════════════
  1128. *** I get a "Crashed while exploding..." error message
  1129. ──────────────────────────────────────────────────────────────────────────────
  1130.  
  1131. Run CD-BOX/D. If archive managers are found, then CD-Box will say so...  and
  1132.   crash while analyzing files stored in an archive. Try exploding this archive
  1133.   by hand, and see what happens. The problem may be that the temporary drive
  1134.   or directory (Temp= in CD-BOX.CFG, or TEMP in your environnment) is invalid
  1135.   or full.
  1136.  
  1137. Another solution is to tell CD-Box not to load songs from archives if it
  1138.   cannot explode them; in that case, start CD-Box with the /L parameter.
  1139.  
  1140.  
  1141. ══════════════════════════════════════════════════════════════════════════════
  1142. *** CD-Box hangs while "Building file index"!
  1143. ──────────────────────────────────────────────────────────────────────────────
  1144.  
  1145. CD-Box was trying to read a corrupted archive (.ARC, .ARJ or .ZIP). Fix the
  1146.   archive or get rid of it!
  1147.  
  1148.  
  1149. ══════════════════════════════════════════════════════════════════════════════
  1150. *** I get a "CRASH!" message while CD-Box analyzes a song
  1151. ──────────────────────────────────────────────────────────────────────────────
  1152.  
  1153. Type CD-BOX/D to find the file that makes CD-Box crash. Then:
  1154.  
  1155.   * If it's while analyzing an uncompressed song, it means the song has an
  1156.       invalid format, and CD-Box crashes when trying to extract meaningful
  1157.       values like song title and song length. Delete that song file!
  1158.  
  1159.   * If it's while opening an archive, the archive may be corrupted. Fix it!
  1160.  
  1161.  
  1162. ══════════════════════════════════════════════════════════════════════════════
  1163.                       REFUSAL TO PLAY CERTAIN SONGS
  1164. ══════════════════════════════════════════════════════════════════════════════
  1165. *** CD-Box displays a "Driver not found" message!
  1166. ──────────────────────────────────────────────────────────────────────────────
  1167.  
  1168. .CMF:
  1169.  
  1170. You're trying to play a .CMF file but haven't loaded the SBFMDRV driver before
  1171.   starting CD-Box. Having SBFMDRV.COM on disk is not enough, it has to be
  1172.   loaded too (you can always unload it afterwards by typing SBFMDRV/U). Note 
  1173.   to 386+ users: load it using LOADHIGH SBFMDRV, you'll save memory!
  1174.  
  1175. Others:
  1176.  
  1177. The driver specified in the CD-BOX.CFG file could not be found. Either the
  1178.   driver is not on the PATH or SOUND environnment variable, or the driver name
  1179.   is mispelled in the CD-BOX.CFG file. Typing CD-BOX/D at the DOS prompt may
  1180.   help.
  1181.  
  1182.  
  1183. ══════════════════════════════════════════════════════════════════════════════
  1184. *** CD-Box displays a "Player program not found" message!
  1185. ──────────────────────────────────────────────────────────────────────────────
  1186.  
  1187. You have tried playing a song, and the associated player program was not found
  1188.   (the pilot light at the top should be grayed). Make note of the format
  1189.   causing problems, then run CD-Box with the /D parameter. If the
  1190.   corresponding program is displayed as "not found.", then you can't play
  1191.   these songs, unless:
  1192.  
  1193.   * You get the program and put it in CD-Box's directory, the directory from
  1194.       the SOUND environnment variable, or somewhere on your PATH.
  1195.  
  1196.   * Or you modify the CD-BOX.CFG file to have CD-Box support another player
  1197.       you might have for that format. See part IV for details.
  1198.  
  1199.  
  1200. ══════════════════════════════════════════════════════════════════════════════
  1201. *** CD-Box displays a "Don't know how to play" message!
  1202. ──────────────────────────────────────────────────────────────────────────────
  1203.  
  1204. There's something wrong in the CD-BOX.CFG file. Either the player= or
  1205.   parameters= command is missing, and both must be present.
  1206.  
  1207. Since CD-Box supports .CMF, .MOD and .VOC internally, you can also remove the 
  1208.   [CMF], [MOD] or [VOC] section in CD-BOX.CFG (if there is one). This way,
  1209.   CD-Box won't try to look for external drivers and/or players, and will use
  1210.   its own code to play the songs.
  1211.  
  1212.  
  1213. ══════════════════════════════════════════════════════════════════════════════
  1214. *** CD-Box doesn't play the song, and there is no error message!
  1215. ──────────────────────────────────────────────────────────────────────────────
  1216.  
  1217. This should happen only when you use an external player. If CD-Box acts as if
  1218.   it will play a song, but in fact doesn't play it at all, and no error is
  1219.   generated, it's because the player got an error (usually out of memory, but
  1220.   it could be corrupted bank file or something else), but reported none.
  1221.   CD-Box is then fooled into thinking everything was okay. Try playing the
  1222.   song by hand under DOS, and see what happens. If there is no problem, then
  1223.   it's very likely the player ran out of memory - often the case with .MOD
  1224.   files above 250 KB, or with certain complex .ROL files.
  1225.  
  1226. Add a "swap=yes" statement in the corresponding section in CD-BOX.CFG; CD-Box
  1227.   will swap itself in EMS, XMS or a temporary file, and leave all DOS memory
  1228.   free for your player (using only about 5 KB; without the "swap=yes", CD-Box
  1229.   uses about 250 KB). This swap thing is brand-new, I hope it works for you.
  1230.   Otherwise, freeing DOS memory and loading drivers high on 386+ computers
  1231.   (LOADHIGH SBFMDRV and things like that) is definitely a bonus, but not as
  1232.   drastic as swapping.
  1233.  
  1234.  
  1235. ══════════════════════════════════════════════════════════════════════════════
  1236. *** CD-Box displays "Unable to explode song"!
  1237. ──────────────────────────────────────────────────────────────────────────────
  1238.  
  1239. Three possibilities (at least :-):
  1240.  
  1241.   - CD-Box can't find the archive manager necessary to extract the song from a 
  1242.       .ARC, .ARJ or .ZIP archive (run CD-BOX/D to find out). Either make it
  1243.       available to CD-Box, remove any archives containing songs you may have
  1244.       in CD-Box's directory, or run CD-Box with the /L parameter.
  1245.  
  1246.   - There isn't enough room on the temporary drive.
  1247.  
  1248.   - .MUS and .ROL only: there is a second possibility: CD-Box has not found
  1249.       the bank file or could not explode it. Try changing the name of the bank
  1250.       file associated to the song, or if the name is okay, check that it is in
  1251.       the same archive than the song.
  1252.  
  1253.  
  1254. ══════════════════════════════════════════════════════════════════════════════
  1255.                          TROUBLE WITH .MOD FILES
  1256. ══════════════════════════════════════════════════════════════════════════════
  1257. *** CD-Box displays "Error loading .MOD"!
  1258. ──────────────────────────────────────────────────────────────────────────────
  1259.  
  1260. CD-Box recognizes only 31-instrument .MOD files; you may have .MODs it won't
  1261.   play even though players like ModPlay do. There are two solutions to this:
  1262.  
  1263.   * Use an external player to play .MOD files, either overriding completely
  1264.       CD-Box's routines or using dual support (giving CD-Box a chance to play
  1265.       the song and telling it to use the external player if it can't)
  1266.  
  1267.   * If you have ModEdit (or maybe another .MOD editor), load and save the .MOD
  1268.       files. ModEdit will always save the song as a 31-instrument .MOD, so it
  1269.       will be playable by CD-Box. I have a batch file that does this
  1270.       automatically as soon as I get new .MODs...
  1271.  
  1272.  
  1273. ══════════════════════════════════════════════════════════════════════════════
  1274. *** .MOD files sound terrible!
  1275. ──────────────────────────────────────────────────────────────────────────────
  1276.  
  1277. Apart from using an external player, you can try changing the "MixingSpeed="
  1278.   statement in CD-BOX.CFG. The higher the value, the better, but CD-Box's
  1279.   feedback will slow down accordingly while playing .MOD files and might even
  1280.   hang if you specify a value that is too high for your computer. The default
  1281.   is 15909 Hz which should give good results on computers fast enough; 10000
  1282.   Hz is kind of okay on "slow" machines.
  1283.  
  1284.  
  1285. ══════════════════════════════════════════════════════════════════════════════
  1286. *** I don't have enough memory to play .MOD files!
  1287. ──────────────────────────────────────────────────────────────────────────────
  1288.  
  1289. If you have ModPlay from Mark Cox, look at the end of part IV for how to play
  1290.   huge .MOD files (up to about 550 KB).
  1291.  
  1292.  
  1293. ══════════════════════════════════════════════════════════════════════════════
  1294. *** Clicking on "Pause" while playback doesn't really pause!
  1295. ──────────────────────────────────────────────────────────────────────────────
  1296.  
  1297. Well, YOU try pausing a .MOD file without killing it completely. Great fun.
  1298.   No, seriously, if pausing doesn't work, just resume and try pausing again -
  1299.   it works when they aren't too many instruments around. CD-Box has the same
  1300.   pausing problems as ModPlay... no wonder, I use almost the same routines!
  1301.  
  1302.  
  1303. ══════════════════════════════════════════════════════════════════════════════
  1304.                            HARDWARE TROUBLE
  1305. ══════════════════════════════════════════════════════════════════════════════
  1306. *** I get a "VGA Sprite Manager has run out of memory" message!
  1307. ──────────────────────────────────────────────────────────────────────────────
  1308.  
  1309. The VGA Sprite Manager is a huge object responsible for animating sprites on 
  1310.   the VGA screen, not messing up the background, being able to superpose 
  1311.   different sprites on different planes, and preventing flicker. However, it 
  1312.   also needs a lot of memory; 64 KB + the sprites to move, so it usually 
  1313.   amounts to about 80 - 90 KB. You can check the free memory by clicking on 
  1314.   the "About" button. If you don't have enough, use the /F parameter. The
  1315.   animations will be skipped, and the Sprite Manager will not be invoked. But
  1316.   chances are you're too short on memory to play some songs anyway.
  1317.  
  1318.  
  1319. ══════════════════════════════════════════════════════════════════════════════
  1320. *** CD-Box returns suddenly to DOS and I get a "CRASH!" message!
  1321. ──────────────────────────────────────────────────────────────────────────────
  1322.  
  1323. Well, you stumbled on a bug. I left all the checking routines on in CD-Box's
  1324.   code, so that instead of hanging up and forcing you to reboot, it exits to
  1325.   DOS (in most cases).
  1326.  
  1327. Restart CD-Box and try not to do it again - if you use CD-Box normally, you
  1328.   shouldn't get any bug. It's when you try to insist (for example, a .MOD song
  1329.   might not play because of insufficient memory, so don't try clicking on the
  1330.   song button 10 times to try to play it anyway), that CD-Box crashes. I, of
  1331.   course, am trying to get the number of bugs to an absolute minimum (very
  1332.   close to zero).
  1333.  
  1334.  
  1335. ══════════════════════════════════════════════════════════════════════════════
  1336. *** I get "Not enough memory to..." messages and CD-Box returns to DOS!
  1337. ──────────────────────────────────────────────────────────────────────────────
  1338.  
  1339. You have a fatal memory overflow. You have to free more memory; run CD-Box by
  1340.   itself under DOS, not as a shell from another program. You can also try
  1341.   typing CD-BOX /F at the DOS prompt, and if you can get to the main screen,
  1342.   you may be safe... but you may also be too short on memory to play songs
  1343.   anyway.
  1344.  
  1345.  
  1346. ══════════════════════════════════════════════════════════════════════════════
  1347. *** I'm not able to play any songs on my sound card!
  1348. ──────────────────────────────────────────────────────────────────────────────
  1349.  
  1350. I have a SoundBlaster v1.50 so I'm sure CD-Box runs with this card. Above 
  1351.   versions should work, as well as any SoundBlaster compatible card - it runs 
  1352.   on the AdLib (.MUS and .ROL), and net users report that it works with the
  1353.   SoundBlaster Pro (version 1 and 2) and the PAS-16. However, a net user
  1354.   reported that it didn't work with his SoundBlaster v1.05. Maybe the use of
  1355.   CD-BOX.CFG can solve this problem, but nothing is guaranteed - I have no way
  1356.   to test that.
  1357.  
  1358.  
  1359. ══════════════════════════════════════════════════════════════════════════════
  1360. *** I have trouble with my mouse!
  1361. ──────────────────────────────────────────────────────────────────────────────
  1362.  
  1363. YOU SHOULDN'T. Previous versions of CD-Box did have problem with furry
  1364.   creatures, but this version should NOT any more. CD-Box assumes the mouse is
  1365.   100% Microsoft compatible (200% compatibility or more preferred). Some
  1366.   workarounds are changing the driver, or even changing the clock speed (turbo
  1367.   or non-turbo speed - weird, huh?).
  1368.  
  1369. If CD-Box definitely cannot swallow your driver, use the keyboard (see part
  1370.   III). Use the /M parameter to remove mouse support entirely and not have the
  1371.   mouse pointer wreck the screen.
  1372.  
  1373.  
  1374. ══════════════════════════════════════════════════════════════════════════════
  1375. *** That darn program doesn't work AT ALL!
  1376. ──────────────────────────────────────────────────────────────────────────────
  1377.  
  1378. Read the license (part VII) if you haven't already done so.
  1379.  
  1380. I CANNOT GUARANTEE THAT CD-BOX WILL RUN ON YOUR PARTICULAR COMPUTER.
  1381.  
  1382. Let's be reasonable: I cannot guarantee that this program will work for you.
  1383.   You MUST have a VGA display, a Microsoft compatible mouse, and a lot of free
  1384.   RAM (at least 500 KB, 550 KB better; if you don't have 640K conventional
  1385.   memory, forget it - but then who doesn't these days?). This is the very
  1386.   minimum configuration under which CD-Box will run. If you want to hear the
  1387.   songs, you need an AdLib Music Synthetizer Card or a SoundBlaster card
  1388.   (CD-Box does run, but is of absolutely no use without a music card). And if
  1389.   you have a lot of songs, you need (a little) more memory, too, of course.
  1390.   CD-Box was developed on a 286 up to v2.11, then on a 386, and net users
  1391.   didn't report any problems with their 486s; a 8086 might be slow, though. If
  1392.   you have a 8086, you should try the /F parameter.
  1393.  
  1394. As far as I know, this program is free of bugs (except for those mentioned
  1395.   above). If you find any, TELL ME in detail! There's no chance of the bug
  1396.   being corrected if I don't know about it!
  1397.  
  1398. When reporting a bug, please be as precise as possible. What version number of
  1399.   CD-Box are you using? What exactly were you doing when the bug happened?
  1400.   What are the exact symptoms? I received in the past bug reports about mice
  1401.   for CD-Box v2.02 and below, like "my mouse goes crazy" or "doesn't work"...
  1402.   how am I supposed to work on this?!? It was by asking for details that I
  1403.   finally knew that "the yellow mouse seems to be at double the position of
  1404.   the white mouse", and that "random colored points are sprayed around the
  1405.   mouse arrow", and so the trouble was fixed - at least on the machines
  1406.   tested, hopefully on all.
  1407.  
  1408.  
  1409. ══════════════════════════════════════════════════════════════════════════════
  1410.  
  1411.                            PART VI: EPILOGUE
  1412.  
  1413. ══════════════════════════════════════════════════════════════════════════════
  1414. Version history
  1415. ──────────────────────────────────────────────────────────────────────────────
  1416.  
  1417.   * v1.00: CD-Box is born
  1418.  
  1419.   * v1.10: Screen packing/unpacking routines shrink the resource file
  1420.  
  1421.   * v1.11: Right mouse button support, /? and /F command-line switches.
  1422.  
  1423.   * v1.20: Increased animation (5 digit display, CD spins)
  1424.  
  1425.   * v1.50: (Major rewrite) Introduction of the expert database (no data file
  1426.           needed), new button set to make changes within CD-Box, scrolling
  1427.           display, /I command line parameter added.
  1428.  
  1429.   * v1.51: Internal programming upgraded with objects!
  1430.  
  1431.   * v1.60: CD-Box keeps growing:
  1432.  
  1433.     - Support for .CMF and .VOC files; increased support for .ROL files, by
  1434.         being able to compute the playing time from the file on disk.
  1435.  
  1436.     - /V parameter added, so you can look into SONGS.DAT, and /P parameter
  1437.         added. At the same time, the internal database has been updated and
  1438.         expanded to 98 songs.
  1439.  
  1440.     - Addition of "Goto" mode, and "cleaning up" of the various buttons,
  1441.         dividing them into three distinct modes with different color themes.
  1442.  
  1443.     - The scrolling display scrolls up instead of left, and the messages stay
  1444.         a while on-screen - makes it much easier to read messages, which is
  1445.         all that display was about in the first place!
  1446.  
  1447.   * v1.61: "Bug" fix:
  1448.  
  1449.     - CD-Box starts checking for some cases of invalid .ROL formats, which
  1450.         made the program crash at startup while analyzing the file. Also, the
  1451.         /D has been added, so you can see which file causes the error, and
  1452.         remove it.
  1453.  
  1454.     - A most subtle bug causing black lines to sometimes appear on the song
  1455.         buttons has been tracked down and DESTROYED.
  1456.  
  1457.     - CD-Box's capacity extended to about 300 songs (I haven't tried more).
  1458.  
  1459.   * v2.00: CD-Box gets better, thanks to the network! (see thanks below)
  1460.  
  1461.     - Support for .MOD files, thanks to Mark J Cox's "quiet" player ModPlay.
  1462.         The drawback: I had to reorganize CD-Box's allocation routines so that
  1463.         they leave enough memory for ModPlay to load large songs (if you have
  1464.         about 570 KB free before you run CD-Box, a 210 KB .MOD file is about
  1465.         the maximum CD-Box can load) - so now CD-Box is again split in two
  1466.         files, CD-BOX.EXE and CD-BOX.RSR. It's no big deal, but...
  1467.  
  1468.     - INTERNAL SUPPORT FOR .CMF files has been added; now the digits display a
  1469.         real-time clock (time elapsed & time left & total time elapsed &
  1470.         left), and you can PAUSE and RESUME the song any time.
  1471.  
  1472.     - A percentage bar displaying time played/time left (which are recomputed
  1473.         at the end of each song if the length of the song just played proved
  1474.         to be longer than CD-Box thought it was) is added.
  1475.  
  1476.     - Some people felt frustrated not being able to move the mouse all over
  1477.         the screen. Okay! In this version, you are able to!
  1478.  
  1479.     - Still more songs added to CD-Box's internal database.
  1480.  
  1481.     - VGA screens updated and much prettier (thanks to advice on subtle light
  1482.         reflections), and random animations added!!!
  1483.  
  1484.   * v2.01: some little glitches fixed, others optimized (duplicates with same
  1485.       names but different extensions are now accepted as two distinct songs).
  1486.       Also, the first version to be released on wide-scale servers in the
  1487.       U.S.A. (SIMTEL and FTP sites supported by the Sound Newsletter).
  1488.  
  1489.   * v2.02: A few improvements & bug fixes
  1490.  
  1491.      - All (or most) 2-button cheese eaters should work well now.
  1492.  
  1493.      - About 30 or 40 KB more free for those huge .MOD files.
  1494.  
  1495.      - A little less runtime errors, and a little more explicit messages.
  1496.  
  1497.      - Sprites as well as screens are shrinked in the resource file, saving
  1498.          50 KB (out of 220)! Hurray!
  1499.  
  1500.      - Some new animations, find them yourself!
  1501.  
  1502.   * v2.10: Inspired by net feedback...
  1503.  
  1504.      - INTERNAL SUPPORT FOR .MOD files. This, added to the fact that about
  1505.          30 KB of memory have been freed (despite CD-Box's growing complexity
  1506.          - over 1 Megabyte of sources!), means that monsters like "Flip House"
  1507.          can be played!!!
  1508.  
  1509.      - CD-BOX.CFG file added for maximum flexibility - CD-Box can now support
  1510.          ANY player that can run in "quiet" mode. What's more, if the formats
  1511.          evolve, you can override CD-Box's internal routines with an external
  1512.          player that supports the evolved format. Also, two parameters (.MOD
  1513.          mixing speed and temporary drive redirection) can be controlled from
  1514.          the .CFG file.
  1515.  
  1516.      - The pilot lights across the top (.CMF .MOD etc) are completely off if
  1517.          the corresponding format cannot be played (missing driver or player),
  1518.          so you know whether this format works without having to try and play
  1519.          a song file; in the same vein, unplayable songs are grayed when you
  1520.          select them. Also, /L (and /R) parameters added.
  1521.  
  1522.      - Files... mode added (rather easily to my own surprise - long live OOP!)
  1523.  
  1524.      - A *lot* of other small improvements (including completely rewritten
  1525.          mouse routines)...
  1526.  
  1527.   * v2.11: CD-Box (unfortunately?) changes status and becomes shareware.
  1528.  
  1529.      - keyboard support; CD-Box can run without a mouse altogether.
  1530.  
  1531.      - .MOD controls: volume control, moving within the song, and level bars;
  1532.          also .MOD output redirection added in configuration file.
  1533.  
  1534.   * v2.20: Keeping up to date:
  1535.  
  1536.      - buttons: auto-repeat, shadows, lighted when depressed; improved mouse
  1537.          cursors; .MOD bars are colored; CD-BOX/D gets more readable...
  1538.  
  1539.      - .ARC and .ARJ support added (and ready for all other archive formats
  1540.          too; the archive engine is ready and humming).
  1541.  
  1542.      - .MDI and .WAV external support added; .VOC partial internal support 
  1543.          added.
  1544.  
  1545.      - CD-BOX.EXE and CD-BOX.RSR are merged again into CD-BOX.EXE. One less
  1546.          file... but CD-BOX.EXE is much bigger :-)
  1547.  
  1548.   * Other ideas:
  1549.  
  1550.     - MORE INTERNAL SUPPORT for music files, without having to shell to
  1551.         external programs.
  1552.  
  1553.     - Support for any viable format I'll come across (all I need is a quiet
  1554.         player, better yet routines to play the format...)
  1555.  
  1556.     - Windows?
  1557.  
  1558.     - Any more suggestions?
  1559.  
  1560. I'll always do my best to notify the Editor of the widespread Sound Newsletter
  1561.   that I have a new version of CD-Box available. To date, the Sound Newsletter
  1562.   is published on several Newgroups such as comp.sys.ibm.pc.soundcard,
  1563.   comp.sys.ibm.pc.misc and rec.games.ibm.pc.misc, and carried by many FTP
  1564.   boards worldwide.
  1565.  
  1566.  
  1567. ══════════════════════════════════════════════════════════════════════════════
  1568. How you can help with CD-Box
  1569. ──────────────────────────────────────────────────────────────────────────────
  1570.  
  1571. I'm interested in sources or linkable object files to play .MDI, .MUS, .ROL or 
  1572.   .WAV files, since they allow the mouse to stay in control, the animation to 
  1573.   continue, and the timer and percent bar are then displayed as real-time...  
  1574.   and of course the user does not have to bother about a player program. If 
  1575.   you have Pascal or C sources, or Turbo C .OBJ files that you're willing to 
  1576.   share (provided it is legal to do so, i.e. your work, freeware, public 
  1577.   domain, shareware, in a book), then write me. If I work them in, I'll
  1578.   acknowledge that in the documentation and in CD-Box itself (the About
  1579.   button). .CMF and .MOD support were obtained in this way.
  1580.  
  1581. I hope I'll be able to go on supporting CD-Box. I'm currently doing my
  1582.   military service (obligatory in France), and free time so far with access to
  1583.   my computer has been pretty scarce - also I'm hampered by the fact I have no
  1584.   direct access to the net (this version has been sent to Dave Komatsu and he
  1585.   has been the one who uploaded it to the net). This is why your feedback via
  1586.   snail-mail is so important.
  1587.  
  1588.  
  1589. ══════════════════════════════════════════════════════════════════════════════
  1590. Thanks to...
  1591. ──────────────────────────────────────────────────────────────────────────────
  1592.  
  1593. CD-Box would not be the program it is without the help from the following
  1594.   people - thanks to the net!
  1595.  
  1596. - Anthony Rumble, for his sources in Pascal of .CMF & .VOC routines 
  1597.     (distributed as SBUTIL11.EXE). I have made my own librairies for .CMF now, 
  1598.     but the critical routines were all supplied by Anthony. Thanks. Now I
  1599.     need routines for all the other formats...
  1600.  
  1601. - Mark J. Cox for his MODOBJ package which I happily registered, giving CD-Box
  1602.     the opportunity to play great sounding Amiga soundtracks by itself, with a
  1603.     few extra features thrown in (.MOD controls). Mark J Cox is also the
  1604.     author of ModPlay, a terrific freeware .MOD player which I highly
  1605.     recommend; if you don't have it, go GET IT! (The latest version should be
  1606.     at info.brad.uk, in /misc/msdos/mp.)
  1607.  
  1608. - Victor Langeveld for reporting two bugs in CD-Box v2.01 with enough detail
  1609.     to get them fixed in CD-Box v2.10; my heartest thanks. :-)
  1610.  
  1611. - Ed Haymore for prompting me to implement the temporary drive redirection,
  1612.     and for the main idea behind file selecting.
  1613.  
  1614. - Bjorn Karlsen for prompting for keyboard support and volume control.
  1615.  
  1616. - Thomas Wagner for his public domain EXEC function with memory swap. I've 
  1617.     used version 3.1 (August 91) in CD-Box (the "swap=yes" statement in
  1618.     CD-BOX.CFG invokes Thomas' function). Great work, Thomas!
  1619.  
  1620. - Dave Komatsu, editor of the Sound Newsletter, and Keith Petersen, maintainer
  1621.     of the MSDOS archives at SIMTEL, for having accepted my submission
  1622.     (starting with v2.01)! Also, more thanks to Dave for uploading this
  1623.     version and the previous one as I have not been on the net for
  1624.     some time.
  1625.  
  1626. - Bruno Deltour for aesthetic remarks; Alain Rousseau for providing me many
  1627.     files from the net when I didn't have access to it; Jean-Francois Moufle
  1628.     for drawing the car (now much reduced) driving across the bottom of the
  1629.     screen at odd times (yes, I did draw all the other graphics, and no, I'm
  1630.     not an artist!); and various friends and relations for their stumbling on
  1631.     (thankfully rare) bugs, helpful comments and encouragement.
  1632.  
  1633. I hope you enjoy the song New Entertainer in the CDBOX220.ZIP archive - I
  1634.   programmed it myself! It is based, of course, on Scott Joplin's remarkable
  1635.   Entertainer (from the movie whose French title is "L'arnaque", and the
  1636.   English title I don't know), so the credit is his. Off Balance, on the
  1637.   other hand, is entirely mine.
  1638.  
  1639.  
  1640. ══════════════════════════════════════════════════════════════════════════════
  1641.  
  1642.                     PART VII: LICENSE & ABSENCE OF WARRANTY
  1643.  
  1644. ══════════════════════════════════════════════════════════════════════════════
  1645.  
  1646. The word "software" below refers to the three files CD-BOX.EXE, CD-BOX.DOC and
  1647.   CD-BOX.CFG.
  1648.  
  1649. You may copy this software as many times as you like, give it to anyone, and
  1650.   distribute it via electronic means. This software may also be distributed in
  1651.   shareware and/or public domain libraries that charge for copying and
  1652.   distributing disks, NOT for the software itself.
  1653.  
  1654. You may NOT charge or request a donation for a copy of this software, however
  1655.   made; and you may NOT distribute this program and/or documentation with
  1656.   commercial products without handwritten permission from the author.
  1657.  
  1658. THIS SOFTWARE MAY NOT BE GIVEN AWAY OR DISTRIBUTED WITHOUT ITS DOCUMENTATION;
  1659.   AND NEITHER PROGRAM NOR DOCUMENTATION MAY BE ALTERED IN ANY WAY.
  1660.  
  1661. CD-Box is delivered "AS IS" with no promise to its performance or fitness for
  1662.   a particular purpose. CD-BOX COMES WITH NO GUARANTEE OF ANY KIND, NOR IS THE
  1663.   AUTHOR LIABLE FOR DAMAGES OF ANY KIND. The person using this software
  1664.   assumes all the risks.
  1665.  
  1666. You may modify CD-BOX.CFG for your own personal use, but don't distribute the 
  1667.   modified version.
  1668.  
  1669. If you use this software, you must pay the registration fee.
  1670.  
  1671. The software and documentation are copyrighted (C) Jeffrey Belt 1992.
  1672. All trademarks and registered names are acknowledged.
  1673.  
  1674. Do NOT use CD-Box if you do not agree to this license.
  1675.  
  1676.  
  1677. ══════════════════════════════════════════════════════════════════════════════
  1678. The bottom line
  1679. ──────────────────────────────────────────────────────────────────────────────
  1680.  
  1681. CD-BOX IS SHAREWARE.
  1682. CD-BOX COMES WITH NO WARRANTY.
  1683. CD-BOX CANNOT BE USED FOR COMMERCIAL GAIN.
  1684. CD-BOX MUST BE DISTRIBUTED WITH THIS DOCUMENTATION.
  1685.  
  1686. The above is simply to make sure that:
  1687.  
  1688.   * You can copy and give CD-Box to anyone, and use it without any qualms,
  1689.       once you registered of course :-)
  1690.  
  1691.   * Distributing CD-Box won't make me any trouble - hey, I'm giving it away
  1692.       for peanuts!
  1693.  
  1694.   * This documentation stays with CD-Box; it contains acknowledgements and
  1695.       thanks to people who deserve it. Intellectual property is something many
  1696.       people don't seem to understand.
  1697.  
  1698.  
  1699. ══════════════════════════════════════════════════════════════════════════════
  1700.  
  1701.                         PART VIII: REGISTERING CD-BOX
  1702.  
  1703.                CD-BOX IS SHAREWARE. THE REGISTRATION FEE IS $10.
  1704.  
  1705. ══════════════════════════════════════════════════════════════════════════════
  1706. *** Rationale: why CD-Box is shareware
  1707. ──────────────────────────────────────────────────────────────────────────────
  1708.  
  1709. My reasons for shareware are:
  1710.  
  1711.   - development costs mainly (more than $250 now): I had to register other
  1712.       shareware routines for use in CD-Box; looking for precise info on mice
  1713.       and the sound cards is not cheap in the long run; and neither was access
  1714.       to the net, which was vital for the development of CD-Box (upload and
  1715.       download). Also, since it looks like I'll have to buy a number of
  1716.       development kits for internal support, really big expenses are on the
  1717.       horizon.
  1718.  
  1719.   - maintaining this documentation is one big bore.
  1720.  
  1721.   - most of my time is spent trying to track down bugs for users with exotic
  1722.       configurations, and not for creative development which I like best.
  1723.       Improving CD-Box I do for free (and have done so for more than a year);
  1724.       working on funny mouse drivers, weird VGA cards and tricky sound formats
  1725.       I don't any more, thank you. CD-Box works perfectly on MY machine, so I
  1726.       want it to be worth the trouble to fix it for others.
  1727.  
  1728. This is why CD-Box is shareware since v2.11. Registration will:
  1729.  
  1730.   - remove the "unregistered copy" messages;
  1731.  
  1732.   - unlock the .MOD controls and enable internal support for .VOC files of
  1733.       more than 100 KB;
  1734.  
  1735.   - help me get even with the costs for continued development. I'm not doing
  1736.       this for money, but I want to stop throwing it away;
  1737.  
  1738.   - increase the priority of bug reports and suggestions for improvement over
  1739.       those of unregistered users;
  1740.  
  1741.   - automatically register you for all future versions of CD-Box I release.
  1742.  
  1743. I don't want CD-Box to be nagware or crippleware, but I also know that people
  1744.   are more inclined to pay if they get a little something more. I hope I
  1745.   struck the right balance.
  1746.  
  1747.  
  1748. ══════════════════════════════════════════════════════════════════════════════
  1749. *** Registering CD-Box
  1750. ──────────────────────────────────────────────────────────────────────────────
  1751.  
  1752. CD-Box must be registered for a minimum fee of $10 ($8 raw fee + $1 my answer
  1753.   to you + $1 bank commission). If you send $15 or more, I'll also send you
  1754.   the next version of CD-Box if and when available. If the next version is
  1755.   slow in coming, I'll refund the money if you want to, minus $10 since you'll
  1756.   already have a registration number. Note that all future versions of CD-Box
  1757.   should be available the same way you got this version - so you don't have to
  1758.   send more than $10. See, I'm being frank with you.
  1759.  
  1760. Registrating CD-Box will remove the "unregistered copy" messages at startup
  1761.   and shutdown and unlock the .MOD controls.
  1762.  
  1763. US dollars are used for convenience; ANY currency will do, as long as it
  1764.   amounts to the sums given above; take bank commission into account. French
  1765.   users don't have to pay a bank commission, since French Francs is the money
  1766.   I use: the French registration fee is 50 Francs; 65 Francs or more to have
  1767.   the next version mailed when available.
  1768.  
  1769. Some people who have helped me in the past pointing out bugs and giving useful
  1770.   suggestions (and you know who you are) simply have to write me to get their
  1771.   registration number (that includes all the people I thanked in the "Thanks
  1772.   to..." section above). I'm grateful for the help they gave me.
  1773.  
  1774. To register, send a check (no cash nor VISA accepted) to:
  1775.  
  1776.                          Jeffrey BELT
  1777.                          7 rue de la Garenne
  1778.                          77240 - CESSON
  1779.                          FRANCE
  1780.  
  1781. Checks have to be to the order of Jeffrey Belt.
  1782.  
  1783. Include a letter, postcard, or any other piece of paper stating:
  1784.  
  1785.   - YOUR FULL NAME (extremely important for the registration number) and the
  1786.       address where the registration instructions should be mailed;
  1787.  
  1788.   - where you got CD-Box (which server, list, BBS, shareware distribution
  1789.       company...), and which version you have (this one is v2.20);
  1790.  
  1791.   - any comments or suggestions you wish to make.
  1792.  
  1793. In return I'll send you a registration number and tell you how to unlock
  1794.   CD-Box.
  1795.  
  1796. If you send $15 or more, please state if you want the next version sent on
  1797.   another disk than a 3'1/2 720 KB disk. Don't expect to receive immediately
  1798.   the next version, it may not be ready yet (I've got to program and test this
  1799.   stuff!), but it will be sent to you as soon as it is ready.
  1800.  
  1801.  
  1802. ══════════════════════════════════════════════════════════════════════════════
  1803. *** Comments or suggestions?
  1804. ──────────────────────────────────────────────────────────────────────────────
  1805.  
  1806. To my greatest sorrow I currently have no access to the net, until further
  1807.   notice. I therefore have no e-mail address. But snail mail works, so don't
  1808.   hesitate to write! It's the only way I can get feedback to continue work on
  1809.   this program.
  1810.  
  1811. ******************************************************************************
  1812. ***                                                                        ***
  1813. ***  I really insist on user feedback. It's been the driving force behind  ***
  1814. ***  CD-Box's improvements since it was launched on the net. Now that I'm  ***
  1815. ***  no longer on the net, feedback is much more important - I know        ***
  1816. ***  snail-mail is more trouble than e-mail, but still! A simple postcard  ***
  1817. ***  is enough. And if you wish to write me for comments or suggestions,   ***
  1818. ***  you are most WELCOME!                                                 ***
  1819. ***                                                                        ***
  1820. ***                     Jeffrey Belt                                       ***
  1821. ***                     7 rue de la Garenne                                ***
  1822. ***                     77240 - CESSON                                     ***
  1823. ***                     FRANCE                                             ***
  1824. ***                                                                        ***
  1825. ******************************************************************************
  1826.