home *** CD-ROM | disk | FTP | other *** search
/ Da Capo / da_capo_vol1.bin / programs / amiga / edit / sidconverter / convertmus.readme next >
Text File  |  1994-09-06  |  5KB  |  122 lines
  1. ConvertMUS.rexx V1.0b 
  2.  
  3. Please read the entire .readme file before using this script! (I know
  4. its tough but you can do it. :-)
  5.  
  6. ============================================================================
  7. WHAT IS IT?
  8. ============================================================================
  9.  
  10. Its an automated arexx script that allows you to convert lots of
  11. Compute! .MUS file format SID songs from the C-64 into the "one file"
  12. form for use with PlaySID V3.0 by Per Håkan Sundell & Ron Birk.  This way
  13. you can convert hundreds of files in a matter of a few minutes and not
  14. have to do it all by hand!  
  15.  
  16. I wrote this mainly for myself, but I figured there must be a few other
  17. people that might find this handy.  
  18.  
  19. ============================================================================
  20. WHAT DO I NEED TO RUN IT?
  21. ============================================================================
  22.  
  23. Arexx software (should have it if you have WB 2.0+)
  24. PlaySID V3.0 in SID: (found here on aminet where this file came from)
  25. rexxsupport.library in LIBS:
  26.  
  27. ============================================================================
  28. HOW DO I USE IT?
  29. ============================================================================
  30.  
  31. First there is only one rule that you need to follow.  The script will
  32. ask you for a destination directory where the converted files will go.  You
  33. need to make sure that you specify a path that does not end in a ":".  Such
  34. as "RAM:" or "Music:".  Allowing this would have required extra code to
  35. check for paths with and without a colon (so I would know whether or
  36. not to append a "/" to the pathname when writing out files) so I was lazy
  37. and assumed that a device (eg ram:) and a directory would be specified
  38. (eg ram:Stuff).
  39.  
  40. Also, you will need to assign SID: to wherever PlaySID V3.0 has been
  41. installed.  The script will make use of the two files:
  42. "MakeSIDIcon"
  43. "SIDConv" 
  44.  
  45. If AREXX is not currently running, you need to start it.  Go into your
  46. SYSTEM directory of your WB disk and click on "RexxMast".  
  47.  
  48. Open a shell window and type the following:
  49. path sys:rexxc
  50.  
  51. This tells the shell where we will find the RX command (the one used to
  52. execute arexx scripts).
  53.  
  54. Now CD into the directory containing the .MUS files.
  55.  
  56. Then enter the following:
  57.  
  58. RX <PathName>:ConvertMUS.rexx
  59.  
  60. Where <PathName> is the full path where the ConvertMUS.rexx is located
  61. (such as dh0:downloads for example).
  62.  
  63. ============================================================================
  64. WHAT HAPPENS WHEN I EXECUTE THIS SCRIPT?
  65. ============================================================================
  66.  
  67. If you are wondering about your source files, this script WILL NOT 
  68. modify your original files in any way as long as you DO NOT specify
  69. the destination path to be the same as the source path.
  70.  
  71. When you enter the RX command as listed above, you will be prompted for
  72. a destination path for the converted files.  Please remember the rule
  73. mentioned at the beginning of the last section.
  74.  
  75. Once a destination has been entered, it will check to see if the chosen
  76. path exists.  If it does not exist it will ask you if you want to create
  77. that directory.
  78.  
  79. If the directory does exist, then conversion will continue until all
  80. .MUS have been converted.
  81.  
  82. The script will search out all files ending in .MUS.  It will create an
  83. Icon for each one that identifies it as a Compute! SID song (via the
  84. "MakeSIDIcon" command).
  85.  
  86. Next, the two files will be merged into one and saved into the specified
  87. destination directory (via the SIDConv command).
  88.  
  89. Upon completion, you will be notified that conversion is done and how
  90. many files were converted.
  91.  
  92. ============================================================================
  93. NOW WHAT?
  94. ============================================================================
  95.  
  96. Now you have a nice directory full of Compute .MUS sid songs nicely
  97. compacted into one file and easily playable by PlaySID V3.0. 
  98.  
  99. ============================================================================
  100. OK, WHO WROTE THIS WONDERFUL SCRIPT? :-)
  101. ============================================================================
  102.  
  103. This script was written by me, David Poland, a recent graduate from the
  104. University of Kansas in the field of Computer Science.
  105.  
  106. If you have any comments/questions/whatever, mail them to:
  107.  
  108. hawkwind@kuhub.cc.ukans.edu or,
  109. lordj@kuhub.cc.ukans.edu
  110.  
  111. ============================================================================
  112. DISCLAIMER?
  113. ============================================================================
  114.  
  115. The obligatory disclaimer, like you don't know this already.  If your HD
  116. goes nuts and spins so fast it catches fire and burns down your house
  117. its not my fault. :-)  Use or abuse this program as you see fit.
  118.  
  119.  
  120.  
  121.  
  122.