home *** CD-ROM | disk | FTP | other *** search
/ ftp.cdrom.com/pub/cdrom/ / cdrom.tar / cdrom / cdutils / cd-v14.txt < prev    next >
Text File  |  1994-09-26  |  9KB  |  205 lines
  1. ===============================================================================
  2.                           CD-V     ver     1.4
  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 or ordered),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.     Will either operate after a specified time (see configuration) of no
  51. movement or when the mouse is moved to the upper-left corner of the screen and
  52. remains idle there for 2 seconds.
  53. Moving the mouse or pressing a letter key on the keyboard will shut off the
  54. screen saver and return the program to the screen.
  55.  
  56. Configuration :
  57.     If a file called "cd-v.cfg" exists in the directory cd-v is run from, cd-v
  58. will read it's configuration from it. A sample file is included.
  59. The format is spartanic : The first number indicates the number of seconds to
  60. wait for the activation of the screen saver. A zero disables the screen saver.
  61. The second number indicates the starting volume level (ranging 0 to 255). A
  62. negative number means that the current volume level should be used.
  63. The following 4 numbers indicate the initial state of 4 of the togglers :
  64. Track display, Statistics display, Direction and Volume control, by that order.
  65. 0 means the togglers are off and 1 (or any other) that they are on.
  66. The following 16 numbers are the palette values (which I highly recommend not to
  67. change). If the first of them is negative, all are ignored. If not, the values
  68. are read into the system palette.
  69. Given with the included configuration file are the numbers for the default
  70. gray-level palette. The numbers there correspond to the following colors :
  71.  
  72. BLACK          0
  73. BLUE           1
  74. GREEN          2
  75. CYAN           3
  76. RED            4
  77. MAGENTA        5
  78. LIGHTGRAY      7
  79. BROWN         20
  80. DARKGRAY      56
  81. LIGHTBLUE     57
  82. LIGHTGREEN    58
  83. LIGHTCYAN     59
  84. LIGHTRED      60
  85. LIGHTMAGENTA  61
  86. YELLOW        62
  87. WHITE         63
  88.  
  89.     As an example, changing between the entry containing 63 and the one
  90. containing 56 will result in all the buttons to be reversed (i.e. pressed
  91. instead of raised and raised instead of pressed).
  92.  
  93.  
  94. Track order selection :
  95.     Press the Play-Mode button (drawn as 1-2-3 on diagonal) and the track order
  96. list should appear as well as the track selection box (if it wasn't visible). If
  97. this is the first time this mode is selection during a run of the program, the
  98. list would be almost empty and the first entry whould appear as a pressed button
  99. with the value of 1.
  100. Selection of a track from the track list changes the number in the currently
  101. pressed button in the order list. After selecting a track, depress the next
  102. button or press the key '+' and choose a track similarly.
  103.     When choosing from the order list, you can always choose one of the tracks
  104. previously selected or the next-to-last selected track. You can't choose a
  105. specific button from the order list if there is an empty slot above it.
  106.     To erase the last entry to the list press the RIGHT mouse button when the
  107. mouse pointer is located on any of the buttons of the list. Keeping the button
  108. pressed longer the 2 secs will activate the autorepeat feature which will erase
  109. an entry every 0.2 secs as long as the button is pressed.
  110.     When leaving this mode, the track selection box will disappear if it wasn't
  111. visible when you entered the mode, or remain visible if it was visible before
  112. entering the mode.
  113.     Entering this mode another time will display the previously set list. The
  114. mode is NOT functional, however, when the list is not DISPLAYED.
  115.     The about box will disappear and not return if it was visible before
  116. entering the mode.
  117.  
  118. AutoRepeat :
  119.     When pressing a button longer than 1Sec, it gets released and if still
  120. pressed, will activate every 0.1Sec. Thus allowing true FF ,REW ,SKIP and PREV.
  121. The volume control autorepeat is faster ; The delay is only 0.5Sec and then then
  122. the button gets pressed every 0.01Sec (which is actually zero) and the volume is
  123. changed by a larger amount (10 levels instead of one with single press).
  124.  
  125.  
  126. Requirements
  127. ------------
  128. The program expects to find the following :
  129.  
  130. - Microsoft compatible mouse and driver
  131. - MSCDEX version 2.20 or up
  132. - VGA adapter
  133. - 386
  134.  
  135.  
  136. Author
  137. ------
  138. The author can be reached by e-mail address :
  139.  
  140.         igrutman@bguee.bgu.ac.il
  141.  
  142. Please send any observation, remark or suggestion you might have.
  143. I will try and code your suggestions if I like them and have the time.
  144.  
  145.  
  146. Thanks
  147. ------
  148. To Paul <something>, for being the first to contact me about the program.
  149.  
  150.  
  151. History
  152. -------
  153. 0.1  -  First version.
  154.  
  155. 0.2  -  Fixed bugs :
  156.         1. Font and screen drivers not found when run from another directory.
  157.            Fixed by moving them into the code thus leaving the only necessary
  158.            file to be cd-v.exe
  159.         2. Track length not updated in statistics window when track was changed
  160.            indirectly (by ff, rewind, or track finish).
  161.  
  162. 1.0  -  Added Track order selection for playing and indication of play mode
  163.         at the top-right corner of the time display.
  164.  
  165. 1.1  -  Fixed bugs :
  166.         1. Memory access violations causing strange screen behaviour.
  167.         2. When clicking on a blank slot from the track list, a number appeared.
  168.         3. Incorrect disk length when playing entire disk.
  169.  
  170. 1.2  -  Fixed bugs :
  171.         1. When entering without a CD and the tray is closed, the button would
  172.            operate properly (not operate) but would not get whited.
  173.         2. Tracks higher than 19 caused trouble due to incorrect BCD to decimal
  174.            conversion.
  175.  
  176.         Added features:
  177.         1. Added the ability to exit with the ESC key. ESC now functions as PWR.
  178.         2. Added AutoRepeat feature. When pressing a button longer than 1Sec, it
  179.            gets released and if still pressed, will activate every 0.1Sec. Thus
  180.            allowing true FF ,REW ,SKIP and PREV.
  181.         3. Added screen-saving ability.
  182.         4. Added configuration file cd-v.cfg
  183.  
  184. 1.3  -  Added features:
  185.         1. Added volume control.
  186.         2. Added the ability to change the system palette from the configuration
  187.            file.
  188.         3. Added the ability to change the initial state of commonly used
  189.            togglers.
  190.  
  191. 1.4  -  Added features:
  192.         1. Added mute button.
  193.         2. Added "sleep now" corner.
  194.         3. Ablitity to erase last entry from order list.
  195.         4. Use of the keyboard key '+' to add an empty entry to the order list
  196.            thus enabling faster filling of the list without running the mouse
  197.            back and forth.
  198.  
  199.         Arbitrary changes:
  200.         1. Swapped places of the buttons SKIP with PREV and FF with REW.
  201.  
  202.         Fixed bugs:
  203.         1. The program would terminate when pressing SKIP or PREV in ordering
  204.            mode and with the list empty. The list is now never really empty.
  205.