home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / msdos / midi / mdf23 / mdf23.lzh / MDF.DOC next >
Encoding:
Text File  |  1991-04-29  |  4.8 KB  |  127 lines
  1. MDF.EXE  --  MIDI DATA FILER ver 2.3, Apr 28 1991 by Kai Risku
  2. ===============================================================
  3.  
  4.  
  5. This is a very simple and easy-to-use program that I use to
  6. store sysex-dumps from my synthesizer in files on my PC.
  7. The program requires a MPU-compatible MIDI-interface at the
  8. default address (0330h), no IRQ is used.
  9.  
  10. The program was made with Borland's Turbo C 2.0.
  11.  
  12.  
  13.  
  14.         The program MDF.EXE takes one filename with optional
  15.         path as a command-line argument and if the filename
  16.         has no extension, .SYX will be added.
  17.  
  18.  
  19.  
  20. How to save MIDI-data to a file:
  21. ================================
  22.  
  23. You just start MDF with a non-existent filename as argument.
  24. MDF will then create a file with that name (and add SYX to
  25. the name if there isn't one already). When MDF reports
  26. 'Ready to receive' you start a sysex-dump manually from your
  27. synthesizer. After the dump is done, MDF will report how
  28. many bytes that have been received, save those in the file
  29. and exit automatically.
  30.  
  31.  
  32.  
  33. How to send the data back to the synthesizer:
  34. =============================================
  35.  
  36. Oh, you have already guessed that one, but I just want to say
  37. it anyway. Run MDF with the name of the file you want to send
  38. to your synthesizer as the argument. If the filename has the
  39. extension .SYX, you don't have to write it out, as the program
  40. will add it automatically. MDF will send the contents of
  41. the file and inform you of how many bytes that has been sent.
  42.  
  43.  
  44.  
  45. Configuring MDF using the MDF.INI file:
  46. =======================================
  47.  
  48. If you have a fast computer, you can encounter problems because
  49. the data is sent out too fast for your synthesizer. To cure this
  50. MDF has options to let you slow down the output. These options
  51. are found in the file name MDF.INI and can be edited to your
  52. needs with an ordinary ASCII editor. When you start MDF, the
  53. program will look for the INI file in the same place as MDF.EXE
  54. resides. A default INI file is created if it cannot be found.
  55.  
  56. The options in the file are of the syntax Option=value and every
  57. option must be on a line of its own. At this moment there are
  58. two options available and these both control the output speed when
  59. sending sysex-data. The options are named Delay1 and Delay2
  60. respectively. Delay1 is controlling the delay between each byte
  61. being sent, and Delay2 specifies the delay between the sysex-messages.
  62.  
  63.  
  64.  
  65. Current limitations:
  66. ====================
  67.  
  68. - The maximum size of a single dump is limited to 64 kbytes.
  69.   If you have a need for more than that, then contact me
  70.   and I'll happily make an improved version.
  71. - There can be some problems when receiving a dump if the
  72.   synthesizer dumps data too fast. You should therefore keep
  73.   an eye on the size of the received data as this will be
  74.   too small if the buffer has flooded.
  75. - You cannot use handshake-dumps with this program, because
  76.   practically every synth has its own format for this.
  77.   You can only use transfers without handshaking and therefore
  78.   the dumps must always be manually started from the synth.
  79. - If you for some reason have changed the address of the
  80.   MIDI-interface to anything else than 0330h, then you can't
  81.   use this program at all. Sorry.
  82.  
  83.  
  84.  
  85. Revisions:
  86. ==========
  87.  
  88. Changes from version 2.2:
  89.         Added an INI-file for user-configurable delays while
  90.         sending. Modified text output and removed some
  91.         unnecessary texts.
  92. Changes from version 2.1:
  93.         More code cleanup. Incoming data during sysex-send
  94.         to synthesizer will be sent back out when possible.
  95.         Error-handling improved.
  96. Changes from version 2.0:
  97.         The default extension MDF for files created was changed
  98.         to SYX for compatibility with other software.
  99.         Active sensing has earlier caused some trouble, but
  100.         this has now been fixed as well as a small bug causing
  101.         a time-out if you don't start the dump fast enough
  102.         after you started the program.
  103. Changes from version 1.0:
  104.         Document added (this piece of text). Improved routines
  105.         with faster code. Corrected some minor bugs.
  106.  
  107.  
  108.  
  109. Credits and more:
  110. =================
  111.  
  112. This program is completely in the public domain. You can distribute
  113. it to all your friends as long as you don't modify this program
  114. in any way without permission from the author. If you really think
  115. this is a useful program and you have a Roland D-5/10/20/110
  116. then you could always mail me some great sounds (I have a D-110).
  117. If you have any questions, ideas, suggestions for improvements
  118. or if you are interested in the source then feel free to
  119. contact me...
  120.  
  121.  
  122. Snailmail:      Kai Risku         Email (internet):  Kai.Risku@hut.fi
  123.                 Kronvik                         or   krisku@vipunen.hut.fi
  124.                 65410 Sundom
  125.                 Finland
  126.  
  127.