home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / amfm / amfm2 / utilities / midicom / readme136.doc / readme136.doc
Text File  |  1994-06-20  |  14KB  |  350 lines
  1.                 ===============================================
  2. ›0;33m                              MIDICOM v1.36
  3.                   © 1989/90/91 - Animal Voice Production A/S
  4.                 Program design and development by Espen ßeranek
  5.                               All Rights Reserved.
  6. ›0;0m                ===============================================
  7.  
  8.                 1. Contents
  9.                 2. Installation
  10.                 3. History
  11.                 4. The calculator part 
  12.                 5. The MIDI panic button
  13.                 6. The transmit/receive part
  14.                 7. MIDI Filters
  15.                 8. MIDI Thru
  16.                 9. Colours
  17.                    10. The MIDI panel part
  18.                    10. Credits Window
  19.                    11. Other items
  20.                    12. Thanx...
  21.                    13. Copyright
  22. <Press Space>
  23. ›0;33m1. CONTENTS
  24. ===========›0;0m
  25.  
  26. This archive should contain the following files:
  27.  
  28.     MIDI/MIDICOMv1.36...........The MIDI utility program
  29.     MIDI/MIDICOMv1.36.info......MIDICOM's icon.
  30.     MIDI/Credits/Example1.....Example file for Music Credits
  31.     MIDI/Credits/Example2.....Example file for Music Credits
  32.     MIDI/FONTS/animal/8.......Fontdata for MIDICOM.
  33.     MIDI/FONTS/animal.font....Fontdata for MIDICOM.
  34.     MIDI/ReadMe136.doc........This file.
  35.     MIDI/ReadMe136.doc.info...This file's icon.
  36.  
  37. If some of the files are missing, please contact Mediafoto BBS in Oslo:
  38.  
  39.         +47 2 17 60 56 (300-9600, 24 hours)
  40.  
  41. ›0;33m2. INSTALLATION
  42. ===============›0;0m
  43.  
  44. MIDICOM makes use of the midi.library (Copyright © 1987-91 Pregnant Badger
  45. Music) and the req.library (Copyright 1989-90 by C.W. Fox and Bruce
  46. Dawson), so these files  must be installed in the libs-dir of Your startup 
  47. (WorkBench) disk. MIDICOM also needs the fontfiles for animal.font.
  48.  
  49. If You don't have midi.library or req.library, these files can be obtained
  50. from BBS-systems world-wide.
  51.  
  52. Make sure that both midi.library and req.library resides in the libs
  53. directory on Your startup (Workbench) disk.
  54. Copy animal.font to fonts-dir on Your WorkBench disk.
  55. Make a directory called animal in WorkBench:fonts.
  56. Copy the file '8' from fonts/animal to WorkBench:fonts/animal.
  57.  
  58. (The use of this font is to ensure MIDICOM look the way I planned
  59. it, also on a custom A-3000 WorkBench.....)
  60. You can invoke MIDICOM from both CLI and WorkBench.
  61.  
  62. ›0;33m3. HISTORY
  63. ==========›0;0m
  64.  
  65. MIDICOM started out as three different programming projects. The first one
  66. was a simple calculator (on my A500) written in AmigaBasic which task was
  67. to calculate the relationship between B(eats) P(er) M(inute) in a song and
  68. M(illi)S(econds) on my delays. When I started to learn to program in C, I
  69. made a small CLI calculator that would take a BPM-value as an argument and
  70. display the results to the console.
  71. Further investigation in the windowing enviroment on the Amiga, made me
  72. want to put the calculator into it's own windows (and screen).
  73. A little bit later I started fiddling with the MIDI-library from Bill
  74. Barton (the latest version of this library, as of this writing, can be
  75. obtained from Fred Fish disk 227). I made my own progs for sending and
  76. receiving MIDI-data. Then these programs where tied together to The Rythmic
  77. Calculator (with sysex utils).
  78. Another project I worked on was simply a test panel that would send any
  79. note on any MIDI channel. It also included some fixed controllers. This
  80. program was knowned as The MIDI Panel.
  81. All these programs have now joined forces and have become the MIDICOM
  82. program. In addition, I included a 'Music Credits' function to store
  83. detailed information about a song.
  84.  
  85. MIDICOM was written in C and compiled using the SAS/C-compiler version
  86. 5.10a on an Amiga 3000.
  87.  
  88. The different parts of MIDICOM are:
  89.  
  90. a.) The calculator part
  91. b.) The transmit/receive part
  92. c.) The MIDI panel part
  93. d.) The Music Credits part
  94. ›0;33m4. The Calculator part
  95. ======================›0;0m
  96.  
  97. The calculator part of MIDICOM is intended to be a utility for any 
  98. recording session that includes working with delays and/or sequencers. 
  99. The program will calculate the delay values that correspond with the 
  100. tempo of Your music. You input the tempo (BPM), and MIDICOM gives You 
  101. the alternatives for Your delays.
  102. To calculate, just click under BPM, enter Your tempo and press return.
  103. Your tempo should be within the range from 25 to 300. If not, a requester
  104. will tell You what mistake You've made. Click EXIT to return to program
  105. operation. The leftmost part of the empty boxes are now displaying the 
  106. different millisecond-values You can use for this tempo under 'MS' 
  107. (MilliSecond). Under 'TIME' You'll see what time-value (in KCS or others 
  108. with timing readouts) this delay will be like. Using these figures You 
  109. might easily make a MIDI-delay by copying an instrument-track and delay 
  110. it from the top of the sequence by adding the number given here.
  111. The note-values should be easy to understand, but the HEMICYCLE 
  112. might be new to You. This is to explain the hemicycle: If You have a 4/4 
  113. song like Pink Floyd's "Another Brick In The Wall", the hemicycle is the 
  114. delay-value similar to that on Gilmour's guitar. To explore the 
  115. calculations more deeply, try connect a drum-machine to a delayunit and 
  116. experiment with different tempos.
  117. To the right of BPM You'll find the letters PPQ. Just below it reads 240. 
  118. PPQ stands for Pulses Pr. Quarternote. This refers to the number of pulses
  119. sent by a MIDI sequencer for every quarternote played. If it's a high value
  120. (like 240), the sequencer is working on high resolution - it counts to 240
  121. each quarternote. When You select a new resolution, the TIME-column will
  122. change it's values of course.
  123. If you'd like to move some data in a sequence foreward or backwards in time,
  124. the actual amount of MS pr. tick according to Your tempo will be displayed
  125. as well.
  126. Also in the Messages box You'll see 'MORE HEMI-TIMES' followed by four
  127. numbers. These numbers will help You if You want to create a Hemicycle
  128. echoing effect within Your MIDI sequencer. 
  129. Here's how:
  130.  
  131. 1. Make four copies of the track You want to echo.
  132. 2. Delay the first clone with the first number given (360 for default).
  133. 3. Delay the second clone by the second number given (540 for default).
  134. 4. Delay the third clone with the third number given (720 for default).
  135. 5. Delay the fourth clone by the fourth number given (900 for default).
  136. 6. Decrease the overall velocity in clone 1 by e.g. 10
  137. 7. Decrease the overall velocity in clone 2 by (10+10)=20
  138. 8. Decrease the overall velocity in clone 3 by (10+10+10)=30
  139. 9. Decrease the overall velocity in clone 4 by (10+10+10+10)=40
  140.  
  141. There's Your echo!
  142.  
  143. The PPQ value defaults to 240, but You can change it the same way You input
  144. BPMs; click under the letters PPQ, delete the numbers present, and enter
  145. Your new PPQ value.
  146.  
  147.  
  148. ›0;33m5. The MIDI Panic Button
  149. ========================›0;0m
  150.  
  151. In case of serious MIDI-hangs, stuck notes etc, there's a panic button
  152. (formed as the Animal Voice Production's company logo) located on the
  153. lower left part of the Claculator window. This is handy if 'All Notes 
  154. Off' in the Panel window won't work. This might be true for some older 
  155. synths, as well as those whose 'notes off'-function must be activated 
  156. first. Pressing this button will send MIDICOM into a heavy reset
  157. procedure. In order to save time, the actions that MidiCom takes are not
  158. displayed.
  159. Here's what MIDICOM actually does after You've clicked on the panic button;
  160.  
  161. 1. Sends NOTE OFF message to all 127 MIDI notes on all 16 channels.
  162. 2. Sends a value of OFF (0x00) to all continuous controllers on all 16
  163.    channels.
  164. 3. Centers Pitchbends/wheels on all 16 channels.
  165. 4. Turns all AfterTouch (channel) OFF on all 16 channels.
  166. 5. Sends RESET ALL CONTROLLERS on all 16 channels.
  167. 6. Sets MIDI-Volume to full (0x7f) on all 16 channels.
  168. 7. Sets LOCAL ON on all 16 channels.
  169.  
  170. The MIDI filter is set to 'ALL' during panic. Afterwards, filter is set to 
  171. default. The MIDI Panic button is duplicated by the DEL-key on the Amiga
  172. keyboard.
  173.  
  174. ›0;33m6. The transmit/receive part
  175. ============================›0;0m
  176.  
  177. The TRANSMIT and RECEIVE gadgets are the door to these functions.
  178. (They are duplicated by 'Load' and 'Save' in the menus as well as keys 'l'
  179. and 's')
  180. Clicking on either gadget will bring up the (Req) file-requester.
  181. If You chose TRANSMIT, You simply click on the filename desired.
  182. If You chose RECEIVE, You may enter a filename in the requester.
  183. Click OK to enter the operations. In case of RECEIVE;
  184. If You haven't got a MIDI connection to Your Amiga, MIDICOM will 
  185. wait until it receives a *BREAK. You can send such a *BREAK by clicking in
  186. the little window on the WorkBench called MIDICOM followed by pressing 
  187. CTRL-C. 
  188. The kind of data MIDICOM will wait for depends on the MIDI filter settings.
  189. See below for details.
  190.  
  191. ›0;33m7. MIDI-FILTERS
  192. ===============›0;0m
  193.  
  194. You have the option to deside what kind of MIDI data MIDICOM will receive.
  195. You set this from the menu named MIDI Filters.
  196. The item You select will be the only type of data MIDICOM will recognize.
  197. The default setting will recognize these datatypes:
  198.  
  199. ›0;33m    - Channel Messages
  200.     - Note On Messages
  201.     - Note Off Messages
  202.     - Polyphonic Pressure
  203.     - Control Messages
  204.     - Program Change
  205.     - Channel Pressure 
  206.     - Pitchbend Messages
  207.     - Mode Messages
  208.     - System Exclusive Messages
  209. ›0;0m
  210.  
  211. ALL will add System Common and System Realtime to this list. The other
  212. items will exclude all others but itself (hence the mark in the menu).
  213. DEFAULT, ALL, NOTE ON/OFF and CHANNEL MESSAGES settings will echo MIDI 
  214. IN to MIDI OUT. If You didn't turn LOCAL OFF (either on Your keyboard 
  215. or in the Panel) You might get double, chorused notes as the synth 
  216. receives notes from both MIDICOM and the physical keyboard.
  217.  
  218.  
  219.  
  220.  
  221. ›0;33m8. MIDI THRU
  222. ============›0;0m
  223.  
  224. This is a toggle switch that will feed whatever comes in on MIDI IN to MIDI
  225. OUT (according to the MIDI Filter settings). You should set this switch to 
  226. off when You use the SysEx services. It is handy if You have turned local 
  227. off on Your master keyboard, but still want to play the keyboard for 
  228. monitoring of sounds.
  229.  
  230.  
  231.  
  232. ›0;33m9. Colours
  233. ==========›0;0m
  234.  
  235. You can create Your own coloursettings by using the colour-palette. 
  236. The colour-palette is invoked by pressing 'x' from the Calculator window,
  237. or selecting from the menu. The default colours are brought to Your screen
  238. by pressing 'z'.
  239.  
  240.  
  241.  
  242.  
  243. ›0;33m9. The MIDI panel part
  244. ======================›0;0m
  245.  
  246. Clicking on Panel, select from menu or pressing 'p' brings You to the 
  247. MIDI control panel page. 
  248. (Don't press right mouse button here if You're running AmigaDOS 1.3.)
  249. All the gadgets in The MIDI-Panel should be easy to understand. 
  250. They send their labeled information through the Amiga's MIDI OUT. 
  251. Sending a note requires an octave and a MIDI channel. 
  252. Use the sliders and number keys 0-9.
  253. (Don't press 'p' while in the panel part unless You want to make the Amiga
  254. hang.......)
  255. The middle slider has no label. You can input any number between 0 and 127,
  256. and this will be the controller number assigned to this slider.
  257. If You choose 7 for controller, the slider will act as a MIDI-volume
  258. slider. Entering 1 will duplicate the VIBRATO button (MOD WHEEL
  259. CONTROLLER), but now You can adjust the amount of vibrato with the slider.
  260. Experiment for Yourself.
  261. The status-gadgets as well as the notes-gadets are all toggle switches.
  262. This does not apply to ALL NOTES OFF, AfterTouches OFF (AT OFF)  and 
  263. RESET CTRL.
  264.  
  265. If Your MIDI equipment does not support all the functions of the Panel,
  266. they will have no effect. Look through the MIDI specification that came
  267. with Your gear. 
  268.  
  269.  
  270. ›0;33m10. Music Credits Window
  271. ========================›0;0m
  272.  
  273. By clicking on 'Credits' in the Calculator/SysEx Window, or pressing 'c' or
  274. selecting Credits from the menu, You'll find Yourself in the Music Credits
  275. Window. 
  276. (Don't press right mouse button here if You're running AmigaDOS 1.3.)
  277. This is a meant to be a very simple place to store more detailed
  278. information about a song. Just click on the 'Load'-gadget, and try to load
  279. one of the supplied sample .CRED files. Study the data, alter them by
  280. clicking to the rigt of the headings (e.g. just above the line to the right 
  281. of TITLE:). Edit the information, and save it under a filename. MIDICOM
  282. will not put on any extension to the filename, but it might be a smart
  283. thing to add .CRED or anything else as an extension for identification later
  284. on. The fields to edit include: Song title, composer, author (lyrics),
  285. arranger, time signature, framerate, SMPTE offset and the number of bars
  286. (length). Tempo is not editable here. You edit tempo when in
  287. Calculator/SysEx window for calculations.
  288. Exit the Music Credits window by closing it. There are no pulldown menus
  289. here! To get the new tempo, length and time signature into the
  290. calculations, just press 'r' or select 'Recalc' from the Calulator/SysEx'
  291. Modes-menu.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298. ›0;33m11. Other items
  299. ==============›0;0m
  300.  
  301. If You feel that the calculator and sysex window is messed up, select Clear
  302. from the menu. You can also recalc all values by selecting recalc from the 
  303. menu or by pressing 'r'.
  304.  
  305. To quit MIDICOM click 'EXIT MIDICOM' or select 'Quit' from the menu.
  306. If You press 'ESC', the 'Are You Sure?' requester will not appear, and
  307. MIDICOM exits right away.....
  308.  
  309.  
  310. ›0;33m12. Thanx....
  311. =========›0;0m
  312.  
  313. I would like to address thanx to the following;
  314.  
  315.     Robert Fripp        - for playing the guitar
  316.     Matt Johnson        - for making records
  317.     *Art             - for VScan, knowhow and spirit
  318.     Bill Barton        - for the MIDI library
  319.     Colin W. Fox        - for the Requester library
  320.     Bruce Dawson        - for the Requester library
  321.     Jack Deckard        - for the MIDI Tools package
  322.     Mediafoto         - for the best BBS around...
  323.     J. Niska        - for being a good friend
  324.     You            - for reading this and maybe using MidiCom
  325.     
  326.  
  327. ›0;33m13. COPYRIGHT NOTICE
  328. ====================›0;0m
  329.  
  330. MIDICOM is not Public Domain!
  331. MIDICOM is Copyright © 1989-91 Animal Voice Production A/S. 
  332. All rights reserved. 
  333.  
  334. The MIDICOM program is freely distributable as long as no commercial
  335. benefit is made on it.
  336.  
  337. Contact: MediaFoto BBS, Oslo
  338.          +47 2 17 60 56
  339.          The MIDI Conference
  340.  
  341.  
  342.  
  343.  
  344. All files in this archive must be distributed together as is!!!!
  345.  
  346.  
  347.  
  348. Espen ßeranek
  349.  
  350.