home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / Audio / CDGPLY / CDGPLAY.DOC next >
Encoding:
Text File  |  1996-11-28  |  9.9 KB  |  243 lines
  1. CDGPLAY Version 1.0 - This is the second public release of CDGPLAY
  2. Homepage:  http://www.ncf.carleton.ca/~aa571/index.html
  3.  
  4. CDGPLAY - What is it?
  5. ---------------------
  6. CDGPLAY is a DOS command line utility that displays the graphics
  7. contained on CD+G audio CDs.  It will display either: 
  8.  - from a CDG file (like one produced by another of my programs CDDA) 
  9.  - directly from the CD while it is playing.  
  10. It now supports SCSI drives through the ASPI drivers, ATAPI drives 
  11. through the ASPI drivers in Windows 95, and ATAPI drives through the 
  12. ATASPI drivers.
  13.  
  14. I am not aware of any other programs like this for the PC under DOS.  
  15. There is a similar program for the MAC 
  16. (see: http://www.thepalace.com/jbum/software.html),
  17. and I know that there is one for Linux under development.
  18.  
  19. This program runs best under DOS.  It is sometimes very unhappy
  20. when you try to run it under a Win DOS window.  It also
  21. is happiest when you have a VESA compliant video card. 
  22.  
  23. I have had a number of questions from people wanting to know why I don't
  24. put the screen in 320x200 mode and make the image larger.  The main
  25. reason is that the graphics coming from the CD are roughly 320x230
  26. and that would mean cutting off the bottom of the display.  On many CDs
  27. this is that area that has the lyrics displayed, so I decided to go
  28. for the 600x400 mode instead.
  29.  
  30. Where can I get the most recent version?
  31. ----------------------------------------
  32. You can find pointers to the most recent versions of all my software
  33. on my homepage:
  34. http://www.ncf.carleton.ca/~aa571
  35.  
  36. Acknowledgements
  37. ----------------
  38. I need to acknowledge the help I received in writing this
  39. program.
  40.  
  41. 1) Jim Bumgardner - he wrote the version for the MAC, and then
  42.    release his source and a technical document discussing CD+G.
  43.    I had given up trying to get the spec from Philips when they
  44.    told me that the price was $20,000.00 US, but Jim saved the day.
  45. 2) Heiko Eissfeltd - he is writing a version for Linux, and has
  46.    sent me a number of iterations of source code.  Some of that
  47.    code (which is copyrighted) is contained in CDGPLAY.
  48.  
  49. What drives are supported by this program?
  50. ------------------------------------------
  51. This release now supports SCSI and ATAPI cdrom drives.
  52. SCSI drives must be run from ASPI drivers, and ATAPI drives must
  53. be run from ASPI drivers under Win95, or ATASPI drivers under DOS.
  54.  
  55. What drives support CD+G?
  56. -------------------------
  57. The following is a list of drives that I understand will work with
  58. this program.  I have the Sony 76S, and have also tested the Plextor
  59. 4Plex+.
  60.  
  61. Apple 300, 300i, 300e (Sony CDU-8003, CDU-8003A)
  62. Apple CD300+, CD600+
  63. Plextor 4Plex+, 8Plex (the 4Plex and 6Plex don't support CD+G)
  64. Sony CDU-561, CDU-55S, CDU-76S
  65. Toshiba 5401 (this drive may not work as I have not had
  66.               a chance to test it)
  67. .... and a number of ATAPI drives that I have not been able to test.
  68.  
  69. How do I use this program?
  70. --------------------------
  71. The program has a number of command line switches.
  72.  
  73. The /F <filename> option forces CDGPLAY to use the CDG file specified
  74. to display the graphics instead of reading from the CD.
  75.  
  76. The /ID <HA:ID:LUN> option allows you to manually set the SCSI ID of 
  77. the CDROM drive you want to use.  This is useful if this software incorrectly
  78. guesses your drive's ID, or if you have more than one CDROM drive
  79. in your system.  The HA is the ID of the Host Adapter, the ID is the ID
  80. of the SCSI cdrom drive, and the LUN is the Logical Unit Number of the
  81. SCSI cdrom drive.  If you are not sure about these values, you can
  82. use one of my programs SCSIPING (shipped with CDDA) and it will tell
  83. you how your drive is configured.
  84.  
  85. The /MSC <drive letter> option allows you to manually set the MSCDEX drive 
  86. letter of the CDROM drive you want to use.  This is useful if this software 
  87. incorrectly guesses your drive's ID, or if you have more than one CDROM drive
  88. in your system. 
  89.  
  90. The /T <track number> option allows you to specify the track on the CD
  91. you want to display.  By not specifying a track, the whole CD is assumed.
  92.  
  93. The /D option enables error logging.  This means that any error messages 
  94. will be saved to the file ERROR.DMP.  This is useful for helping me fix any
  95. problems.
  96.  
  97. The /LANG <language number> option selects the language of the lyrics 
  98. (if any) that are displayed when the music is playing.  The numbers are:
  99. 1 - English
  100. 2 - Spanish
  101. 3 - French
  102. 4 - German
  103. 5 - Italian
  104.  
  105. The /95ATAPI option selects the ASPI drivers for ATAPI drives under 
  106. Win95.  If you are using an ATAPI drive under Win95, this is the
  107. option you should use.
  108.  
  109. The /ATASPI option selects the ATASPI drivers for ATAPI drives under
  110. DOS.  If you are using an ATAPI drive under DOS with ATASPI, this is the
  111. option you should use.  Have a look at the DOC file for CDDA on my 
  112. web page for more information on how to find ATASPI drivers.
  113.  
  114. If you are using either the /95ATAPI or /ATASPI options, the program 
  115. will query your ATAPI drive to see if it supports reading CD+G information.
  116. Most drives don't, and the program will tell you what the drive 
  117. reports back to it.
  118.  
  119. As of version 1.0, you can also use CDGPLAY with ATAPI drives through
  120. the ATASPI drivers.  These drivers are for DOS and Win95 and usually
  121. come as part of "PowerIDE" from Future Domain when you buy their
  122. IDE controller.  However, as far as I can tell, the drivers will
  123. work on any IDE controller, not just the ones from Future Domain.
  124.  
  125. If you have a Future Domain IDE controller and PowerIDE, you are
  126. all set.  You just have to add the device drivers in config.sys
  127. and autoexec.bat. (see below my example and assuming the drivers
  128. are not already installed)
  129.  
  130. If you don't have a Future Domain product, you will have to find
  131. the ATASPI drivers elsewhere.  You might want to have a look 
  132. at Mediavision's FTP site (ftp.mediavis.com), or their web site
  133. (www.mediavis.com), where they keep update driver files for
  134. many of their products.  You might find update drivers for your
  135. MV600, which runs on a Future Domain controller.
  136.  
  137. The two lines needed in my config.sys file are:
  138. device=c:\ataspi\ataspi16.sys /c:170,15,376h /v
  139. device=c:\ataspi\fdatacd.sys /d:mscd000
  140.  
  141. The line needed in my autoexec.bat file is:
  142. c:\ataspi\mscdex /d:mscd000 /v /e
  143.  
  144. If you use the /ATASPI or /95ATAPI options, CDGPLAY will also check to
  145. see if your drive supports reading CD+G.  No longer do you have
  146. to guess to see if the drive supports this mode, CDGPLAY can now 
  147. directly query the drive itself to see if it supports CD+G.
  148.  
  149.  
  150. Examples:
  151.  
  152. CDGPLAY 
  153.  - will play the entire CD from the first SCSI cdrom drive it finds
  154.  
  155. CDGPLAY /T 3
  156.  - will play track 3 from the first SCSI cdrom drive it finds
  157.  
  158. CDGPLAY /ID 0:2:0 /MSC F
  159.  - will play the entire CD from the SCSI drive at host adapter=0,
  160.    scsi id=2, and lun=0, and MSCDEX drive F, using ASPI
  161.  
  162. CDGPLAY /ID 0:2:0 /MSC F /95ATAPI
  163.  - will play the entire CD from the ATAPI drive at host adapter=0,
  164.    id=2, and lun=0, and MSCDEX drive F, using ASPI under Win95
  165.  
  166. CDGPLAY /ID 0:2:0 /MSC F /ATASPI
  167.  - will play the entire CD from the ATAPI drive at host adapter=0,
  168.    id=2, and lun=0, and MSCDEX drive F, using ATASPI under DOS
  169.  
  170. CDGPLAY /F C:\LOU_REED.CDG
  171.  - will play from the file instead of reading from the CD
  172.  
  173. CDGPLAY /T 3 /D
  174.  - will play track 3, like above, but will also dump any error messages
  175.    to the file ERROR.DMP
  176.  
  177. When the program is running, sometimes the drive returns a fatal
  178. error message SC:0x05, ASC:0xbf.  This usually means that the PC
  179. has failed to keep up with the data stream.  At the moment, the
  180. only solution is to run this on a faster machine.  My 486DX4-100
  181. seems to be fine for most of the CDs I have tested.
  182.  
  183. Sometimes the drive may also returns a fatal error message 
  184. SC:0x05, ASC:0x24.  This usually means that the drive has either stopped
  185. or not yet started streaming the CD+G data even though the audio is 
  186. playing.  Your only option here is to try and adjust the start and end
  187. times of the piece of music you are trying to play.
  188.  
  189. Copying and Registration (does he mean this costs $$$?)
  190. -------------------------------------------------------
  191. I am allowing full freedom to copy this program.
  192. It IS a fully functional version.
  193. It is NOT Crippleware!
  194. There is NOT a pro version available for an unreasonable sum of money.
  195. I'm NOT asking for $ to register this program.
  196.  
  197. What I am asking is, that if you use this program to let me know (via EMAIL,
  198. snail mail, Carrier Pigeon etc.), AND if your karma so directs you, make
  199. a small donation to a local charity.  
  200.  
  201. I would also like to try to keep all the files together and unchanged
  202. in the archive, so if you are passing this around don't change the files.
  203. In this distribution the files contained are:
  204.  
  205. CDGPLAY.EXE - the program itself
  206. CDGPLAY.DOC - this document file
  207.  
  208. How to get contact me
  209. ---------------------
  210. If you want to make suggestions or send compliments, you can contact
  211. me at the address below.
  212.  
  213. If you would like assistance in solving problems, please 
  214. include dumps from the program.  You should be able to
  215. run the program like this and get the dumps in a text file:
  216. CDGPLAY /T 2 >dumpfile.txt
  217.  
  218. I have real difficulty in tracking down problems without these
  219. dumps.  In the past the majority of people asking for help just send
  220. along a short note telling me my program doesn't work, and what
  221. they remember the error messages saying.  This just doesn't cut it.
  222. I have to have the dumps to help.
  223.  
  224. The bottom line - RTFM before writing me.  Also read the alt.cd-rom
  225. FAQ.  many of your questions can be answered by reading.
  226. EMAIL: jmclaugh@nortel.ca
  227.  
  228. Snail Mail:
  229.        Jim McLaughlin
  230.        337 Nautica Ct.
  231.        Indian Harbour Beach, FL
  232.        USA 32937
  233.  
  234. Things on my wish list
  235. ----------------------
  236. - some of the scrolling routines are not 100%
  237. - sometimes the drive stops streaming data for no apparent reason
  238.   so more robust error checking is needed
  239. - maybe someday I'll be able to add Win32 support
  240. - maybe someday I'll add cd player style controls
  241.  
  242.  
  243.