home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / CD_V16.ZIP / CD-V.DOC < prev    next >
Encoding:
Text File  |  1994-09-30  |  11.4 KB  |  248 lines
  1. ===============================================================================
  2.                           CD-V     ver     1.6
  3. ===============================================================================
  4.  
  5.                          An Audio-CD VGA Player
  6.  
  7.                              Itamar Grutman
  8.                                  Israel
  9.                                   1994
  10.  
  11. ===============================================================================
  12.  
  13.     This program was put as Public Domain by the author and may be distributed
  14. freely. It may not be sold, nor be made part of anything that is sold.
  15.  
  16. ===============================================================================
  17.  
  18. Description
  19. ===========
  20.     This program was written to fulfill my need for a VGA-based audio-cd player
  21. for DOS. It seemed that all the nice CD players were written for windows and I
  22. found nothing for DOS. Since I don't like using the mouse in text mode, I wrote
  23. a graphic player.
  24.  
  25.     The program has a very simple interface and includes all the buttons one
  26. would expect to find in an advanced CD player as well as a blank screen saver.
  27.  
  28.     The bottom row of buttons corresponds to usual commands (e.g. stop,play)
  29. where the play button serves also as pause (toggle).
  30.     The eject/close-tray button is on the right of the time display. When
  31. ejected or not ready, all buttons (except eject and PWR) are grayed (whited).
  32.     The top row of buttons contains special purpose buttons, which are (from
  33. left to right) : Power, Track display(enables to select a track), Statistics
  34. display(Show totals and progress bars), Direction(Toggles between increasing or
  35. decreasing time),Play mode (sequential, ordered or loop),Volume control,Mute and
  36. finally - About.
  37.     All the top row buttons are togglers (except PWR, of course).
  38.  
  39.  
  40. NOTE :  Volume control will work only for those devices that support it. It does
  41.         not make use of the sound card, therefore, the sound card itself should
  42.         be set to it's maximum level to get the full scale of the volume bar.
  43.  
  44.  
  45. Instructions
  46. ============
  47. I will provide instructions only for what isn't obvious.
  48.  
  49. Screen saver
  50. ------------
  51.     Will either operate after a specified time (see configuration) of no
  52. movement or when the mouse is moved to the upper-left corner of the screen and
  53. remains idle there for 1 second.
  54. Moving the mouse or pressing a letter key on the keyboard will shut off the
  55. screen saver and return the program to the screen.
  56.  
  57. Configuration
  58. -------------
  59.     Run cdconfig to change your defaults. Note that cdconfig modifies your
  60. executable, so don't run it after compressing cd-v.exe.
  61.     When in color configuration, you will have to specify your prefered colors
  62. for every item in cd-v. Most names in the configuration may not be obvoius and
  63. may need some explaining :
  64.  
  65. Button Face          - Button surface
  66. Frame Face           - Frame surface
  67. Background Color     - Background color for entire screen
  68. Screen Color         - Color for main data screen
  69. Title Color          - Color for background of the titles of boxes
  70. Active Text          - Color for active text and buttons (titles, time and
  71.                        sometimes buttons).
  72. Inactive Text        - Color for inactive text and buttons.
  73. Info Text            - Color for misc. info (play mode)
  74. Box Background Color - Color for box background (volume, track, order, about)
  75. Main Color           - Color for main screen background (main screen is the
  76.                        screen containing all vital buttons and the main data
  77.                        screen - It is what is left when all options are set
  78.                        to "off").
  79. Lighted sides        - Color for lighted sides of buttons and frames. Swapping
  80.                        it's value with that of "Dark sides" causes the 3d-look
  81.                        to be reversed.
  82. Dark sides           - Color for dark (unlighted) sides of buttons and frames.
  83. Border color         - Color for border of buttons and frames. Every button and
  84.                        frame is surrounded by a 1-pixel width line, which is
  85.                        normally black.
  86.  
  87. NOTE - keeping button face and frame face at light-gray, and not changing dark
  88.        and lighted sides ensures that the 3d-look is maintained. All other
  89.        colors may be changed freely and satisfactory results can easily be
  90.        achieved.
  91.  
  92. Track order selection
  93. ---------------------
  94.     Press the Play-Mode button (drawn as 1-2-3 on diagonal) until ORD mode is
  95. indicated in the main window, and the track order list should appear as well as
  96. the track selection box (if it wasn't visible). The track list box will appear
  97. a bit different in this mode - instead of the heading ("Tracks"), there will be
  98. 2 buttons which functionality will be explained below.
  99.     If this is the first time this mode is selection during a run of the
  100. program, the list would be almost empty and the first entry whould appear as a
  101. pressed button with the value of 1.
  102.     Selection of a track from the track list changes the number in the currently
  103. pressed button in the order list and depresses the next slot on the order list.
  104. A specific slot in the order list can be selected by the mouse, and it's track
  105. number can be changed by the same way. Pressing the key '+' (or the key selected
  106. in the config file, defaulted to '`'),or the button marked '+' at the top of the
  107. track list, or the right mouse button when the cursor is positioned on the track
  108. list box, will depress a new empty slot in the bottom of the order list, if
  109. there is an empty one.
  110.     When choosing from the order list, you can always choose one of the tracks
  111. previously selected or the next-to-last selected track. You can't choose a
  112. specific button from the order list if there is an empty slot above it.
  113.     To erase the last entry to the list press the button marked '-' on the top
  114. of the track list, or press the RIGHT mouse button when the mouse pointer is
  115. positioned on any of the buttons of the order list. Keeping the button pressed
  116. longer the 2 secs will activate the autorepeat feature which will erase an entry
  117. every 0.2 secs as long as the button is pressed.
  118.     If your have a 3-BUTTON MOUSE, pressing the middle button while the cursor
  119. is positioned on the track list box, will cause the slot above the currently
  120. pressed to be active.
  121.     When leaving this mode, the track selection box will disappear if it wasn't
  122. visible when you entered the mode, or remain visible if it was visible before
  123. entering the mode.
  124.     Entering this mode another time will display the previously set list. The
  125. mode is NOT functional, however, when the list is not DISPLAYED.
  126.     The about box will disappear and not return (unless pressed again) if it was
  127. visible before entering the mode.
  128.  
  129. AutoRepeat
  130. ----------
  131.     When pressing a button longer than 1Sec, it gets released and if still
  132. pressed, will activate every 0.1Sec. Thus allowing true FF ,REW ,SKIP and PREV.
  133. The volume control autorepeat is faster ; The delay is only 0.5Sec and then then
  134. the button gets pressed every 0.01Sec (which is actually zero) and the volume is
  135. changed by a larger amount (10 levels instead of one with single press).
  136.     Note that some buttons have other delay values (see above).
  137.  
  138.  
  139. Requirements
  140. ============
  141. The program expects to find the following :
  142.  
  143. - Mouse (3-Button mouse is prefered)
  144. - MSCDEX version 2.20 or up
  145. - VGA adapter
  146. - 386
  147.  
  148.  
  149. Author
  150. ======
  151. The author can be reached by e-mail address :
  152.  
  153.         igrutman@bguee.bgu.ac.il
  154.  
  155. Please send any observation, remark or suggestion you might have.
  156. I will try and code your suggestions if I like them and have the time.
  157.  
  158.  
  159. Thanks
  160. ======
  161. To Paul <something>, for being the first to contact me about the program.
  162.  
  163.  
  164. History
  165. =======
  166. 0.1  -  First version.
  167.  
  168. 0.2  -  Fixed bugs :
  169.         1. Font and screen drivers not found when run from another directory.
  170.            Fixed by moving them into the code thus leaving the only necessary
  171.            file to be cd-v.exe
  172.         2. Track length not updated in statistics window when track was changed
  173.            indirectly (by ff, rewind, or track finish).
  174.  
  175. 1.0  -  Added Track order selection for playing and indication of play mode
  176.         at the top-right corner of the time display.
  177.  
  178. 1.1  -  Fixed bugs :
  179.         1. Memory access violations causing strange screen behaviour.
  180.         2. When clicking on a blank slot from the track list, a number appeared.
  181.         3. Incorrect disk length when playing entire disk.
  182.  
  183. 1.2  -  Fixed bugs :
  184.         1. When entering without a CD and the tray is closed, the button would
  185.            operate properly (not operate) but would not get whited.
  186.         2. Tracks higher than 19 caused trouble due to incorrect BCD to decimal
  187.            conversion.
  188.  
  189.         Added features:
  190.         1. Added the ability to exit with the ESC key. ESC now functions as PWR.
  191.         2. Added AutoRepeat feature. When pressing a button longer than 1Sec, it
  192.            gets released and if still pressed, will activate every 0.1Sec. Thus
  193.            allowing true FF ,REW ,SKIP and PREV.
  194.         3. Added screen-saving ability.
  195.         4. Added configuration file cd-v.cfg
  196.  
  197. 1.3  -  Added features:
  198.         1. Added volume control.
  199.         2. Added the ability to change the system palette from the configuration
  200.            file.
  201.         3. Added the ability to change the initial state of commonly used
  202.            togglers.
  203.  
  204. 1.4  -  Added features:
  205.         1. Added mute button.
  206.         2. Added "sleep now" corner.
  207.         3. Ablitity to erase last entry from order list.
  208.         4. Use of the keyboard key '+' to add an empty entry to the order list
  209.            thus enabling faster filling of the list without running the mouse
  210.            back and forth.
  211.  
  212.         Arbitrary changes:
  213.         1. Swapped places of the buttons SKIP with PREV and FF with REW.
  214.  
  215.         Fixed bugs:
  216.         1. The program would terminate when pressing SKIP or PREV in ordering
  217.            mode and with the list empty. The list is now never really empty.
  218.  
  219. 1.5  -  Added features:
  220.         1. Added an entry in the config file to select one more key to function
  221.            as the key '+'.
  222.         2. Added two buttons on the track order selection buttons : Add new
  223.            entry and Remove last entry.
  224.  
  225. 1.6  -  Added features:
  226.         1. Added loop mode.
  227.         2. Added extensive color configuration.
  228.  
  229.         Arbitrary changes:
  230.         1. Choosing from the track list while in ORD mode causes the currently
  231.            pressed slot to descend.
  232.         2. In ORD, Pressing the middle button (on a 3-button mouse, and an
  233.            appropriate driver), while positioned in the track list box, causes
  234.            the currently selected slot to ascend.
  235.         3. In ORD, Pressing the right button, while positioned in the track list
  236.            box, causes the currently selected slot to descend.
  237.         4. When in SEQ mode, selecting a track from the track list starts
  238.            it, whether the player was playing before or not.
  239.         5. Changed length of "sleep-now" duartion from 2 to 1 Sec.
  240.         6. Removed configuration of system palette.
  241.         7. Move "+" and "-" buttons from the order list to the track box, during
  242.            ORD mode.
  243.  
  244.         Fixed bugs:
  245.         1. When in ordered mode, and the last selected track has finished, the
  246.            player would return to track 1 instead of the first selected track.
  247.  
  248.