home *** CD-ROM | disk | FTP | other *** search
/ ftp.cdrom.com/pub/cdrom/ / cdrom.tar / cdrom / cdutils / cd-v13.txt < prev    next >
Text File  |  1994-09-24  |  7KB  |  175 lines
  1. ===============================================================================
  2.                           CD-V     ver     1.3
  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
  22. I found nothing for DOS. Since I don't like using the mouse in text mode, I
  23. wrote a graphic player.
  24.  
  25. The program has a very simple interface and includes all the buttons one would
  26.   expect to find in a CD player.
  27.  
  28. The bottom row of buttons corresponds to usual commands (e.g. stop,play) where
  29.   the play button serves also as pause (toggle).
  30. The eject/close-tray button is on the right of the time display. When ejected
  31.   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
  35.   or decreasing time),Play mode (sequential or ordered),Volume control 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.
  42.  
  43.  
  44. Instructions
  45. ------------
  46. I will provide instructions only for what isn't obvious.
  47.  
  48. Configuration :
  49.         If a file called "cd-v.cfg" exists in the directory cd-v is run from,
  50. cd-v will read it's configuration from it. A sample file is included.
  51. The format is spartanic : The first number indicates the number of seconds to
  52. wait for the activation of the screen saver. A zero disables the screen saver.
  53. The second number indicates the starting volume level (ranging 0 to 255). A
  54. negative number means that the current volume level should be used.
  55. The following 4 numbers indicate the initial state of 4 of the togglers :
  56. Track display, Statistics display, Direction and Volume control, by that order.
  57. 0 means the togglers are off and 1 (or any other) that they are on.
  58. The following 16 numbers are the palette values. If the first of them is
  59. negative, all are ignored. If not, the values are read into the system palette.
  60. Given with the included configuration file are the numbers for the default
  61. gray-level palette. The numbers there correspond to the following colors :
  62.  
  63. BLACK          0
  64. BLUE           1
  65. GREEN          2
  66. CYAN           3
  67. RED            4
  68. MAGENTA        5
  69. LIGHTGRAY      7
  70. BROWN         20
  71. DARKGRAY      56
  72. LIGHTBLUE     57
  73. LIGHTGREEN    58
  74. LIGHTCYAN     59
  75. LIGHTRED      60
  76. LIGHTMAGENTA  61
  77. YELLOW        62
  78. WHITE         63
  79.  
  80. As an example, changing between the entry containing 63 and the one containing
  81. 56 will result in all the buttons and raised levels to be reversed (i.e.
  82. pressed instead of raised and raised instead of pressed).
  83.  
  84.  
  85. Track order selection :
  86.         Press the Play-Mode button (drawn as 1-2-3 on diagonal) and the track
  87. order list should appear as well as the track selection box (if it wasn't
  88. visible). If this is the first time this mode is selection during a run of the
  89. program, the list would be empty and the first play whould appear as a pressed
  90. button. Selection a track from the track list changes the number in the
  91. currently pressed button in the order list. After selecting the first track,
  92. depress the next button and choose a track similarly.
  93. When choosing from the order list, you can always choose one of the tracks
  94. previously selected or the next-to-last selected track. You can't choose a
  95. specific button from the order list if there is an empty slot above it.
  96. When leaving this mode, the track selection box will disappear if it wasn't
  97. visible when you entered the mode, or remain visible if it was visible before
  98. entering the mode.
  99. The about box will disappear and not return if it was visible before entering
  100. the mode.
  101.  
  102. AutoRepeat :
  103.         When pressing a button longer than 1Sec, it gets released and if still
  104. pressed, will activate every 0.1Sec. Thus allowing true FF ,REW ,SKIP and PREV.
  105. The volume control autorepeat is faster ; The delay is only 0.5Sec and then then
  106. the button gets pressed every 0.01Sec (which is actually zero) and the volume is
  107. changed by a larger amount (10 levels instead of one with single press).
  108.  
  109.  
  110. Requirements
  111. ------------
  112. The program expects to find the following :
  113.  
  114. - Microsoft compatible mouse and driver
  115. - MSCDEX version 2.20 or up
  116. - VGA adapter
  117. - 386
  118.  
  119.  
  120. Author
  121. ------
  122. The author can be reached by e-mail address :
  123.  
  124.         igrutman@bguee.bgu.ac.il
  125.  
  126. Please send any observation, remark or suggestion you might have.
  127. I will try and code your suggestions if I like them and have the time.
  128.  
  129.  
  130. Thanks
  131. ------
  132. To Paul <something>, for being the first to contact me about the program.
  133.  
  134.  
  135. History
  136. -------
  137. 0.1  -  First version.
  138.  
  139. 0.2  -  Fixed bugs :
  140.         1. Font and screen drivers not found when run from another directory.
  141.            Fixed by moving them into the code thus leaving the only necessary
  142.            file to be cd-v.exe
  143.         2. Track length not updated in statistics window when track was changed
  144.            indirectly (by ff, rewind, or track finish).
  145.  
  146. 1.0  -  Added Track order selection for playing and indication of play mode
  147.         at the top-right corner of the time display.
  148.  
  149. 1.1  -  Fixed bugs :
  150.         1. Memory access violations causing strange screen behaviour.
  151.         2. When clicking on a blank slot from the track list, a number appeared.
  152.         3. Incorrect disk length when playing entire disk.
  153.  
  154. 1.2  -  Fixed bugs :
  155.         1. When entering without a CD and the tray closed, the button would
  156.            operate properly (not operate) but would not get whited.
  157.         2. Tracks higher than 19 caused trouble due to incorrect BCD to decimal
  158.            conversion.
  159.  
  160.         Added features:
  161.         1. Added the ability to exit with the ESC key. ESC now functions as PWR.
  162.         2. Added AutoRepeat feature. When pressing a button longer than 1Sec, it
  163.            gets released and if still pressed, will activate every 0.1Sec. Thus
  164.            allowing true FF ,REW ,SKIP and PREV.
  165.         3. Added screen-saving ability.
  166.         4. Added configuration file cd-v.cfg
  167.  
  168. 1.3  -  Added features:
  169.         1. Added volume control.
  170.         2. Added the ability to change the system palette from the configuration
  171.            file.
  172.         3. Added the ability to change the initial state of commonly used
  173.            togglers.
  174.  
  175.