home *** CD-ROM | disk | FTP | other *** search
/ Audio Version 4.94 / audioversion4.94knowledgemediaresourcelibraryoctober1994.iso / msdos / midi / getit30a / getit30a.uue / GETIT30.ARC / GETIT30.DOC < prev    next >
Text File  |  1989-02-18  |  9KB  |  215 lines
  1.  
  2. GetIt! ShareWare MIDI file utility version 3.0 by Aron Nelson 11/24/88
  3. USERS MANUAL
  4. ----------------------------------------------------------------------
  5.  GetIt! is a MIDI file utility that can handle system exclusive
  6. transfers between a MIDI device and your IBM computer or strict
  7. compatible.  GetIt! can received MIDI system transfers from
  8. a variety of MIDI devices and save the data to a disk file. This
  9. allows you to have a library of files which contain the data for
  10. all of your MIDI devices. GetIt! has several modes of operation that can
  11. facilitate system exclusive transfers.
  12.  
  13. 1) RECEIVE MODE:  GetIt30 r
  14.    GetIt! is set up as a device that will wait for any system
  15. exclusive transfers. System exclusive transfers are received "back
  16. to back" in memory and stored as such. This allows you to receive
  17. system transfers from a D10 and a Dx7, save them as one file, then
  18. transmit the whole system file as one.
  19. When a system transfer has ended, GetIt! will display the
  20. transfer status in kilobytes and bytes. The transfer window
  21. will something look like this:
  22.      transfer status -> 43K 234 bytes
  23. Press <return> only after the numbers stop moving, this will
  24. end the transfer and take you to the file section where you will
  25. be prompted for a filename. Be patient as large data transfers can take
  26. some time. Because of the large amount of data that is being received,
  27. the transfer status numbers only move *after* the system data has been
  28. received.
  29.   GetIt! checks for an overwrite when saving and will ask you if you
  30. wish to overwrite anyway. The RECEIVE MODE is good for MIDI devices that
  31. can start MIDI transfers from the front panel like a Dx7, or a
  32. D10, D20.
  33.  
  34. 2)  TRANSMIT MODE:  GetIt30 t <optional file to send>
  35. To transmit a sysex data file that is stored on disk, simply type
  36. GetIt30 t <file to send>. GetIt! will read the sysex file and
  37. proceed to send the data without any delay. If you wish to be
  38. prompted through the procedure just type "Getit30 t" and
  39. GetIt! will prompt you through the procedure.
  40.  
  41. 3)  PEEK MODE: GetIt30 p
  42. Peek mode turns GetIt! into a midi terminal.  Incoming midi data is displayed
  43. onscreen as (h)ex, (d)ecimal or (l)ine.  Line mode is actually english
  44. terms telling you what type of data is being sent and the following bytes
  45. associated with the type of message. The type of display can be changed
  46. "on the fly" by simply typing the letter corresponding to the display type
  47. twice.
  48. GetIt! also has a transmit mode which allows you to transmit MIDI messages
  49. to your MIDI device and view the responses if any onscreen.  This is useful if
  50. you will be developing script files (mentioned below).  By transmitting
  51. MIDI data, you can see if certain system commands are communicating to the
  52. MIDI device.
  53.  
  54. Note: A "hidden" feature allows you to display incoming clock and active
  55. sensing bytes.  Active sensing and clock bytes disrupt the diplay because of
  56. the frequency at which they are sent, however if you wish to display them,
  57. just press the letters "f" or "F" then press the type of display (D),(H),(L)
  58. and the active sensing and clock bytes will be displayed. To stop showing
  59. active sensing and clock bytes, simply repeat the procedure and the
  60. function will be toggled off.
  61.  
  62. 4) SCRIPT FILE MODE: GetIt30 c <script file>
  63.    Script file mode allows you to "talk" to your MIDI devices
  64. if you have the system exclusive documentation at hand. By using
  65. the script commands in GetIt! you can initiate a 2 way communication
  66. between your MIDI device and GetIt!.  The script commands and syntax are
  67. based on Carter Scholz's MidiSave script language. The differences are that
  68. in GetIt!, all parameters are preceded by commands and that the command
  69. set has been greatly extended. There must be a space between commands and
  70. parameters.
  71. To create a script file all you do is use an ascii word processor
  72. like Sidekick, and type commands into a text document.
  73.  
  74. The commands available to you are:
  75. A  All notes off.
  76. B  Blank (clear) the screen.
  77. K  Wait for (IBM) keypress.
  78. M  Display message following M to (IBM) screen .
  79. N  <channel> <noteX> <velX> Play note.
  80. P  <channel> <patchnumX>     Send patch change.
  81. R  <num>  Receive <num> transfers from MIDI device.
  82. S  Send a system message $F0 <messageX> $F7
  83. W  <num>  Wait <num> milliseconds.
  84. Z  Save the systex transfers.
  85. [  <starting index> Start loop at index.
  86. ]  <ending index>   End loop at index.
  87. X  Replace with Loop Index.
  88. /,\,{,},(,),;, are comment markers, follow with any comment.
  89. Variables that end with an X can be replaced with the current
  90. loop index.
  91.  
  92. NOTE:
  93. The M and comments only work on a *line* basis. You can only place comments
  94. and messages on a line by themselves on this release. I plan improve
  95. on this in later versions. Do not mix commands and message/comments on one
  96. line.
  97.  
  98.  
  99. A loop is defined as:
  100. [ <start number>
  101.     <any command>
  102. ] <end number>
  103.  
  104.  
  105. 5) SEQUENCER MODE: GetIt30 s
  106. GetIt! is also a simple MIDI sequencer. To start, just type
  107. "GetIt30 s" on the command line and GetIt! will prompt you through
  108. the sequencers 2 modes, record and play.
  109. When record is activated, GetIt! will wait for you to "press a key"
  110. on your MIDI controller before starting the record process.
  111. Pressing <return> will stop the procedure and prompt you for a save.
  112. The sequencer processes are simple and hopefully should not be hard
  113. to understand. The sequencer is set up so that MIDI thru is OFF,
  114. and benders/controllers are recorded. Hopefully, you will find
  115. this sequencer usefull for tiny "spur of the moment" thoughts.
  116. If you have an idea for a song, just start GetIt! and record it!
  117.  
  118. ROUTINES FOR GETIT!
  119. GetIt! uses the TurboMIDI toolkit, available from N-FOCUS Technologies.
  120. TurboMIDI allows you to write MIDI librarians, Simple MIDI sequencers,
  121. MIDI mappers, Ear training programs, and MIDI utilities like GetIt!.
  122. TurboMIDI requires Turbo Pascal 4.0 from Borland International.
  123. The source for several MIDI programs are included free with the
  124. TurboMIDI toolkit and an 8 track simple sequencer that you can use in your
  125. own applications. Source code for TurboMIDI will be available at a future
  126. date.
  127.  
  128. HERE IT COMES:
  129. Yes, GetIt! is a MIDI SHAREWARE utility, and the author <me>
  130. requests that if you like and use GetIt! and find it useful
  131. please send a $15 donation.
  132.  
  133. Regarding my Shareware thoughts:
  134.  If you like GetIt! (I hope you do), please send the $15 amount. 
  135. Almost anyone should be able to "scrape" up the $15 amount. If you
  136. can afford a MIDI device, then you can pay for GetIt!.  If you truly
  137. cannot pay for GetIt!, then just send me a note telling me so and you will
  138. be added to the registered users list anyway.  When you can pay for GetIt!
  139. I will expect you to contribute. Please do give copies of GetIt! to 
  140. anyone and everyone! I want to make GetIt! a useful utility, let me know 
  141. what improvements you would like to see. GetIt! is *not* public domain and is
  142. not free.
  143.  
  144.  
  145.  
  146. If you donate, you will receive notices of future
  147. updates and additional documentation for future GetIt! versions.
  148. You will also be helping the program progress by making it
  149. possible for me to spend some more time on GetIt!
  150. You also get peace of mind, everytime you receive a system
  151. transfer from your MIDI device :-)
  152. Please send donations to:
  153.                   N-Focus Technologies
  154.                   1800 Stokes St. #197
  155.                   San Jose,CA 95126
  156.  
  157.  
  158.  
  159.  
  160.  
  161.                             Software License
  162.  
  163. Getit10.exe  MIDI Librarian.
  164. Getit20.exe  MIDI Librarian/File utility.
  165. Getit25.exe  MIDI Librarian/File utility.
  166. Getit30.exe  MIDI Librarian/Peek/Sequencer.
  167.  
  168.  
  169.  
  170.  
  171. You are free to use, copy and distribute Getit! for
  172. NONCOMMERCIAL use if:
  173.  
  174. **  No fee is charged for use, copying or distribution.
  175. **  It is not modified in any way.
  176.  
  177. Clubs and user groups may charge a nominal fee not to exceed ($10) for
  178. expenses and handling while distributing Getit!.
  179. Site licenses and commercial licenses for Getit! are available.  Consult
  180. the file write or call N-Focus Technologies for more information.
  181.  
  182.  
  183. N-Focus Technologies hereby disclaims all warranties relating to this
  184. software, whether express or implied, including without limitation any
  185. implied warranties of merchantability or fitness for a particular
  186. purpose. N-Focus Technologies will not be liable for any special,
  187. incidental, consequential, indirect or similar damages due to loss of
  188. data or any other reason, even if N-Focus Technologies or an agent of
  189. N-Focus Technologies has been advised of the possibility of such
  190. damages.  In no event shall N-Focus Technologies's liability for any
  191. damages ever exceed the price paid for the license to use software,
  192. regardless of the form of the claim.  The person using the software
  193. bears all risk as to the quality and performance of the software.
  194.  
  195.  
  196. Governing Law:
  197.  
  198.  
  199. This  state shall be construed, interpreted, and governed by  the 
  200. laws of the state of California, as well as those implications 
  201. made by the Federal copyright laws.
  202.  
  203.  
  204. TradeMarks:
  205.  
  206.  
  207. Turbo  Pascal  4.0  and  Turbo Pascal 5.0  are  a  trademarks  of 
  208. Borland,  MPU-401  is a trademark of Roland Music, IBM  PC  is  a 
  209. trademark of IBM Inc.
  210.  
  211.  
  212.  
  213.  
  214. 
  215.