home *** CD-ROM | disk | FTP | other *** search
/ Audio Version 4.94 / audioversion4.94knowledgemediaresourcelibraryoctober1994.iso / msdos / midi / getit30 / getit30.doc < prev    next >
Text File  |  1989-02-05  |  8KB  |  159 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. The sample .SCR files are script files demonstrating Getit's script
  74. ability.
  75.  
  76. The commands available to you are:
  77. A  All notes off.
  78. B  Blank (clear) the screen.
  79. K  Wait for (IBM) keypress.
  80. M  Display message following M to (IBM) screen .
  81. N  <channel> <noteX> <velX> Play note.
  82. P  <channel> <patchnumX>     Send patch change.
  83. R  <num>  Receive <num> transfers from MIDI device.
  84. S  Send a system message $F0 <messageX> $F7
  85. W  <num>  Wait <num> milliseconds.
  86. Z  Save the systex transfers.
  87. [  <starting index> Start loop at index.
  88. ]  <ending index>   End loop at index.
  89. X  Replace with Loop Index.
  90. /,\,{,},(,),;, are comment markers, follow with any comment.
  91. Variables that end with an X can be replaced with the current
  92. loop index.
  93.  
  94. NOTE:
  95. The M and comments only work on a *line* basis. You can only place comments
  96. and messages on a line by themselves on this release. I plan improve
  97. on this in later versions. Do not mix commands and message/comments on one
  98. line.
  99.  
  100.  
  101. A loop is defined as:
  102. [ <start number>
  103.     <any command>
  104. ] <end number>
  105.  
  106.  
  107. 5) SEQUENCER MODE: GetIt30 s
  108. GetIt! is also a simple MIDI sequencer. To start, just type
  109. "GetIt30 s" on the command line and GetIt! will prompt you through
  110. the sequencers 2 modes, record and play.
  111. When record is activated, GetIt! will wait for you to "press a key"
  112. on your MIDI controller before starting the record process.
  113. Pressing <return> will stop the procedure and prompt you for a save.
  114. The sequencer processes are simple and hopefully should not be hard
  115. to understand. The sequencer is set up so that MIDI thru is OFF,
  116. and benders/controllers are recorded. Hopefully, you will find
  117. this sequencer usefull for tiny "spur of the moment" thoughts.
  118. If you have an idea for a song, just start GetIt! and record it!
  119.  
  120. ROUTINES FOR GETIT!
  121. GetIt! uses the TurboMIDI toolkit, available from N-FOCUS Technologies.
  122. TurboMIDI allows you to write MIDI librarians, Simple MIDI sequencers,
  123. MIDI mappers, Ear training programs, and MIDI utilities like GetIt!.
  124. TurboMIDI requires Turbo Pascal 4.0 from Borland International.
  125. The source for several MIDI programs are included free with the
  126. TurboMIDI toolkit and an 8 track simple sequencer that you can use in your
  127. own applications. Source code for TurboMIDI will be available at a future
  128. date.
  129.  
  130. HERE IT COMES:
  131. Yes, GetIt! is a MIDI SHAREWARE utility, and the author <me>
  132. requests that if you like and use GetIt! and find it useful
  133. please send a $15 donation.
  134.  
  135. Regarding my Shareware thoughts:
  136.  If you like GetIt! (I hope you do), please send the $15 amount. 
  137. Almost anyone should be able to "scrape" up the $15 amount. If you
  138. can afford a MIDI device, then you can pay for GetIt!.  If you truly
  139. cannot pay for GetIt!, then just send me a note telling me so and you will
  140. be added to the registered users list anyway.  When you can pay for GetIt!
  141. I will expect you to contribute. Please do give copies of GetIt! to 
  142. anyone and everyone! I want to make GetIt! a useful utility, let me know 
  143. what improvements you would like to see. GetIt! is *not* public domain and is
  144. not free.
  145.  
  146.  
  147.  
  148. If you donate, you will receive notices of future
  149. updates and additional documentation for future GetIt! versions.
  150. You will also be helping the program progress by making it
  151. possible for me to spend some more time on GetIt!
  152. You also get peace of mind, everytime you receive a system
  153. transfer from your MIDI device :-)
  154. Please send donations to:
  155.                   N-Focus Technologies
  156.                   1800 Stokes St. #197
  157.                   San Jose,CA 95126
  158. 
  159.