home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 7 / af007.adf / MED / med.doc < prev    next >
Text File  |  1987-06-04  |  17KB  |  382 lines
  1. >ZM
  2. -----------------------------------------------------------------------------
  3.    MM     MM EEEEEEE  DDDDD                   Instructions for version 1.12
  4.     MM   MM   E    E   D   D
  5.     M M M M   EEEE     D    D
  6.     M  M  M   E    E   D   D
  7.    MMM   MMM EEEEEEE  DDDDD   - Music EDitor    21.9.1989
  8. -----------------------------------------------------------------------------
  9.  
  10. MED is a music editor much like SoundTracker, but more friendly to the user.
  11. You can easily create music for example for your C programs.
  12.  
  13. A song consists of blocks. There can be 50 blocks in v1.12.
  14. You can then play the blocks in any order. The best way to learn to
  15. use the program is trying. Here are some instructions:
  16.         1. Run MED from Workbench or CLI (If you run it from CLI,
  17.            CD to MED-directory).
  18.         2. When the program has loaded, select "Load song" from
  19.            the "Project"-menu.
  20.         3. Type /MED/Examples/Song1 and press Return or click OK!-gadget.
  21.         4. When the song has loaded, click "Play song"-gadget and listen!
  22.         5. When you are fed up with the song, click "Stop playing".
  23.  
  24.   If you want to try your own composing skills, choose "New song" from
  25. "Project"-menu. A small requester will appear. Click "Clear song only",
  26. so that you could use the samples in memory. You can choose a suitable
  27. sample with Shift and cursor left/right-keys. Playing happens with
  28. letter and number keys so that Q or Z is C, 2 or S is C#, W or X is D, etc.
  29. The keys are in the same order as in the piano. There are three octaves and
  30. two of them are in use at a time. You can change them with F1 and F2-keys or
  31. with "Oct"-gadget located in the upper right corner of the screen.
  32.   When you want to edit, click "Edit"-gadget. Then you can place notes in
  33. this block. You can move the cursor with cursor keys, of course. You can
  34. delete a note or just leave a space with DEL-key. There are of course four
  35. audio channels. If you want to listen this block, select "Play block".
  36. "Stop playing" will stop it. When you have finally finished your first block,
  37. you can create another one. Click "New Blck"-gadget to create a new block.
  38. You can move to it by clicking "Next"-gadget of "Move to:". An easier way
  39. is Shift-cursor down.
  40.   It's sometimes necessary to switch off some channels. It is possible
  41. with four "Chnls"-gadgets or numbers 1-4 of numeric keypad. "Continue block"
  42. will begin to play block from cursor. If you're playing a song, this block
  43. will begin to loop forever.
  44.   "Continue song" will continue playing the song from the block pointed by the
  45. playing-sequence window.
  46.   If you want to delete a block from the end of the song, you can select
  47. "Remove last block" from "Block"-menu.
  48.   You can program the sequence of blocks in the song with six gadgets located
  49. on the right side of the screen. On the left side of the gadgets is a small
  50. window. There is the number of the block playing at the moment and the numbers
  51. of the previous and the next block. You can scan the playing sequence with two
  52. arrow-gadgets. With two gadgets right of the arrow-gadgets, you can move
  53. quickly to the beginning and end of the song. The changing of the playing
  54. sequence is possible with + and - gadgets. If you want to add a block to the
  55. sequence, move to the last number and click the arrow-down gadget, then
  56. click +. If you'd like to remove the last one, move to the last number,
  57. click the arrow-down gadget, then click - gadget. You can modify the shadowed
  58. number with + and - gadgets. You can use + gadget only to the highest block
  59. (You can't define block number 9, if you don't have ten blocks!).
  60.  
  61.  
  62. Samples:
  63.  
  64.   For easy loading of samples (instruments), MED reads a file
  65. named MED_paths during start-up (if it exists). This file includes
  66. the information where to find the samples and their repeat/repeat length
  67. (Presets in SoundTracker). It is easy to edit this file with some text
  68. editor e.g. MicroEMACS. MED can also load IFF-samples. You don't need
  69. repeat/rep.len.-numbers with them.
  70.   The format of this file is following:
  71.  
  72. *ST-01:                         <- First an asterisk, then the directory name
  73. Aligator                        <- The name of the sample. No spaces!
  74. AnalogString::3326/4970         <- If you want to specify repeat/repeat length,
  75. Asia::480/5362                     type two colons, repeat number, slash, and
  76. ....                               repeat length.
  77. WoodBlock
  78. WowBass
  79. *Disk:samples/                  <- Remember to type a slash after dir name
  80. Sample1
  81. Sample2
  82.  
  83.   MED_paths-file must be located in the current directory or the S:-directory
  84. when starting the program.
  85.   There can be 30 samples in memory. You can scan them with "Previous" and
  86. "Next"-gadgets (or easier...Shift + cursor right/left). When you want to
  87. load the sample, type its name on the string gadget under "Load sample"-gadget.
  88. Then press Return or click "Load sample". The sample will load (if you
  89. haven't done any mistakes). You can alter the setting of the sample with
  90. "Change settings" of "Sample"-menu. You can set the volume of the sample,
  91. its repeat beginning offset and length. You'll also see the length of the
  92. sample in bytes.
  93.   Repeat means that you can loop some portion of the sample forever.
  94. Repeat is the offset of the beginning of the loop and Repeat length is the
  95. length of the loop (in bytes).
  96.   If you have loaded a sample which you don't need any more, you can remove it
  97. by selecting "Remove sample" from "Sample"-menu. "Save raw sample" will
  98. save the sample as raw data without IFF-chunks. If you don't know what it
  99. means, don't worry. Then you'll never need this option.
  100.  
  101.  
  102. Filter:
  103.  
  104.   With "Filter"-gadget (on the left side of the screen) you can switch off
  105. the low-pass-filter in A500/2000/2500-models. There will be some distortion
  106. but usually the sound improves considerably. Try it. The state of the
  107. filter will be saved with songs.
  108.  
  109. Editing options:
  110.  
  111.   There are some options that will make editing easier. One of them is
  112. "2×space" under "Edit"-gadget. When you turn it on, there will be a double
  113. space between the notes entered. It'll help you when composing melodies etc.
  114. The rest of them are in the "Block"-menu:
  115. Cut track       will copy the track where the cursor is located into the buffer
  116.                 and clears the track.
  117. Copy track      only copies the track
  118. Paste track     copies the track from the buffer to the track under cursor.
  119. Cut block       copies all the four tracks to the buffer and clears the block
  120. Copy block      copies the tracks into the buffer
  121. Paste block     copies the buffer to the current block
  122.  
  123. There are many different shortcuts. There's a list at the end of this file.
  124.  
  125. Colors:
  126.  
  127.   This is a feature not found in most professional music packages. You
  128. can change the screen colors!!!!! They will be saved with the song.
  129. Choose "Set colors" from "Misc."-menu. A color requester will appear.
  130. It's probably familiar to you. "Reset colors" will reset the colors.
  131.  
  132. Guy:
  133.  
  134.   This "feature" is the most unique one found in this program! Jumping guy!
  135. If you are a serious person, you can select "Don't jump" from "Guy"-submenu
  136. of "Misc."-menu and forget the whole thing!
  137.   If you choose "Every 8. note", the guy I have named "Topi" will jump
  138. in every 8th note. A more interesting option is "Sample ctrl". Then you can
  139. select the samples that cause Topi to jump. When you've selected this option,
  140. search a suitable sample (usually drums) and press the small gadget on the
  141. right side of the "Load sample"-gadget. You can select as many samples as you
  142. want. Topi will jump when any of the selected samples will be played.
  143. All these options will be saved with songs.
  144.  
  145. Tempo:
  146.  
  147.   You can choose the tempo for you song with "Set tempo" of "Project"-menu.
  148. Choose it and a requester will appear. With the proportional gadget you
  149. can choose the tempo. If it is very fast, the screen updating will slow
  150. down and it begins to "jump".
  151.   Slides/note means the number of up/down-slides during one note. Choose 5 if
  152. you want to play SoundTracker songs. Otherwise select 6.
  153.  
  154.  
  155. Effects:
  156.  
  157.   MED can create several different effects: slides up and down, changing the
  158. volume, vibrato, arpeggio and changing the tempo.
  159.  
  160.   As you have probably noticed, there are four numbers after the note name.
  161. You can modify them in edit mode.
  162.   The first number is the number of the sample. It can be in range 0-U.
  163. If it's 0, the note will be played with the same sample as the previous note.
  164.   The second number is the number of the effect. It can be from 0 to F.
  165.       Number                    Effect
  166.         0       If the last two numbers are 0, no effect, otherwise arpeggio.
  167.         1       Slide up
  168.         2       Slide down
  169.         3       Vibrato
  170.        4-B      Reserved for future expansion
  171.         C       Change volume
  172.        D,E      Crescendo,diminuendo
  173.         F       Set tempo
  174.  
  175.   The last two numbers contain more information about the effect,
  176. e.g. a new tempo.
  177.  
  178. Arpeggio (0)
  179.   It's possible to create chords with one audio channel. It is done by
  180. changing the pitch of the note very fast (6 times/note). MED can use
  181. the pitches of three notes at a time.
  182.   If both of the righthand-side numbers are 0, there'll be no effect.
  183. If not, the effect will be determined as follows:
  184.  
  185. E.g. The arpeggio of the major chord is 47 (or 74), because the second
  186.      note of the chord is 4 half steps from the first note and the third
  187.      note is 7 half steps above the first note.
  188.  
  189.   G-2 E-2 C-2 G-2 E-2 C-2 (MED will play the arpeggio from up to down)
  190.   \_____________________/
  191.         1 note
  192.  
  193.  C-2 C#2 D-2 D#2 E-2 F-2 F#2 G-2 G#2 A-2 A#2 H-2
  194.   0   1   2   3   4   5   6   7   8   9   A   B
  195.   \_______________|___________/
  196.                   |
  197.            Major chord
  198.  
  199. Slide up (1)
  200.   Slides the note up 6 * (two numbers on the right side) periods.
  201. (or 5 * (2 numbers on the right side) if set in tempo-requester).
  202. Period is a pitch of the note used directly by Amiga audio hardware.
  203.  
  204. Here's a table of periods for notes if samples are digitized with the
  205. same frequency as the samples included. MED uses these values.
  206.  
  207.                 Octave
  208. Note      1       2       3
  209. C       856     428     214
  210. C#      808     404     202
  211. D       762     381     190
  212. D#      720     360     180
  213. E       678     339     170
  214. F       640     320     160
  215. F#      604     302     151
  216. G       570     285     143
  217. G#      538     269     135
  218. A       508     254     127
  219. A#      480     240     120
  220. H       453     226     113
  221.  
  222. How to use this table?
  223.  
  224. For example: You want a nice slide from C-2 to G-2.
  225.              C-2's period is 428 and G-2's 285.
  226.              So we must slide it 143 steps up.
  227.              Let's divide it by six: 143/6=23.833333... rounded to 24.
  228.              If we wanted to do this slide in one note, it would be
  229.                 C-2 x118 because 24 is (hex)18.
  230.              Because the note was slided actually 24*6=144 steps,
  231.              the final note is a little untuned, but not many people
  232.              can notice it.
  233.              If you liked to make the slide a bit slower, you could do
  234.              it for example:
  235.                         C-2 110C                C-2 1106
  236.                         --- 010C        or      --- 0106
  237.                                                 --- 0106
  238.                                                 --- 0106
  239.  
  240. Slide down (2)
  241.   Just like slide up except this one slides it down.
  242.  
  243. Vibrato (3)
  244.   Vibrato changes the period of the note between two frequencies. The first
  245. is the normal period of the note and the other is the normal period plus
  246. the last two numbers: the bigger the number, the bigger the vibrato.
  247.  
  248. E.g.    C-2 1305 would change the period between 428 and 428-5=423.
  249.  
  250. Volume (C)
  251.   This one sets the volume of the note. The volume can be a number between
  252. 0 and 63. This is not a hex number. In fact it's a BCD-number, but you
  253. don't have to worry about it.
  254.  
  255. Example:        C-2 1C35 plays the note with volume 35
  256.  
  257.                 D-3 1000
  258.                 --- 0C00 suddenly the note disappears
  259.  
  260.                 E#1 1C10 <- begin quietly
  261.                 --- 0C63 <- to full volume
  262.  
  263. Slide volume (cresc., dim.) (D)
  264.   This effect does the crescendo/diminuendo, with formula Dxy
  265.  
  266. If x > 0 crescendo 6 * x units.
  267. else diminuendo 6 * y units.
  268.  
  269. Examples:       C-3 1000
  270.                 --- 0D02 <- diminuendo 6*2 = 12 units
  271.  
  272.                 D#2 2000
  273.                 --- 0D10 <- crescendo 6*1 = 6 units
  274.  
  275.                 E-1 5000
  276.                 --- 0D45 <- crescendo 24 units, number five is not used
  277.  
  278. Effect E works like D. It is provided for SoundTracker compatibility.
  279.  
  280. Set tempo (F)
  281.   This command sets the tempo. It can also cause moving to the next block.
  282. This command is NOT SoundTracker-compatible. The two righthand-side numbers
  283. are the new tempo. This is a hex number. If they are 0, the song pointer will
  284. move to the next block of the sequence.
  285.  
  286. Examples:       C-3 8F20 <- New tempo 32 (hex 20 = dec 32)
  287.  
  288.                 F-2 1F00 <- Move to the next block. This makes it possible to
  289.                             create 3/4-songs or upbeat.
  290.  
  291. Here's a table for SoundTracker to MED-conversion:
  292.         SoundTracker    MED
  293.             F07         F1B
  294.             F06         F20
  295.             F05         F2F
  296.             F04         F35
  297.             F03         F40
  298.             F02         F6A
  299.             F01         FD4
  300.  
  301. About MED:
  302.  
  303.   MED is entirely written in C (Lattice 5.02). It works with all 680x0
  304. processors and probably with all the new versions of the OS. It supports
  305. multitasking, uses hardware directly only with the filter, also loads
  306. songs made with SoundTracker and SoundFX (can't play SoundFX's effects).
  307. It loads IFF 8SVX-samples.
  308. You can click in the title bar area to get the title bar. The screen
  309. updating will stop to allow other processes to run faster. Click anywhere
  310. on MED screen to remove the title bar.
  311.  
  312.   You may freely distibute MED. Please don't sell it. Please copy ALL files
  313. included with MED (instructions etc.)
  314.  
  315.   I want to develop MED!!! Please tell me anything what you'd like to see in
  316. the next version of MED.
  317.  
  318. Send all complaints, wishes, comments, bug reports etc. to:
  319.  
  320.                         Teijo Kinnunen
  321.                         Oksantie 19
  322.                         SF-86300  OULAINEN
  323.                         FINLAND
  324.  
  325. Here are the keyboard shortcuts:
  326. Key                             Effect
  327.  
  328.   F1                    Use octaves 1 and 2
  329.   F2                    Use octaves 2 and 3
  330.   F3                    Copy three effect numbers from the upper note
  331.   F6                    Cursor to line 0
  332.   F7                    Cursor to line 16
  333.   F8                    Cursor to line 32
  334.   F9                    Cursor to line 48
  335.   F10                   Cursor to line 63
  336.   DEL                   Erase this note, if the cursor on any number, zero it.
  337.   Help                  About MED...click it to remove it
  338.   Keypad 1-4            Channels 1-4 on/off
  339.   Cursor up             Cursor up
  340.   Cursor down           Cursor down!
  341.   Cursor left           Cursor left!!
  342.   Cursor right          Cursor right!!!
  343.   Shift+Cursor left     Previous sample
  344.   Shift+Cursor right    Next sample
  345.   Alt+Cursor left       Cursor to the previous track
  346.   Alt+Cursor right      Cursor to the next track
  347.   Shift+Cursor up       Previous block
  348.   Shift+Cursor down     Next block
  349.   Alt+Cursor up         Move to first block
  350.   Alt+Cursor down       Move to last block
  351.   Shift+Alt+Cursor left If sample is > F, move to sample F, otherwise 0
  352.  Shift+Alt+Cursor right If sample is < F, move to sample F, otherwise U
  353.   Left-Amiga+P          Play song
  354.   Left-Amiga+B          Play block
  355.   Left-Amiga+C          Continue song
  356.   Left-Amiga+S          Stop playing
  357.   Left-Amiga+F          Filter off/on
  358.   Left-Amiga+I          Activate the gadget of the sample name
  359.   Shift+Left-Amiga+I    Clear and activate the gadget of the sample name
  360.   Left-Amiga+J          Set Topi (the guy) to jump when this sample is played
  361. And the following menu short-cuts:
  362.   Right-Amiga+S         Save song
  363.   Right-Amiga+L         Load song
  364.   Right-Amiga+T         Set tempo
  365.   Right-Amiga+Q         Quit
  366.   Right-Amiga+D         Cut track
  367.   Right-Amiga+C         Copy track
  368.   Right-Amiga+V         Paste track
  369.   Right-Amiga+I         Change settings
  370.  
  371. Finally...about the string in the middle of the screen:
  372.   N:01/05 B:02/03 S:1
  373.     |   |   |   |   \sample number
  374.     |   |   |   |
  375.     |   |   |   the number of the last block
  376.     |   |   |
  377.     |   |   the number of the current block
  378.     |   |
  379.     |   the number of blocks in the playing sequence
  380.     |
  381.     the number of the current block in the playing sequence
  382.