home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / music / d10dump / english.doc < prev    next >
Text File  |  1989-04-05  |  12KB  |  268 lines
  1. Roland D10 Dump utility v1.0
  2. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3. Files
  4. ¯¯¯¯¯
  5. This archive should contain the following files.
  6. - DUMP1_0.PRG (Roland D10 Dump program v1.0)
  7. - ENGLISH.DOC (This document file)
  8. - README.1ST
  9. - 13 Sound-files (12 *.SND + DEFAULT.ALL)
  10.  
  11. Public Domain
  12. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  13. This program is public domain. This means that you can make as
  14. many copies of it as You see fit, and freely distribute these to
  15. friends, Bulletin Board Systems etc. Please note that You can't
  16. charge anything for the program(except a reasonable charge to
  17. cover distribution expenses). You're not allowed to alter the
  18. program or the accompanying document-file, and You must always
  19. distribute these files together.
  20.  
  21. Disclaimer
  22. ¯¯¯¯¯¯¯¯¯¯
  23. This program is supplied in the belief that it operates as specified,
  24. and the author shall not be liable in any circumstance whatsoever for 
  25. any direct or indirect loss or damage to property incurred or suffered
  26. by the person using this software, or any other person, as a result of using 
  27. this software.
  28.  
  29. Revision History
  30. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  31. This is version 1.0(as of 92/04/26).
  32.  
  33. Using the Program
  34. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  35. The program only runs in high resolution mode, but this will
  36. probably change when the next version hits the streets. I didn't
  37. have enough time to learn how to use resource-files in conjunction
  38. with GFA Basic, so I made my own graphical user interface, and
  39. this is screen-resolution dependent. Sorry! If You don't have
  40. access to a mono monitor You could always try one of the many
  41. mono emulators on the PD-market, but I'm not sure if this will
  42. work because the dumping of data from the D10 to disk is time
  43. critical, and most screen emulators have a tendency to devour 
  44. CPU time. Because of this there is a probability of losing data.
  45. There's no harm in trying, though, as the program will inform You
  46. about any loss of data. If the mono emulator is capable of
  47. setting the amount of CPU time that it uses, then please set this
  48. as low as possible.
  49.  
  50. The available menus(with options) are:  * Atari (Atari logotype)
  51.                                              - About DUMP1_0
  52.  
  53.                                         * Dump
  54.                                              - D10  to Disk
  55.                                              - Disk to D10
  56.                                              - Quit
  57.  
  58.                                         * Help
  59.                                              - Dumping
  60.                                              - Filetypes
  61.  
  62.  
  63.  
  64.  
  65. About DUMP1_0: Displays version number etc.
  66.  
  67.  
  68. D10 to Disk:    Initiates data transfer from D10 to disk.
  69.                 An alert box will pop up and ask for the
  70.                 filetype to be used. Next You will see a
  71.                 GEM fileselector where You can enter the
  72.                 name of Your dump-file to be, or abort by
  73.                 pressing the Cancel button. There's no need
  74.                 to give a file-suffix as this will be auto-
  75.                 matically appended by the program, and even
  76.                 if You do, the program still will be
  77.                 appending the correct suffix(according to
  78.                 chosen filetype). This is for Your con-
  79.                 venience, so that You'll be able to keep
  80.                 some kind of order among Your files.
  81.                 Having entered a filename and pressed OK,
  82.                 the transfer will start immediately. You
  83.                 won't need to push any buttons on the D10.
  84.                 The dumped data will then be saved under the
  85.                 filename You gave in the fileselector.
  86.                 This option can also be reached from the
  87.                 keyboard via ALT-S(Hold down Alternate
  88.                 key and press S). S as in Synthesizer or
  89.                 Save.
  90.  
  91.  
  92. Disk to D10:    The other way around! It operates the same
  93.                 way as D10 to Disk(above). When in the file-
  94.                 selector, just pick the desired file and
  95.                 press OK-button. This will dump data in
  96.                 file to the D10. Note that there's no check
  97.                 to see if the filename given has the same
  98.                 suffix as the filetype selected, but the
  99.                 fileselector will open up with *.filetype
  100.                 (e.g. *.SND if .SND is the selected file-
  101.                 type). This option can also be reached from
  102.                 the keyboard via ALT-D. D as in Disk or Dump.
  103.         (Clarification to the above): The program will
  104.         quite happily dump any MIDI Exclusive file
  105.         that You have around for Your D10. In order
  106.         for this to work You must first rename Your
  107.         file from *.XXX to *.SND(or *.RHY or *.ALL),
  108.         and then select the appropriate filetype to
  109.         the same suffix as You gave Your old file.
  110.         Example: You have a MIDI Excl. file for Your
  111.         D10 that contains the factory settings, and
  112.         this file is named DEFAULT.D10. Just rename it
  113.         to DEFAULT.SND, and when in DUMP1_0 select
  114.         Disk to D10 and .SND as the filetype.    
  115.  
  116.  
  117. Quit:           Quite self-explanatory! You will be able to
  118.                 take back if You made this choice by accident.
  119.                 This option can also be reached via ALT-Q.
  120.                 Q as in ... hmm? Quadragenarian maybe?
  121.  
  122.  
  123. Dumping:        This displays a brief helptext about the
  124.                 dumping procedure.
  125.  
  126.  
  127. Filetypes:      This displays a brief helptext about the
  128.                 filetypes used by the program, and their
  129.                 meaning.
  130.  
  131.  
  132. Filetypes
  133. ¯¯¯¯¯¯¯¯¯
  134. The filetypes(i.e. suffixes) used are: .SND, .RHY and .ALL.
  135. They indicate the kind of data to be processed.
  136.      .SND: Sound data only, i.e. Timbres, Patches and user
  137.            defined Tones(i01-64).
  138.  
  139.      .RHY: Rhythm data only, i.e. User Rhythm Patterns(P51-88),
  140.            Rhythm Track and Rhythm Setup.
  141.  
  142.      .ALL: Sound and Rhythm data as above plus Master Tuning,
  143.            Pan(Part 1-8), Reverb Type/Time/Level(Multi Timbral
  144.            mode), and Level(Part 1-8, Rhythm Part).
  145.  
  146. If in doubt, please consult Your Roland D10 manual, as this
  147. program transfers the same data as the Data Transfer function on
  148. the D10.
  149.  
  150. Other Roland D-series Synthesizers
  151. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  152. If I own a D20, can I use this program? Frankly, I don't know.
  153. This depends on a whole lot of things, the memory map of the D20 
  154. compared to that of the D10, The Model ID#(used in MIDI Exclusive
  155. messages, etc. The D20-owners maybe aren't that very interested in
  156. this program as they can save their sounds to disk via the built-in
  157. disk drive, but then there's always nice to be able to swap
  158. sounds with D10-owners. If You do decide to try this program with a
  159. D20, You should first check if the D20's Model ID# corresponds to
  160. that of the D10. If so, I think there is a fairly large chance that it
  161. will work due to the small differences between the models. The D10's
  162. Model ID# is 16HEX(=22 Decimal). As for the D110 I don't think that
  163. it will work, because I seem to remember reading something about different
  164. addresses compared to the D10. The D50 is definetely ruled out, and as
  165. for the D5, I really can't say. It would be easy to incorporate
  166. functions for these(except for the D50), but in order for me to
  167. do that I need information about address spaces etc. Maybe I will
  168. try to obtain this info before the next release, who knows?
  169.  
  170. Your own D10-dumps
  171. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  172. If you've made some great sounds, rhythm patterns etc. Yourself,
  173. why not dump them and upload to Your local BBS or the atari
  174. archive (terminator).
  175.  
  176. Bugs!?
  177. ¯¯¯¯¯¯
  178. I have tested, and used, this program for a while now and it
  179. seems to work just fine(they always do, don't they!). If You
  180. should discover a bug, or some other kind of annoying feature
  181. please let me know, and I will try to fix it. In this version
  182. there is one thing I'm not very content with. GEM alert-boxes
  183. that appear when a TOS-error is generated(e.g. when You're trying
  184. to save a file and the disk is write-protected). I spent a great
  185. deal of time trying to direct these errors to my own error
  186. handler(as suggested in the GFA manual), and while this worked
  187. with simulated errors, it was another story with the real ones!
  188. Therefore if You should happen to encounter an operating system
  189. alert-box, never pick the Abort option as this most certainly
  190. will crash the program. The Retry option usually works. I've run
  191. into this problem when I've tried to save a dump to disk, and the
  192. disk was write-protected. The Retry option worked just fine!
  193.  
  194. Just before releasing this program I discovered another peculiarity. This
  195. time about the handling of the System Area(Master Tuning, Pan etc.).
  196. For some strange reason the D10 won't write this packet into its
  197. internal memory upon receiving it. It simply writes it into
  198. temporary memory. I've checked to see if the dumps You get from
  199. DUMP1_0 differs in any way from the D10's dumps(using Data
  200. Transfer/One Way transfer) concerning this area, but I found no
  201. diffs. Maybe one must issue some kind of write command to make
  202. the changes permanent. What does this mean for me, the user?
  203. Let's take a brief example! Your'e going to dump a *.ALL-file
  204. to Your D10(i.e. Sounds, Rhythm & System Area). Your D10 is on
  205. and in Multi Timbral mode. You start DUMP1_0.PRG on Your Atari,
  206. and dump the file. When checking under the TUNE/FUNCTION menu on
  207. the D10 You can see that the new data for Master Tuning etc. are
  208. there(provided that You knew what was there before, of course!),
  209. but as soon as You switch over to Performance mode and then back
  210. to Multi Timbral mode You will notice that the old values are
  211. restored. This DOES NOT apply to Sound & Rhythm data, only to the
  212. System Area! Meaning that the new Sound & Rhythm data will be
  213. retained even if You switch off the power and then switch it
  214. back on again.
  215.  
  216. Just one more thing! This is not a bug really, but it could easily be 
  217. mistaken for one. Here it goes! If You manipulate the fileselector to
  218. show *.*(all files) when You try to dump a file from Disk to D10, and
  219. then select a file with a different file-suffix than that You gave as
  220. filetype(in the alert-box), the program will tell You that the selected
  221. file does not exist! But You saw it! It was there, wasn't it? You're right,
  222. it was there(and still is). It's just that the program takes the filename
  223. given in the fileselector, appends the suffix, and then checks to see if
  224. it exists. That's why! 
  225.  
  226. Updates
  227. ¯¯¯¯¯¯¯
  228. Here is a brief summary of what I hope to be able to include in
  229. the next version of this program.
  230.  
  231. - Better GEM support by use of resource file (all screen
  232.   resolutions supported, and correct error handling)
  233.  
  234. - Support for other Roland D-series synthesizers
  235.  
  236. - Options to dump single Patches/Timbres etc.
  237.  
  238. - Librarian
  239.  
  240. - Support for other data formats(e.g. from tone editors)
  241.  
  242. - Correct handling of the System Area
  243.  
  244. - Improved file handling(see note under Bugs!?)
  245.  
  246. Suggestions
  247. ¯¯¯¯¯¯¯¯¯¯¯
  248. As for the program in it's present state, it is nothing more than a
  249. smart dump utility(You don't have to press any buttons on Your synthesizer),
  250. but it is also a lot dumber than an ordinary dump utility(it's not generic,
  251. but limited to a specified synthesizer), so suggestions are welcome.
  252. If You have a great idea for an improvment, or a feature that You think
  253. ought to be included, You can either write me a letter or send an E-mail.
  254.  
  255.  
  256. Nils Ekholm
  257. Amanuensv. 1/106
  258. 104 05 Stockholm
  259. Sweden
  260.  
  261. E-mail: ekholmATelixir.e.kth.se
  262.  
  263. The AT between ekholm and elixir is the commercial AT-sign
  264. (an a with a "ring" around it). Here it is "@"! If You can't 
  265. see it then try a wordprocessor or an editor to read this file.
  266.  
  267. Bye!
  268.