home *** CD-ROM | disk | FTP | other *** search
/ Special Sound / INFSOUND.iso / Programa / CD / cdclar.EXE / readme.txt < prev   
Encoding:
Text File  |  1997-03-18  |  12.1 KB  |  243 lines

  1. Intro
  2. ~~~~~
  3. Clarion is a simple media player for MIDIs and Audio CDs. 
  4. (The program can also play AVIs, or any MCI device for 
  5. which you have installed the appropriate MCI driver. 
  6. However, it's designed mainly for playing MIDIs and 
  7. Audio CDs.)  Clarion is 32-bit and runs on Windows95/NT.
  8. You need a sound card and (optionally) a CD drive, 
  9. of course.
  10.  
  11. History
  12. ~~~~~~~
  13. >Version 0.6.0:
  14.  
  15. * The biggest change is that Clarion now keeps a registry of CD track titles.  Take the trouble to enter titles for your CD tracks once and the program will recognize your CDs and their tracks next time.
  16. * Each CD can be linked to a PlayList so that whenever the CD is inserted, the program will load that PlayList.
  17. * Drag and drop files from the Explorer.
  18. * NOTE: I changed the CD signature generating routine, so that the program no longer recognizes signatures from the previous version.  Sorry about this :(
  19. * Added status bar hint.
  20.  
  21. Version 0.5.5:
  22. * Fixed a problem with the eject/close CD button.  Note:
  23. if your CD drive cannot be closed by software, i.e.,
  24. you need to do it manually, shift+click in the CD icon.
  25. This will force it to load CD track info.
  26.  
  27. Version 0.5.4:
  28. * Fixed serious display problem relating to screen font 
  29. size (bug in Delphi's TListView?)
  30. * Fixed ghost trailing while dragging in the play list.
  31. * Added font setting option.
  32. * Added F2 shortcut key to rename item (a la Explorer).
  33.  
  34. Version 0.5.3:
  35. * Added visual pointer indicating the currently 
  36. playing item.
  37.  
  38. Version 0.5.1 and 0.5.2:
  39. * Numerous internal changes.
  40.  
  41. Version 0.5.0:
  42. * Initial release.
  43.  
  44. Install/Uninstall
  45. ~~~~~~~~~~~~~~~~~
  46. To install, create a directory for Clarion and unzip the 
  47. distribution file into it.  To uninstall, just remove the
  48. directory.  The program does not make any change to 
  49. your system files or registry.
  50.  
  51. The program is more or less self explanatory, so IÆll just
  52. try to hit the highlights here.
  53.  
  54. Parts of the screen
  55. ~~~~~~~~~~~~~~
  56. The screen is divided into two major parts.  On the left are
  57. the PlayList, the display panel, and the control panel (with
  58. the play, next, prev, stop buttons).  On the right is the Files/CD browser, which lets you browse your folders and add
  59. files (MIDs, WAVs, etc.) and CD tracks to your play list.  The narrow vertical strip in the middle shows the tracks on your audio CD (assuming you have a CD drive and thereÆs a CD in
  60. it).  (This is slightly redundant since the CD browser does pretty much the same.  It's a leftover from previous version which I decided to keep since it takes up little space and allows you to access CD track even when the browser is toggled off.)  To the left of the CD strip is the PlayList toolbar for, well, doing various things with the PlayList.  ThereÆs also a
  61. floating toolbar outside the main screen (I call it the
  62. floater).  The floater has a miniature control panel and
  63. always stays on top so you can access it anytime.
  64.  
  65. Adding files to the play list
  66. ~~~~~~~~~~~~~~~~~
  67. If you have the AutoSelect box checked, then just click on
  68. a file name to add it to the play list.  This is a lazy way of
  69. selecting files and I like it.  Uncheck AutoSelect if you
  70. want to select files the usual way (i.e., with Ctrl+click and 
  71. Shift+click for multiselection).  Then to add the selected 
  72. files to the play list, click the < button on the play list
  73. toolbar.  Click << to add everything in the file list box to 
  74. the play list.  Click the refresh button to reload the file list. Click the Explorer button to open the currently displayed 
  75. folder.  Shift+click to open it in ôExplorerö mode.
  76.  
  77. >> HINT: To see what any button does, just hold the 
  78. mouse  pointer over it for a second. A hint bubble will pop 
  79. up.  The same hint is also display in the status bar <<
  80.  
  81. To add a CD track to the play list, just click on the track
  82. number, either in the black strip or in the CD tab in the browser. To add all tracks, click on the word æAllÆ or the pound '#' sign in the CD tab in the browser.
  83.  
  84. Play
  85. ~~~~
  86. Press Play to play (duh :).  While playing, press it again to 
  87. pause and again to resume.  There's no rewind
  88. button: when you click on Stop, it automatically rewinds.
  89. To fast forward/reverse, click on the track bar and drag.
  90. Click the button with the return arrow while a song
  91. is playing to start over at the beginning.  Click < and > to 
  92. play the next / previous item in the play list.
  93.  
  94. The Play List
  95. ~~~~~~~~~~~~~
  96. Clarion lets you organize your MIDIs and CD tracks into 
  97. play lists (or albums) and save them. (Play list files are
  98. saved with the .pls extension.) You can have both MIDIs 
  99. and CD tracks in the same play list.  It's not a good idea to 
  100. have tracks from different CDs in the same list, however, 
  101. since Clarion does not support CD changers (sorry, I don't 
  102. have a CD changer so I didn't program for it.)
  103.  
  104. On the play list toolbar, click the button with the musical 
  105. note to bring up a menu for opening, saving, or reloading 
  106. a recently used play list.  Click the button with the quiggly 
  107. line to shuffle the play list.  Select an item in the play list, then click the up/down button to move it up/down the play 
  108. list.  Ctrl+click the up /down button to bring the item to 
  109. the top/bottom of the play list.  Shift+click the up button
  110. to move the item below the one currently playing (so that
  111. it will be played next).  With an item selected, click the >
  112. button to remove it from the list.  Click >> to empty the
  113. play list.  Click the trash icon to delete the actual file from
  114. the disk.  (Confused?  Just hold the mouse over a button
  115. and a hint will pop up.)
  116.  
  117. CD operations
  118. ~~~~~~~~~~~~~~
  119. To eject the CD drive door, click the eject button. Notes: 1) you have to stop play first;  2) be sure the CD door is CLOSED when you start the program.  To close the door and load the tracks, shift+click on the eject button.  Note: if your CD cannot be closed by software, e.g., it does not have a tray, then insert it manually then shift+click on the eject button.  Clarion assigns a signature number to each CD.  The signature is calculated as: length of CD (in milliseconds) X number of tracks.  If the signature of a track in your play list does not match the signature of the CD in the drive, the program will balk.
  120.  
  121. Clarion keeps a registry of CD track titles. Take the trouble to enter titles for your CD tracks once and the program will recognize your CD and their tracks next time.  The first time you insert a CD, the browser will open up with the CD tab (if it's not already).  The CD title will be 'Unknown' and the tracks are named CD [XXXXXXXX] Track NN where XXXXXXXX is the CD signature and NN is the track number.  It's a good idea to enter titles for the CD and its tracks (at least the tracks you like, at any rate :)  Just move the cursor to the track title you want to name and press Enter or F2 to edit.  For example, change 'Unknown' to 'U2 Joshua Tree' and change the first track to 'Where the streets have no name' (don't type the '').  Now when you add a CD track to the PlayList, it will appear with the assigned name.
  122.  
  123. Clarion automatically saves track info you've entered.  You can click the Save button to manually save, in case "something happens".  Of course Clarion is extremely stable and never known to crash -- ever, but you may want to be safe... ;-)
  124.  
  125. Linking a CD to a PlayList
  126. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  127. You can link a CD to a particular PlayList so that whenever you put in that CD, the linked PlayList will load and start playing.  To do this either:
  128.  
  129. a) Click on the blue label in the CD browser and choose a PlayList from the disk.
  130.   or
  131. b) Select 'Link CD to' from the drop down menu.  You can link the CD to the current PlayList or some other PlayList on the disk.
  132.  
  133. You can manually load a linked PlayList either by shift+clicking on the blue label or select from the menu.  If for some reason you no longer want to link the CD to any PlayList, choose Unlink from the menu.
  134.  
  135. The display panel
  136. ~~~~~~~~~~~~~~~~~~
  137. The display panel shows information about the currently 
  138. playing item  -- length, elapsed time, position in play list, 
  139. and name.  It also has labels you can click on to toggle
  140. various things.   When the toggle is on, the label has a 
  141. bold, bright green font.  HereÆs a description of the 
  142. toggles:
  143.  
  144. * æFloaterÆ: hide or show the floater.
  145. * æReset MIDIÆ: reset MIDI between each songs.
  146. Clarion does this by playing two silent MIDI files in 
  147. the directory you installed Clarion to.  (DonÆt delete
  148. these files!)
  149. * æRepeatÆ: play the same item over and over ad
  150. nauseum.  Turn it off when youÆve had enough.
  151.  
  152. The Floater
  153. ~~~~~~~~~~~~
  154. The floater has a miniature control panel that gives you
  155. access to the program even when the main window is
  156. minimized.  You can move the floater around the screen
  157. by clicking on an empty spot and drag.  Click the X button
  158. to hide the floater.  Shift+click the X button to quit the
  159. program.  Click on the red area to move the floater tp the
  160. top of the screen.
  161.  
  162. HINTS HINTS HINTS
  163. ~~~~~~~~~~~~~~~~~
  164. * The selection bar (highlight) in the play list does NOT
  165. follow the item that is currently being played (indicated by
  166. a left pointing triangle).  This allows you to shift/move/
  167. delete an item in the list while another item is playing.
  168.  
  169. * To move the selection bar to the song being played,
  170. click on the item's name in the black display panel.
  171.  
  172. * The file list box can be toggled on and off by clicking
  173. on the disk and CD drive icon.
  174.  
  175. * To move items around in the play list quickly, use
  176. drag and drop.
  177.  
  178. * You can drag files from the Explorer and drop them onto Clarion.  The files will be added to the PlayList.  If you drop a PlayList file (.pls) onto Clarion, it will MERGE the files in that PlayList into the current PlayList.
  179.  
  180. * Double click on an item in the play list to immediately
  181. start playing it.  Double click on a file in the file list
  182. box to add it the PlayList and immediately start
  183. playing it.  For the CD strip and the CD browser, shift+click on a track number does the same thing.
  184.  
  185. * Be careful clicking the trash icon.  It will delete the
  186. file from your disk (not just remove it from the list).
  187. AND YOU WILL NOT BE ASKED TO CONFIRM.
  188.  
  189. * Click on the Name column heading to sort the PlayList by name.
  190.  
  191. * Clarion will save the window settings and reloads the
  192. current play list (if you have saved it) on the next
  193. startup.
  194.  
  195. * If youÆve moved the floater off the screen somewhere
  196. and canÆt fish it out, double click on the æFloaterÆ label
  197. in the display panel.  This will bring the floater back to
  198. the top left corner of the screen.
  199.  
  200. * If for some reason, the CD drive is closed but Clarion
  201. has not read the track information, i.e., the CD panel
  202. is empty, click on the CD eject icon WHILE HOLDING
  203. DOWN THE SHIFT KEY.  This will force a reload.
  204.  
  205. * You can adjust the speaker volume by clicking on the
  206. button with the little speakers.  Clarion will launch 
  207. Windows95Æs volume control program (sndvol32.exe).  
  208. If you want to use a different program for controlling 
  209. the program, add this line to the [Settings] section in
  210. clarion.ini:
  211.  
  212.     VolumeCtl = path_file_name
  213.     VolumeCtlTitle = app_caption_title
  214.  
  215.     where path_file_name is the full path name of the
  216. volume controller program, e.g., c:\sounds\volume.exe
  217. (do NOT put quotes around it.); and app_caption_title is
  218. the title of the program as it appears on the caption bar,
  219. e.g., Volume Control (again, no quotes).  VolumeCtlTitle
  220. is used by Clarion to bring up the program's window if
  221. it's already running.  (Otherwise, Clarion would have to
  222. open up another instance of the program, wasting memory
  223. and resources.)
  224.  
  225. Copyleft, etc.
  226. ~~~~~~~~~~~~~~
  227. This program is freeware. It may be freely distributed,  and
  228. must be distributed freely (i.e., you cannot charge people
  229. anything for it).  The program is provided AS IS.  It may
  230. or may not work as intended. Please don't hold me
  231. responsible for ANYTHING (unless it's good).
  232.  
  233. I wrote Clarion to learn Delphi and have some fun.  I hope
  234. you enjoy the program and find it useful.
  235.  
  236. Questions, comments, suggestions, bug reports, please
  237. send them to Luu Tran <luutran@geocities.com>
  238.  
  239. You can find the latest version of Clarion at
  240.  
  241. http://www.geocities.com/SiliconValley/Heights/9860/
  242.  
  243.