home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / utilities / smartcd / !SmartCD / !Help < prev    next >
Encoding:
Text File  |  1994-03-11  |  8.2 KB  |  175 lines
  1.  
  2. Help on !SmartCD version 1.13             FreeWare Audio CD Player
  3. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~             ~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5. Not only does this CD player look smart, it really is smart. It can remember
  6. your audio CDs and, once you've entered the track names (and saved them!),
  7. this recognises discs and lets you choose tracks by name/number.
  8.  
  9. If you've seen it all before, at least read this bit!
  10. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  11.  
  12. If you used version 1.00 of this program, please copy the OLD directory called
  13. '!SmartCD.CDs' into this new application, otherwise you'll lose your
  14. catalogues. A few new buttons and options have appeared, and the things which
  15. didn't work before (e.g. the clock) do actualy work now!
  16.  
  17. How to use 'Smart CD' v1.13
  18. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19.  
  20. Click once on the 'SmartCD' icon to get a panel with a load of buttons on it,
  21. and two texty icons. The upper icon shows the CD name, and the lower shows the
  22. current track. Note that this (lower) icon is *not* writable.
  23.  
  24. There is a menu attached to the panel, and another attached to the bar icon.
  25. The one on the icon bar is obvious, the other stuff is as follows:
  26.  
  27. Panel Buttons (left to right):
  28.  
  29.    PLAY      - Either: Tries to recognise your CD and play from track #1.
  30.                    or: If paused, re-starts playing.
  31.    PAUSE     - Pauses and restarts (usually from where you paused it!)
  32.    STOP      - Stop playing but don't dismout the CD.
  33.    PREVIOUS  - Play previous track if possible.
  34.    NEXT      - Play next track if possible.   
  35.    HUH?      - Examine CD, display details if it is recognised.
  36.    EJECT     - You know.
  37.    
  38. Panel Menu:
  39.  
  40.    SAVE LISTING       - Saves the listing, or whatever you've entered.
  41.    ADD TRACK LENGTHS  - Adds inlay-card-style track times to the list.
  42.    AUTO EJECT         - Ejects the disc when it reaches the end (whether the
  43.                         panel window is open or not). Note that the process of
  44.                         ejecting requires single-tasking for a second or two,
  45.                         so the hourglass appears.
  46.    SAVE OPTIONS       - Saves the 'tickable' option states.
  47.  
  48. Put in a CD and click the 'HUH?' or 'PLAY' buttons; this will give you a
  49. message saying "Disc not known... please save any details".
  50.  
  51. You now type in the name of the band/orchestra/whatever and the track
  52. titles, (all the boxes are writable - just click where you want to write)
  53. and when you've finished, you get the menu in this window and select "Save
  54. Listing". Next time you click 'HUH?' the CD will be identified and you can
  55. click on the track numbers to play different tracks.
  56.  
  57. If you just want to save the artist and title of a CD, that will not be a
  58. problem. You could just leave the SmartCD window small, without displaying the
  59. track listing.
  60.  
  61. The menu option 'ADD TRACK LENGTHS' just adds the 'play times' to the writable
  62. track name icons, e.g. (3:42) for a 3 min 42 sec track. I have intentionally
  63. set this up so you can add the times to the listing, if you want, for any
  64. CDs you catalogued using version 1.00 of this program. You can then save the
  65. listing again and the times will always be there, if that's the way ya like
  66. it. Note that these times will NOT appear in the 'current track' window unless
  67. you've saved the listing.
  68.  
  69. The program will recognise a CD if it's playing when you run the application,
  70. or if you play it without previously "identifying" it. It will even know if
  71. you paused the CD before quitting your other CD player, and will let you
  72. re-start from where you were. Cool, huh?
  73.  
  74. If you try to play a *data* track, the player returns a "can't play" error,
  75. and in the current version the result is that the program assumes that there
  76. is no audio disc, so the list is reset. You can still play the audio parts of
  77. CD Roms if you want to; some CD ROMs (e.g. Return to Zork for the PC) have
  78. audio tracks on which you might like to hear, so I haven't excluded data
  79. CDs from the system entirely, but SmartCD won't tell you which are audio.
  80.  
  81. How does it remember CDs?
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~
  83.  
  84. This system works by simply using the total playing time of each CD (which
  85. is available through CDFS to an accuracy of 1/75 second) as a hopefully
  86. unique label for each disc. So far, it's been pretty reliable.
  87.  
  88. The play time is slightly encoded and used as the filename for a small data
  89. file, stored in !SmartCD.CDs. This means if you catalog more than 77 CDs
  90. (the maximum for a Risc OS directory) you'll get an error... sorry!
  91.  
  92. Although I've tested this system with up to 40 CDs, I've only left *one*
  93. listing in there, namely "In On The Kill Taker" by Fugazi (so if you've got
  94. this you don't need to type in the details!). Take a look at the format;
  95. it's very simple and the files are plain text. I suggest you delete the file
  96. when you've looked at it, unless you own this CD.
  97.  
  98. Non-Optimal Features (look, they're *not* bugs, OK?)
  99. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  100.  
  101. Apologies to those who don't have high-res monitors, for whom the icons and
  102. panel look pretty rubbishy. Invitations to anyone who would like to come up
  103. with a nice Mode 12-ish panel icon and button sprites.
  104.  
  105. If your CD has more than 40 tracks, any above the 40th cannot be catalogued.
  106. I think the program will still work OK with the listed ones, but I haven't had
  107. any opportunity to test this.
  108.  
  109. Currently the program assumes that you only have one CD player, and that it
  110. is drive :0 under CDFS (if SCSI, the device ID does not matter) - in principle
  111. this might be a problem to a total CD-dude who's got more than one drive and
  112. doesn't want to play audio CDs on drive :0. Does anyone have this problem?
  113.  
  114. The buttons are just sprites which get shoved into the icon frames when the
  115. dialogue box is drawn - as long as the size doesn't change you can edit all
  116. the icons (including the main panel) to be whatever you want. Different styles
  117. might be fun, maybe an Acorn-look one, a silvery one, etc, etc. If you've got
  118. a template editor you can move the icons about too, but to make it workable
  119. you should do *IconSprites <SmartCD$Dir>.Sprites first, so that the icons
  120. are defined in the WIMP pool and will therefore appear in the template editor
  121. window while you're editing. This applies *ONLY TO YOUR OWN PRIVATE VERSION*
  122. and are *NOT* allowed to redistribute this package with your own icons. If you
  123. desing some nice ones, send them to me and I'll include them in a new release.
  124.  
  125. Credits
  126. ~~~~~~~
  127.  
  128. Thanks are due to Peter Brunning for downloading v1.00, testing it, and
  129. getting in touch with the first suggestions and creative input. Also thanks
  130. to Mark Smith for being a second beta-tester, and a hearty pat on the back
  131. for Jon Young, who solved an embarassing problem I had with redraws. Finally
  132. to 'Shonen Knife', who provided most of the soundtrack for the development
  133. of this version!
  134.  
  135. Contact/Feedback
  136. ~~~~~~~~~~~~~~~~
  137.  
  138. If you have any problems with this program (and want them fixed), please
  139. send me the *PlayList of the CD you were using. Please issue the following
  140. commands in a TaskWindow or at the F12 command line:
  141.  
  142.      *CDFS
  143.      *PlayList { > <SmartCD$Dir>.^.Listing }
  144.      *SetType <SmartCD$Dir>.^.Listing Text
  145.      *ADFS
  146.    
  147.  ...which will put a text file called "Listing" in the same directory as your
  148. copy of !SmartCD. Then please e-mail or snail-mail this to me, with a brief
  149. description of the error. I cannot promise that bugs will be removed, but I
  150. will try. As you will see from the 'Advert', I do not intend to add new
  151. features to the FreeWare version of SmartCD.
  152.  
  153. Thanks,
  154.  
  155. Ian Giblin
  156.  
  157. c/o Space Science Centre,
  158.     MAPS building,
  159.     University of Sussex,
  160.     Brighton BN1 9QH.
  161.  
  162. +---------------------------------------------------------------------------+
  163.  
  164.   This software is FREEWARE. It may be freely distributed so long as no
  165.   money is exchanged, except to cover costs of distribution, i.e. post &
  166.   packing or the cost of the disk and ALL the files are included in the
  167.   distributed version.
  168.  
  169. +---------------------------------------------------------------------------+
  170. |             SmartCD is and will remain © ALT-itude 1994                   |
  171. +---------------------------------------------------------------------------+
  172. |    ALT-itude is...   Ian Giblin,      e-mail:  I.Giblin@sussex.ac.uk      |
  173. |                      Paddy Spencer,   e-mail:  pss@liverpool.ac.uk        |
  174. +---------------------------------------------------------------------------+
  175.