home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 505.dms / 505.adf / DOCS / SmusInfo.Doc < prev   
Text File  |  1989-09-09  |  9KB  |  219 lines
  1.                            SmusInfo 
  2.  
  3.                             Topics 
  4.  
  5.                    1.   Introduction & Acknowledgements. 
  6.  
  7.                    2.   Usage. 
  8.  
  9.                    3.   Copyright. 
  10.  
  11.                    4.   Distribution.   
  12.  
  13.                    5.   BUG reports. 
  14.  
  15.                    6.   Donations. 
  16.  
  17. 1. Introduction. 
  18.  
  19. I developed this program as a companion for SmusCopy,  enabling me
  20. to get some information about scores that I really needed to know.
  21. Such as which instruments are used, and on what track.  The volume
  22. level would also be nice, as well as the key  signature.  And as a
  23. second reason it would be good practice. And somebody once told me
  24. 'Practice makes Perfect!'. So I took SmusCopy as a base, deleted a
  25. function here, added one there, modified some others, and what did
  26. it produce? Correct! Give the man a cigar!  One big fat green Guru
  27. Meditation! Wait, GREEN guru? I though a Guru was red! Well not in
  28. my case. A friend of mine probed around in the KickStart a bit and
  29. changed the color to green! Nifty bit of customizing! So I started
  30. from scratch again. This time with better results!
  31.  
  32. Features:
  33.  
  34. - Fully compatible with both Workbench V1.2 and V1.3.
  35. - Works on all Amigas.
  36. - Supports most AmigaDos devices.
  37. - The built-in Help function. Just type SmusInfo ?.
  38.  
  39. Acknowledgements. 
  40.  
  41. - Fred Fish, for  supplying me with the  incentive to develop this 
  42.   program, by means of his Fish PD collection. (special thanks for 
  43.   LibFish 16!). 
  44. - The guys at EA, for putting the information that I needed in the 
  45.   Public Domain.  
  46. - The author of the program MC-Info, whoever he (or she!) is. 
  47. - Pieter, for giving me some pointers (no pun intended), and other 
  48.   helpful information, as well as stringarray handling routines. 
  49. - Mark Riley, for  providing me with an  inexpensive way of access 
  50.   to all those Sonix scores. 
  51.  
  52. 2. Usage.      
  53.  
  54. Usage : SmusInfo <SCORE> 
  55.  
  56. How to use this program? Well it is fairly simple, all you have to 
  57. input is the full pathname of the SCORE,  without the .smus suffix. 
  58. To clarify this I will give some examples. 
  59.  
  60. Score to info : DF0:Scores/Jolene.smus 
  61.  
  62. Command line  : SmusInfo DF1:Scores/Jolene 
  63.  
  64. Score to info : DH0:Sonix/Scores/Jolene.smus 
  65.  
  66. Command line  : SmusInfo DH0:Sonix/Scores/Jolene 
  67.  
  68. Score to info : DH0:Sonix/Scores/Miami Sky.smus 
  69.  
  70. Command line  : SmusInfo "DH0:Sonix/Scores/Miami Sky" 
  71.  
  72. The  output of the program  will be  displayed in the CLI  window, 
  73. you could however redirect it to a printer, or a file by using the 
  74. '>' redirection symbol. (See your Amiga manual on how to do this.) 
  75.  
  76. Output: 
  77.  
  78. Filename    : name of the file. 
  79. Score       : Name of the score. 
  80. Author      : Name of the author. (if there is an AUTH chunk.) 
  81. Copyright   : The copyright message. (if there is a (c)  chunk.) 
  82. Annotation  : The annotation text. (if there is an ANNO chunk.) 
  83.  
  84. A list of all the instruments loaded by the score and the register 
  85. number of every instrument. together with an eventual MIDI channel 
  86. and preset. Only if MIDI is 'Yes' though. 
  87.  
  88. The volume setting and the key signature of the score. 
  89.  
  90. Per track,  every time there is an instrument change,  the program
  91. will display the name and registernumber of the instrument changed
  92. to.  Depending on the number of instrument changes this list might
  93. grow to a respectable length. I wanted this info.  If, however the
  94. majority of users (definition of user:  A person who has sent me a
  95. donation.) only wants a list of the different  instruments used on
  96. a track I will change the program accordingly. So, if you want the
  97. program to be changed accordingly, notify me. It's all up to YOU!!  
  98.     
  99. Requirements:  
  100. - An Amiga with a minimum of 512KByte. 
  101.  
  102. The program should support all regular  Amiga devices. I tested it 
  103. with DF0: to DF2:, VD0:, VDK:, RAM:, CARD: and DH0: to DH2:. It is 
  104. compatible with both  WorkBench 1.2 and 1.3. I haven not tested it 
  105. with 1.1 though. Since I neither own a synthesizer nor know how to
  106. work one, I'm not able to test on MIDI instruments. If anybody out
  107. there could test this specific feature for me and would tell me if
  108. it works or not, I would be grateful. 
  109.  
  110. NOTICE: 
  111.  
  112. This software is  supplied as is, and  neither the  author nor the 
  113. distributor is liable or responsible for any  damage to either the 
  114. computer or any pheripherals or media this software is used on. 
  115.  
  116. 3. Copyright. 
  117.  
  118. This program is considered FreeWare. It may be copied freely. When
  119. doing so please note the following restrictions.
  120.  
  121. - The program may not be used or bundled by any software retailing
  122.   over US$ 10.00 (British £ 3.00), or it's equivalent in any other 
  123.   currency, without prior written permission from the author. 
  124.  
  125. - This document must always accompany the program. 
  126.  
  127. - This document may not be altered in any way.
  128.  
  129. - The author  retains the right to  remove this  program  from the 
  130.   Public Domain at any time, without prior notification. 
  131.  
  132. - If you like the program, or find it useful, please read the last
  133.   chapter of this document and act accordingly.  
  134.  
  135. 4. Distribution. 
  136.  
  137. Distribution rights are  hereby, of course,  granted to Fred Fish, 
  138. and any other non-profit organisation.  Persons wanting to include 
  139. this program and / or it's  source on any disk  retailing over US$ 
  140. 10.00 (British £ 3.00), or it's equivalent in any other  currency
  141. must first obtain written permission for this from the author. 
  142.  
  143. 5. BUG-Reports. 
  144.  
  145. Known Bugs:
  146.  
  147. - None as of 15th April 1989.
  148.  
  149. Send report To:
  150.  
  151. Although I've had this program tested extensively,  there still is 
  152. the possibility that something has been overlooked.  If you find a
  153. bug, or you think you might have found a bug, please print out the
  154. following form on you printer, fill in the neccessary details, and
  155. sent it to the address mentioned on it. Thanks! 
  156.  
  157. ------------------- Cut Here Please ------------------------------ 
  158.  
  159. +----------------------------------------------------------------+ 
  160. |                           BUG Report                           | 
  161. +----------------------------------------------------------------+ 
  162. | Program     : SmusInfo        Version     : 1.3                | 
  163. +----------------------------------------------------------------+ 
  164. | Bug         :                                                  | 
  165. |                                                                | 
  166. |                                                                | 
  167. |                                                                | 
  168. |                                                                | 
  169. |                                                                | 
  170. |                                                                | 
  171. +----------------------------------------------------------------+ 
  172. | Additional information                                         | 
  173. | Error code  :                                                  | 
  174. |                                                                | 
  175. |                                                                | 
  176. |                                                                | 
  177. |                                                                | 
  178. |                                                                | 
  179. |                                                                | 
  180. +----------------------------------------------------------------+ 
  181. | Sent to:    P. Kolenbrander                                    | 
  182. |             <BUG-Report SmusInfo V1.3>                         | 
  183. |             Turfveldenstraat 37                                | 
  184. |             NL-5632 XH  EINDHOVEN                              | 
  185. |             The NETHERLANDS                                    | 
  186. |                                                                | 
  187. +----------------------------------------------------------------+ 
  188.        
  189. ------------------- Cut Here Please ------------------------------ 
  190.  
  191. 6. Donations. 
  192.  
  193. This program is considered Freeware. Meaning that if you find this
  194. program useful, you are kindly requested to make this noted to the 
  195. author.  Preferably by means of a (cash!) donation or other useful
  196. token of appreciation.  This is not mandatory as is with Shareware 
  197. programs however.
  198.  
  199. If you have any cash to spare, it is always welcome. Unfortunately 
  200. I have my expenses also. Donations in other form, like disks, (PD) 
  201. software, Sonix Scores!, home-built programs / hardware  etc,  are
  202. of course also welcome. Remember: 
  203.  
  204.             'It is better to give than to receive!' 
  205.   (I've given you this program, so now it's you turn, isn't it?) 
  206.  
  207. Enjoy the program! 
  208.  
  209. My address is: P. Kolenbrander 
  210.                Turfveldenstraat 37 
  211.                NL-5632 XH  EINDHOVEN 
  212.                HOLLAND 
  213.  
  214. No phone, not since some guy woke me at  04:00 AM ( My local time, 
  215. not his!). So, if you feel it is that  urgent to call me you won't   
  216. mind taking the trouble of finding out my phonenumber. But PLEASE! 
  217. check the  time-differences. I can get  pretty  uncooperative when 
  218. called out of bed in the middle of the night!
  219.