home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / audio / utils / med_424 / docs / medv2.13.doc < prev    next >
Text File  |  1990-12-30  |  62KB  |  1,345 lines
  1. ***************************************************************************
  2. **                                                                       **
  3. **          MED - music editor, by Teijo Kinnunen 1989, 1990             **
  4. **                                                                       **
  5. **          Instructions for version 2.1x                 14.7.1990      **
  6. **                                                                       **
  7. ***************************************************************************
  8.  
  9. Welcome to use MED-music editor!!! MED is basically just one SoundTracker-
  10. clone, but there are many features that SoundTracker lacks (e.g.
  11. MIDI-support).
  12.  
  13. First few words about editing. If you've used SoundTracker, you probably
  14. know these things.
  15. MED doesn't use standard notation (like DMCS, for example). Instead
  16. the music is represented by note names and numbers.
  17. Example:
  18.         01  C-2 1000  --- 0000  E-5 K210  --- 0F20
  19.         02  D-2 1000  E#1 4000  --- 0000  --- 0000
  20.         03  --- 0000  --- 0000  --- 0000  --- 0000
  21.         etc.
  22. There are both advantages and disadvantages. A disadvantage is that you
  23. can't print notes that anybody could play. The advantages are for example
  24. faster and more powerful editing and the possibility to control the sound
  25. more powerfully.
  26.  
  27. The song consists of blocks, every block contains 1 - 256 lines. There can
  28. be up to 100 blocks and they can be played in any order and any number of
  29. times.
  30.  
  31. Then about the program itself:
  32.  
  33. The user interface of MED is divided in ten "panels", each one containing
  34. different gadgets. Only one of these panels is visible on the screen. You
  35. can select the displayed panel with ten gadgets which are always visible.
  36. There are lots of keyboard shortcuts. After you've learned the use of the
  37. program, you probably want to learn these shortcuts because they make
  38. the program much more powerful to use. There are also some things which
  39. are available only using the keyboard, so you should read the list of
  40. keyboard shortcuts at the end of this file.
  41.  
  42. Entering the notes
  43. ==================
  44. Notes are entered with Amiga's keyboard (entering with MIDI-keyboard is
  45. also possible). The keys are ordered in piano style:
  46.  
  47.      2 3   5 6 7   9 0   ´ \
  48.     Q W E R T Y U I O P Å ]
  49.       S D   G H J   L Ö
  50.      Z X C V B N M , . /
  51.  
  52. This way you can enter about 2,5 octaves of the 5,2 octaves available.
  53. Keys F1 - F4 can be used to switch the octaves. The lower row of keys
  54. (Z - /) is the lower octave, Q - U is the higher octave and keys I - \
  55. are part of even higher octave.
  56.  
  57. If you have an instrument loaded, you can hear the sound when you press
  58. the keys. If you want to enter notes to the block, you must turn on
  59. editing (Esc). DEL-key is used to enter the pause (---). The cursor can
  60. be moved with the cursor keys.
  61.  
  62. Blocks and the playing sequence
  63. ===============================
  64. When you compose a song, you do it block-by-block. Fill a block with
  65. notes, create new block, fill it with notes...
  66.  
  67. To get the blocks played in correct order, you must create also the
  68. playing sequence list. It is just a list of block numbers, which are
  69. then played in that order, from beginning to end. This way you can play
  70. the same block many times in your song. When the last block from the list
  71. has been played, the song will start again from the beginning. It's also
  72. possible to stop the playing. The maximum length of the playing sequence
  73. is 256 numbers. This should be enough for any use (if not, write me and I
  74. may fix that in a future version).
  75.  
  76. Status bar
  77. ==========
  78. Between the panel and the block display is the status bar, which displays
  79. some "strategic" information which is always good to be visible.
  80.  
  81.  +-------+-----+--+-+--+--------+--+------------------------+
  82.  |001/003|00/02|12|E|2×|::::::::|01|AnalogString            |
  83.  +-------+-----+--+-+--+--------+--+------------------------+
  84.      |       |  |  |  |   |      |         |
  85. Playseq-ptr  |  |  |  | Tracks  Instr #   Instrument name
  86.              |  |  |  |
  87.         Block # |  |  Insert empty note between notes
  88.                 |  |
  89.  Keyboard octaves  Editing on
  90.  
  91. Playseq-ptr: The first number is the current playing sequence number
  92.              (starting from 1) and the second is the number of playing
  93.              sequence numbers in the song. The 1st number is meaningful
  94.              when you're playing the song or editing the playseq list.
  95.  
  96. Block #:     The first number is the number of the current block (starting
  97.              from 0) and the 2nd is the number of the last block. It does
  98.              not tell how many blocks there are, but if you add 1 to it,
  99.              it does. In the example there are 3 blocks, and the first
  100.              is currently displayed.
  101.  
  102. Keyboard octaves:
  103.              This number tells you which octaves are currently in use
  104.              when you play the Amiga keyboard. The first number is the
  105.              octave number of the lower row of keys and the 2nd is the
  106.              higher. It can be changed with F1 - F4.
  107.  
  108. Editing on:  This is a quite important option. When the editing is off,
  109.              you can't insert notes or numbers to the song. To turn it
  110.              on/off press Esc or click the "E" with mouse. When the "E"
  111.              is highlighted, editing is on.
  112.  
  113. 2×:          This switch activates the double space between the notes you
  114.              enter. It is useful when you're entering slow pieces of music.
  115.              You don't have to hit DEL so much.
  116.  
  117. Tracks:      It's possible to switch tracks on/off during editing. The 16
  118.              points represent the 16 possible tracks. When the point is
  119.              red (default) the track is turned on. When it's white, then
  120.              this track is turned off.
  121.  
  122. Instr #:     The number of the current instrument. The maximum number of
  123.              instruments is 63. The instruments are "numbered"
  124.              01 - 1V.
  125.  
  126. Instrument name:
  127.              The name of the current instrument.
  128.  
  129. You can change the instrument number, current block and current playseq ptr
  130. by clicking on the number you want to change with the mouse. Left button
  131. increases, right button decreases. This is the fastest way to advance
  132. playseq ptr for example by 100: click the 100's number with LMB.
  133.  
  134. Instruments
  135. ===========
  136. As noted above, there can be up to 63 instruments in one song. There are
  137. currently two types of instruments: samples and MIDI instruments.
  138.  
  139. Samples: These are the instruments which are played through four Amiga
  140.          audio channels. They can be played only within tracks 0 - 3.
  141.          MED can load raw samples and IFF 8SVX 1, 3 and 5-octave samples.
  142.          It means that you can load practically any sample to MED and
  143.          use it in your songs. Note that raw samples and 1-octave 8SVX
  144.          samples can use only octaves 1 - 3. Octaves 4 and 5 play from
  145.          octave 3.
  146.  
  147. MIDI instruments:
  148.          These are not actually instruments. They are just few settings
  149.          which cause the notes played with that instrument to be sent
  150.          through MIDI-interface. They don't take memory like the samples.
  151.          When you want some instrument to be a MIDI-instrument, you must
  152.          set the MIDI channel which is used when playing notes/effects.
  153.          You can also set the preset value for the instrument. Then
  154.          the instrument is automatically played using that preset number
  155.          of your MIDI-device (synthesizer, keyboard...). You can also
  156.          set the preset number to 0. Then the preset which is already
  157.          set in that channel is used.
  158.  
  159. Sample loading
  160. ==============
  161. Because many people have hundreds/thousands of samples, spread over
  162. many different disks/directories, they have to be organized some way.
  163. MED handles the organization using a file "MED_paths" (path file).
  164. It contains the name of the directory, names of the samples in that
  165. directory, name of another directory...and so on. This way MED knows
  166. what samples each of your sample disks/directories contain and can
  167. load samples from correct disks. The path file is loaded when starting
  168. up MED and it must be located in the current directory or S:-directory.
  169. This file can be produced with text editor, but it is easier to do it
  170. with MED. Detailed instructions later in this file.
  171.  
  172. Note
  173. ====
  174. The note and the numbers:
  175.  
  176.                 command
  177.                    |
  178.          D # 3   5 1 0 F
  179.            |     |   \ |
  180.          note    |    \|
  181.          instrument #  data byte (more information about command)
  182.  
  183. "note" is the note to be played (or "---" for no note)
  184. "instrument #" is the number of the instrument (01 - 1V). The leading
  185.                zero is displayed as a space. The number can also be 0.
  186.                It means that the note is played with same instrument
  187.                number and with same volume as previous note in that
  188.                track.
  189. "command" is the number of command/effect to play. If there are no
  190.           effect or commands, command nibble and data byte are zero.
  191. "data byte" gives more information about command/effect to the player.
  192.  
  193. Effects/commands are documented later...
  194.  
  195. The numbers can be changed simply with positioning the cursor over the
  196. number to be changed and typing the new number. If you have to change
  197. the 5th number (between the note and the other numbers: C-212000), which
  198. means that sample 10 - 1V is used, position the cursor over the first
  199. number that's always visible, hold Shift and enter the 1st number. This
  200. is a bit hard to explain, but try it. Because Shift-0 - 9 have other use,
  201. press Amiga-Shift-0 - 9. This is not very handy, but because there won't
  202. probably be a lot of songs which have over 31 instruments, it doesn't
  203. matter very much.
  204. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  205.  
  206. That was some introduction...now is coming complete reference for all
  207. features of MED (at least those I remember...). Maybe I should design
  208. a bigger headline here:
  209.  
  210.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  211.  ***************************************************************************
  212.  *                                                                         *
  213.  *  +-------------------------------------------------------------------+  *
  214.  *  |                       MED V2.1x reference                         |  *
  215.  *  +-------------------------------------------------------------------+  *
  216.  *                                                                         *
  217.  ***************************************************************************
  218.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  219.  
  220. All right, that was nice...and now to the reference:
  221.  
  222. +----------------------------+
  223. |           Files            |
  224. +----------------------------+
  225. This panel contains the tools you need when handling files. You can
  226. save and load with many different formats and also delete them.
  227.  
  228. First of all, there's a file requester. There should be no difficulties
  229. with using it. It is simple, but it works. Directory names are printed
  230. in white and files in black. There are gadgets for fast selection of
  231. drives DF0:, DF1:, DF2:, DH0: and DH1:. If you want to use e.g. Ram Disk,
  232. activate the Dir-gadget, clear it (if not already clean), type the name
  233. ("ram:") and hit (I think I'll just press) Return. When you have started
  234. up MED, you can load the current directory by just activating the gadget
  235. and then pressing Return.
  236.  
  237. The File-gadget contains the filename. If you know already the filename,
  238. you can ignore the file requester and type the filename (with/without
  239. path). This gadget is cleared after file operations, so that you wouldn't
  240. accidentaly load anything (and delete the current song). You can easily
  241. revert the text with Ctrl-R.
  242.  
  243. There are two set of gadgets for file operations. The 1st set contains 
  244. gadgets for loading, and the 2nd contains them for saving/deleting.
  245. "Load"-gadget displays the 1st set and "Save" the 2nd one.
  246.  
  247. ------- Load
  248. Load Song:  This is the gadget used to load songs. Loads songs
  249.             with following formats:
  250.                   MED V1.12, MED V2.00, MED V2.1x,
  251.                   MMD0 (MED modules), SoundFX/old SoundTrackers.
  252.             The samples are automatically loaded after the song.
  253.             WARNING: Don't try to load anything as a song!!!
  254.             If MED can not identify the file, it is loaded as an old
  255.             SoundTracker file. If it is an old SoundTracker file, it
  256.             should load well, but if it isn't, you may meet the GURU!!!!
  257.             MED can't load packed SoundTracker/NoiseTracker files. To
  258.             import songs, save them as modules, then load to MED with
  259.             "ST MOD".
  260.  
  261. Sample:     Loads the sample. The title bar will display the length of
  262.             the sample if it loaded ok.
  263.  
  264. ST MOD:     With this gadget you can load 31-instrument SoundTracker and
  265.             NoiseTracker modules. Because there are some differences
  266.             between MED's and Tracker's commands, they're converted
  267.             automatically.
  268.  
  269. ------- Save
  270. Save Song:  When you choose this one, a requester appears and asks you to
  271.             select the save format. The save formats are described few
  272.             lines later. There's also "Icon" gadget. When it is selected,
  273.             MED will create an icon file when saving Song or Sng+samples.
  274.             If you don't need the icon, turn it off to save some disk
  275.             space.
  276.  
  277. Sample:     Saves the current sample as a raw data.
  278.  
  279. Delete:     Deletes the file. MED requests if you really want to delete it.
  280.  
  281. ======= Save formats
  282.  
  283. There are several different file formats available:
  284.  
  285. Song     This is the normal song, which you will probably use most often.
  286.          The song is packed to save disk space. The samples are not saved.
  287.          They are loaded from your instrument disk(s) using the path list
  288.          (or absolute paths if instrument names are e.g. ST-01:Ringpiano).
  289.  
  290. Sng+samples
  291.          Saves the song like the previous one, but also attaches the
  292.          samples to the end of the file. The result is one clean (but big)
  293.          file which contains everything needed. This is a good selection
  294.          if you want to create a demo disk using the music and MEDPlayer.
  295.          The files load faster and there's no need to hassle with copying
  296.          the samples to the disk.
  297.  
  298. Module (MMD0)
  299.          If you're a programmer and want to include songs in your programs,
  300.          then you need this format. It saves both the song and the samples
  301.          in one file. It differs from "Sng+samples" many ways. First,
  302.          the file is not packed. Second, the file will contain ONLY the
  303.          information which is needed by the player. It doesn't contain
  304.          for example instrument names. There are also other differences
  305.          in the structure of the file. These files can be loaded back to
  306.          MED (they load very fast, because no unpacking is needed).
  307.          I have included routines to load modules in MED V2.12 distribution
  308.          disk (see directory "Programmers").
  309.  
  310. ST-Module
  311.          If you want to export the music to SoundTracker 2.x or NoiseTracker,
  312.          you can use this gadget to save it as a module.
  313.          NOTE: Because there are many things in MED that are not supported
  314.                by Trackers, some information may be lost:
  315.                - samples 10 - 1V won't work
  316.                - only 4 tracks saved, no MIDI support
  317.                - blocks longer than 64 lines will be truncated to 64 lines
  318.                - no color or pointer jump information
  319.                - no relative volume settings, no play/instrument transpose
  320.  
  321. Obj1, Obj2
  322.          These are needed only by programmers. The song is saved in MMD0
  323.          format, but it is saved directly as Amiga Object File. Obj1 and
  324.          Obj2 have small differences - see the docs for programmers.
  325.          Don't include ".o"-suffix to the filename, it'll be automatically
  326.          added. Also, MED cannot load object files so if you don't want
  327.          to meet the meditating guru, don't try it.
  328.  
  329. +----------------------------+
  330. |            Play            |
  331. +----------------------------+
  332. This is a very important panel. Here you can control the playing, set
  333. the playback speed (tempo), handle the playseq list...
  334.  
  335. Beginning from the left, there is a tall box which contains numbers
  336. "00" if there's no song in memory. This is a window to the playseq list.
  337. As I said above, the playseq list is the list of blocks to be played.
  338. This window show 5 numbers of the list at a time. There are gadgets on
  339. the right side of the box which scroll the list up/down/beginning/end.
  340.  
  341. The keyboard equivalent is to hold down the Ctrl-key and then press number
  342. 8 from numeric keypad to scroll up, 2 to scroll down, 7 (home) to the
  343. beginning, 1 (end) to the end.
  344.  
  345. On the right side of the scroll gadgets are the following gadgets:
  346.          +   -   Ins   Del   Ins (with small arrow pointing down)
  347.  
  348.          +      increases the current playseq number (Ctrl - keypad 6)
  349.          -      decreases the playseq number (Ctrl - keypad 4)
  350.          Ins    inserts a new sequence number (zero) under the cursor
  351.                 (Ctrl - keypad 0 (Ins))
  352.          Del    deletes the current sequence number (Ctrl - keypad . (Del))
  353.          Ins (w/arrow) inserts a new sequence number, the new number
  354.                 will be the number of current block (Ctrl - keypad 5)
  355.  
  356. ------- Controlling the playing
  357.  
  358. Play song       starts playing the song from the beginning of it.
  359. Continue song   starts playing from the current playseq entry and cursor pos
  360. Play block      plays the current block (starts from beginning)
  361. Continue block  starts playing the current block from the cursor
  362. Stop playing    stops playing the song. You can also use it to kill the
  363.                 notes played from the Amiga-keyboard/MIDI.
  364.  
  365. The spacebar is used in the shortcuts of these commands:
  366. Stop playing    press just Space
  367. Play song       press Space with Alt+Shift held down
  368. Continue song   press Space with Shift down
  369. Continue block  press Space with Alt held down
  370. Play block      no shortcut, sorry.
  371.  
  372. There's a big proportional gadget that controls the playback tempo.
  373. 240 is the highest, 11 the slowest. Tempos 1 - 10 are compatible with
  374. Trackers' tempos.
  375.  
  376. LP-Filter       with this gadget you can turn on/off the audio filter
  377.                 built into your Amiga. When this gadget is selected
  378.                 and the power-LED is bright, the filter is on. If
  379.                 the LED is dim, the filter is off. You probably want
  380.                 to keep it off. NOTE: With Amiga 1000s, it's not possible
  381.                 to turn off the filter without modifications to the
  382.                 computer. Please keep the filter off.
  383.                 The state of this switch will be saved with songs.
  384.  
  385. E1, E2, E3      If you've played something with MED, you have found the
  386.                 three "equalizers". E1 turns off/on the red bars at the
  387.                 bottom of the screen (PAL machines). If you have a NTSC-
  388.                 machine, a window appears to the front of the panel (and
  389.                 disappears when you do something). E2 turns off/on the
  390.                 four colorful sprites. E3 turns off/on the signal displays.
  391.  
  392.                 These all are turned off to save processor time when
  393.                 you click the right mouse button to show the title bar,
  394.                 but if you want to disable something, it probably is E3.
  395.                 The signal display eats about 40 - 50 % of the processor
  396.                 time (on standard 68000). Because of that, the display
  397.         is turned off during disk access to speed loading/saving.
  398.  
  399. SLD: MED/ST     Sound/NoiseTracker has a different timing system from MED
  400.                 (It usually uses VBlank while MED uses CIA A timer A).
  401.                 Because of the difference, playback speed affects the
  402.                 amount of some effects (slides) on Trackers. Because this
  403.                 is not the case with MED, I have included a SoundTracker
  404.                 compability mode in MED. When you make music with MED,
  405.                 you should select MED (default). When playing back
  406.                 Sound/NoiseTracker-modules, ST is automatically selected.
  407.                 The state of this switch will be saved with songs.
  408.  
  409. V: Hex/Dec      This is another compability switch. While the data bytes
  410.                 of the commands are usually hex numbers, it's possible to
  411.                 use the volume-command with hex or decimal argument.
  412.                 When Hex is selected, the acceptable volumes are 00 - 40.
  413.                 When Dec is selected, the volume can be 00 - 64.
  414.                 If you are not a programmer (and even if you are), it may
  415.                 be easier to think the numbers in decimal. It is the
  416.                 default.
  417.                 The state of this switch will be saved with songs.
  418.  
  419. ------- Panic stop
  420. It's possible to make a song, which takes all of the processor time. It
  421. will therefore be impossible to stop it. This shouldn't happen accidentaly,
  422. but if you fill a block with notes and command FF3 and set tempo to 240,
  423. you'll get the idea. To stop playing in this case, hold both mouse buttons
  424. down about 5 - 6 seconds.
  425.  
  426. +----------------------------+
  427. |           Sample           |
  428. +----------------------------+
  429.  
  430. Here you can load samples and alter some characteristics (what a difficult
  431. word!!) of them. First I should note out few very important actions which
  432. are available with keyboard:
  433.     Shift-Cursor Left/Right = previous/next sample
  434.     Shift-Alt-Cursor L/R     = 16 samples forward/backward
  435.     Amiga-I         = activate sample name gadget
  436.     Shift-Amiga-I         = clear and activate sample name gadget
  437.     Amiga-R         = activate repeat gadget
  438.     Amiga-J         = jump on/off
  439.  
  440. At the top left corner of this panel is the sample number (01 - 1V)
  441. followed by the sample name gadget followed by the length of current
  442. sample in bytes ("-" if no sample loaded).
  443.  
  444. To load a sample, you can write the name of it in the string gadget,
  445. then click "^ Load Sample ^" (or just press Return).
  446.  
  447. Above the Load Sample gadget are gadgets that select first, previous,
  448. next or last sample.
  449.  
  450. On the left side of them are two gadget ("Jump", "Kill"). "Jump" causes
  451. jumping when this instrument is played. "Kill" removes this instrument.
  452. It frees the memory used by it (handy when you're very low on memory)
  453. and clears all the values. Jumpings will be saved with songs.
  454.  
  455. "Transpose" is one of the new features of V2.10. It works like "Play
  456. transpose" but only for this instrument. So, if "Transpose" is -2,
  457. for example, then this instrument is played two halfsteps lower.
  458.  
  459. Repeat means that when you play a note with some instrument, the note
  460. will play forever, until you play a new note.
  461. A picture tells more than 1000 words:
  462.  
  463.          the beginning              repeat start offset           the end
  464.          v                                v                             v
  465. Sample:    | This part is played only once  | This part is looped forever | |
  466.  
  467.          \__________repeat_______________/ \________repeat length______/
  468.  
  469. "Repeat" is the length of the part which is played only once (in bytes).
  470. "Repeat length" is the length of the part which is played forever (also
  471. in bytes).
  472.  
  473. When you load IFF-instruments, these values are automatically loaded.
  474. They can be also set in path file, so that when you load a sample, you
  475. will also get the repeat values. Gadget R/S is the repeat start offset,
  476. R/L is the length. If the repeat length is lower than 4, no repeat will
  477. happen.
  478.  
  479. Finally there's a big proportional gadget. It can be used to set the
  480. default volume of this instrument: 64 = maximum, 0 = silent.
  481.  
  482. +----------------------------+
  483. |           Block            |
  484. +----------------------------+
  485. This panel contains most of the block handling things and the copy
  486. operations.
  487.  
  488. Track: Cut Copy Paste Swap
  489.          These gadgets are used to cut/copy/paste tracks. Swap swaps
  490.          the contents of the copy buffer and current track.
  491.          The keyboard shortcuts for Cut/Copy/Paste are:
  492.                 Amiga-X, Amiga-C, Amiga-V
  493.  
  494. Block: Cut Copy Paste Swap
  495.          These work just like the previous, they just affect the entire
  496.          block. The keyboard shortcuts are also just like the previous
  497.          except hold down the Shift key too (Amiga-Shift-X...).
  498.  
  499. Free:  Mark Cut Copy Paste
  500.          This is probably the most powerful of the copy operations.
  501.          You can cut/copy a rectangular area. First you must mark the
  502.          area: move the cursor to the track/line where you want to begin
  503.          the area, click "Mark" (or Ctrl-M), then move the cursor to the
  504.          end of the rectangular area and click "Cut" or "Copy" (or Ctrl-X
  505.          or Ctrl-C). Now the area is in the buffer and you can paste it
  506.          by moving the cursor to the point where you want to paste the
  507.          buffer and press "Paste" (or Ctrl-V).
  508.  
  509. Del buff
  510.          When you don't need the contents of the buffer any more, you
  511.          can click this gadget to free the memory allocated for the buffer.
  512.          It's useful when you're very low on memory. The buffer is freed
  513.          automatically when you exit MED, so you may not need this gadget
  514.          at all.
  515.  
  516. Note that all these operations use the same buffer, so you can copy a
  517. track with Amiga-C, for example and then use Ctrl-V to paste it starting
  518. from the line where the cursor is.
  519.  
  520. Then there are the block commands.
  521.  
  522. Trks: 4 8 12 16
  523.          You can select how many tracks you want this block to have.
  524.          Note that tracks 4 - F can be used only with MIDI devices.
  525.          Note also that when you decrease the number of tracks, the
  526.          higher tracks will be lost (no Are you sure? requesters).
  527.  
  528. Lines: « < 64 > »
  529.          These gadgets are used for selecting the number of lines in
  530.          this block. « » gadgets increase/decrease the number by 10,
  531.          < > gadget by 1. The preferred way is to write the number
  532.          directly into the string gadget (less memory fragmentation).
  533.  
  534. 1 2 3 4 8 16 C
  535.          It may be helpful for easier positioning of notes to be able to
  536.          "mark" lines some way (especially if the block is long). You
  537.          can make some lines appear with reversed colors, if you want.
  538.          1 highlight every line, 2 highlights every other line, 3 high-
  539.          lights every third line and so on. C clears all highlighting from
  540.          this block. You can also mark individual lines with TAB-key.
  541.          The highlighting can be removed by highlighting the line(s) again.
  542.          The highlightings are saved with songs.
  543.  
  544. New block
  545.          This gadget creates a new block after the last block.
  546.  
  547. New here
  548.          Creates a new block here, shifts all following blocks forward.
  549.          The playseq numbers are corrected so that the song won't change.
  550.  
  551. Del last
  552.          Deletes the last block (no warning messages, be careful).
  553.  
  554. Del this
  555.          Deletes the current block. Playseq numbers corrected.
  556.  
  557. Split    Splits the current block so that the current line will be the
  558.          first line of the next block.
  559.  
  560. Join     Joins this block and the following block together.
  561.  
  562. +----------------------------+
  563. |           Edit             |
  564. +----------------------------+
  565. Edit-panel contains functions that help editing.
  566.  
  567. "Tracks on"     These are the switches that allow you to switch temporarily
  568.                 any track off and back on. The 16 lights in the status bar
  569.                 show you which tracks are on, when you're not using the
  570.                 Edit panel. Keyboard equivalents:
  571.                         numeric keypad 1 - 9 for tracks 0 - 8,
  572.                 Shift + numeric keypad 1 - 9 for tracks 8 - 15
  573.  
  574. "Edit" and "2×SPC" on the right corner are the bigger equivalents of
  575.                 "E" and "2×" in the status bar. "Edit" turns editing
  576.                 on/off and 2×SPC turns on/off double spacing between notes.
  577.                 Keyboard: Edit on/off = Esc, 2×SPC = ~ (below ESC)
  578.  
  579. 1+2, 2+3, 3+4, 4+5 on the left corner select the keyboard octaves which
  580.                 are used. This can be done also with F1 - F4 keys.
  581.  
  582. "Auto advance"  helps you when typing commands and chords. When you type
  583.                 a note, MED normally advances to next line. This gadget
  584.                 turns it off/on. Keyboard: Ctrl-A
  585.  
  586. S1, S2          These gadgets can perform the quite tedious task of
  587.                 creating slides. Here's how it works (example):
  588.  
  589.                 You want to make a slide from C-2 to G-2:
  590.  
  591.                     000 C-2 1000
  592.                     001 --- 0000
  593.                     002 --- 0000
  594.                     003 --- 0000
  595.                     004 --- 0000
  596.                     005 G-2 1000
  597.                     006 --- 0000
  598.  
  599.                 Move the cursor to the line where you want the
  600.                 slide to begin (in this example, line 002). Then click
  601.                 S1 or S2. Result:
  602.  
  603.                 If you click S1         If you click S2
  604.                    000 C-2 1000            000 C-2 1000
  605.                    001 --- 0000            001 --- 0000
  606.                    002 G-2 1306            002 --- 0108
  607.                    003 --- 0306            003 --- 0108
  608.                    004 --- 0306            004 --- 0108
  609.                    005 --- 0306            005 G-2 1000
  610.                    006 --- 0000            006 --- 0000
  611.  
  612.                 The better result is usually achieved using S1. S1 and S2
  613.                 use the different sliding commands (that's the difference).
  614.                 With S2, the second note is also replayed. The commands
  615.                 itself are documented later.
  616.                         Keyboard: S1 = Amiga-T, S2 = Shift-Amiga-T
  617.  
  618. VOL             Creates a volume slide. With this option, it's possible
  619.                 to create easily fadings etc. Example:
  620.  
  621.                 009 --- 0C50 <-start volume   \    009 --- 0C50
  622.                 010 --- 0000  =================\   010 --- 0C47
  623.                 011 --- 0000  | Click "VOL"     \  011 --- 0C44
  624.                 012 --- 0000  |                 /  012 --- 0C40
  625.                 013 --- 0000  =================/   013 --- 0C37
  626.                 014 --- 0C34 <-end volume     /    014 --- 0C34
  627.  
  628.                 The cursor must be positioned somewhere between the C-
  629.         commands (on lines 10 - 13 in this example).
  630.  
  631. ------- Programmable keys
  632. It's possible to assign 10 different notes/commands to number 0 - 9.
  633. Then you can insert the note/command with Shift- 0 - 9. You can also
  634. assign commands to Left and Right Alt. When you then enter notes, holding
  635. down the Alt, command is inserted to the note. The programmable keys are
  636. especially useful when entering drum-rhythms etc.
  637.  
  638. "Edit"-panel contains gadgets, which you can use to edit the notes/cmds.
  639. Only one note/cmd of the 12 is displayed at a time.
  640.  
  641. SH0-9    Shows the current Shift-number key definition, the number is
  642.          shown between the arrows (above R.Alt) and the number can be
  643.          changed using the arrows.
  644.  
  645. L.Alt    Shows the definition of Left Alt
  646.  
  647. R.Alt    Shows the definition of Right Alt
  648.  
  649. Here's the explanation of note change gadgets:
  650.  
  651.                         
  652.          12 halfsteps up
  653.                  C- 3  |     2 0 0 0
  654.                 +--+-+ |  +-+-+-+-+-+
  655. Halfstep up  -> |^ |^|/   |^|^|^|^|^| <- Increase number
  656.                 +--+-+    + +-+-+-+-+ 
  657. Halfstep down-> |v |v|\   |v|v|v|v|v| <- Decrease number
  658.                 +--+-+ |  +-+-+-+-+-+
  659. Clear note (---) |o |  |    |o|o|o|o| <- Clear (set to 0)
  660.                  +--+  |    +-+-+-+-+
  661.        12 halfsteps down
  662.  
  663. If the number between arrow were 3, and you would press Shift-3,
  664. the note C-3 2000 would be entered, understand??
  665.  
  666. Any of the numbers can also be "x". It means that this number is left
  667. as it is (not changed) when you insert this definition with Shift-0 - 9.
  668. When the number is 0 and you decrease it, it will become "x".
  669.  
  670. For example, if you wanted to clear all commands from this track (but
  671. leave the notes) you could make a following definition:
  672.  
  673.          xxx  xx000
  674.  
  675. Because the note is "xxx" and instrument number is "xx", they won't be
  676. changed, and only the command is cleared. Then you can just hold down
  677. the Shift and the number key and let the key-repeat do the job.
  678.  
  679. R.Alt and L.Alt are a bit different: the note number is always "xxx" and
  680. the instrument number by default is "xx".
  681.  
  682. "Pick" copies the note currently under the cursor to this key. You can
  683.        also pick, for example #7 by pressing Shift-Ctrl-7.
  684. "Clr"  clears the definitions of this key.
  685. "Save" saves the definitions to file "S:med.defprgkeys", this file is
  686.        loaded during start-up, and you quickly get the old definitions.
  687.  
  688. There's also a fast way to change these numbers/note (don't have to click
  689. the arrow keys thousands of times...): Point the number with the mouse,
  690. press (and hold down) the left mouse button, type in the number
  691. (with keyboard) point another number (don't release mouse button) and
  692. enter the number and so on, until you have entered all numbers. Then
  693. release the mouse button.
  694.  
  695. +----------------------------+
  696. |           Misc.            |
  697. +----------------------------+
  698. Some miscellaneous and not very important things and a VERY important
  699. thing (quitting).
  700.  
  701. On the left there are gadgets for changing the screen colors.
  702. No need to explain?? All right, I won't. But only remember that the colors
  703. are saved when you save your song (they can give some expression).
  704.  
  705. Jumping: Off 8th Sample
  706.          When you don't want the mousepointer to jump, select Off.
  707.          When you want him to jump every 8th notes, select 8th.
  708.          When you want him to jump when some sample is played, select
  709.          Sample. The samples which cause him to jump are selected from
  710.          "Sample"-panel (gadget name: Jump).
  711.  
  712.          The name of the pointer is Topi (according to my cousin).
  713.  
  714. Clear All, Clr song only, Exit MED
  715.          These are very dangerous functions, in fact they're so dangerous
  716.          that you must click OK! after you've selected one of them:
  717.  
  718.          "Clear All" does just as it says. Clears the song, removes all
  719.          instruments from memory. In two words: clears everything.
  720.  
  721.          "Clr song only" is not as destructive. While it destroys the
  722.          song, it leaves the instruments (if you want to create a new
  723.          song without reloading the instruments).
  724.  
  725.          "Exit MED" is the most destructive. It does everything "Clear
  726.          All" does, but even worse, it quits MED!!!!!!
  727.          This function was made for program testing and it probably
  728.          doesn't have any real use ;-)
  729.  
  730. Add paths, Rem paths
  731.          These affect the sample names when loading songs/samples.
  732.  
  733.          "Add paths" adds the complete path of the sample when you
  734.                      load e.g. if you load sample "PopSnare2" from
  735.                      "ST-01:", the sample name will be "ST-01:PopSnare2".
  736.  
  737.          "Rem paths" usually songs made with Trackers have sample names
  738.                      like "ST-02:AhhVox". If you want that the samples
  739.                      load using the path list instead of absolute names
  740.                      (if your samples are in hard disk, for example) you
  741.                      can remove "ST-xx:" from sample names and reload them,
  742.                      but when you "Rem paths" is selected, any paths before
  743.                      the sample names are removed quickly and easily during
  744.                      loading.
  745.  
  746.          Both of these can be active at the same time.
  747.  
  748. +----------------------------+
  749. |         Volumes            |
  750. +----------------------------+
  751. Many people have requested that I add "some kind of proportional track
  752. on/off". Here it is!!!
  753. You can select the relative volume for each track. When it's 64, the track
  754. is played with full volume, when it's 32, it's played with half volume.
  755. You can set it freely from 1 to 64. Finally there's a master volume,
  756. which affects all the tracks e.g. if the track volume is 32 and the
  757. master volume is also 32, and the sample volume is 64, the "real" volume
  758. of the note played in that track will be 16.
  759.  
  760. There are two sets of « < 64 > » gadgets. The one on the right is the
  761. master volume. The left one changes the volume of the selected track. You
  762. can select which track, by clicking the numbers above the gadgets.
  763. The number which will be currently changed is highlighted with red.
  764.  
  765. This is quite easy, so no problems should appear. The track volumes and
  766. master volume is saved with songs.
  767.  
  768. +----------------------------+
  769. |           MIDI             |
  770. +----------------------------+
  771. MED can output notes and some commands to external MIDI-devices
  772. (keyboards, synthesizers...). The MIDI-panel contains the MIDI-stuff
  773. which is needed for that.
  774.  
  775. When you decide that some instrument is a MIDI-instrument, you select
  776. the MIDI channel for it. "MIDI channel"-gadgets are used for that.
  777. If you select e.g. MIDI channel 2, the notes of this instrument are
  778. sent in MIDI channel 2 (simple, isn't?).
  779.  
  780. Also, you need to activate MIDI (click "MIDI active"). If the serial
  781. port is used by some other program, you can't use MIDI. Then you must
  782. terminate the other program and try again.
  783.  
  784. After you have activated MIDI, MED starts sending "active sensing"
  785. messages ($FE). Now you can try to play with this instrument and you
  786. should hear the sound from you MIDI-device (remember to set the default
  787. volume of the sample [Sample-panel]).
  788.  
  789. MED uses now the default preset of that channel (which you have set
  790. on your MIDI-device). If you want to use other presets, you can select
  791. them using the "MIDI preset #"-gadgets. Preset number 0 means that the
  792. default preset is used (the preset is never changed for this instrument).
  793.  
  794. You can have instruments with differents preset numbers, but which will
  795. use the same MIDI channel. In that case, MED will automatically send the
  796. "preset change"-command ($Cx $yy) whenever the instrument with different
  797. preset number is used.
  798.  
  799. You can use MIDI-instruments with all 16 tracks (if there are 16 tracks on
  800. the current block). You can also freely mix samples and MIDI-instruments
  801. on the same track.
  802.  
  803. One helpful keyboard command is Ctrl-Space. This command resets pitch-
  804. benders and modulation wheels on all channels. Also, if you have changed
  805. presets on your MIDI-device, MED can't detect that and thinks that the
  806. preset is not changed. Ctrl-Space causes MED to resend "preset change" for
  807. all channels, when playing.
  808.  
  809. There are commands which control the pitchbender, modulation wheel etc.
  810. Detailed documetation later (again??).
  811.  
  812. ------- Entering notes with MIDI
  813. You can use your keyboard, synthesizer or whatever, to insert notes
  814. (you don't need to use your Amiga's keyboard to entering). You must
  815. activate the "Input active"-gadget. If editing is on and your MIDI-device
  816. is sending notes, they will be entered. You can also enter Amiga-samples
  817. with MIDI.
  818.  
  819. "Read volume" gadget may be sometimes quite useful. If you have a velocity-
  820. sensitive keyboard, the volume will be entered in the command-part when
  821. you enter notes and this gadget is selected.
  822.  
  823. You may have noticed that you can't directly use all the octaves which
  824. are available on the MIDI-device. "Instrument transpose" helps this.
  825. You can have two instruments with identical settings except different
  826. instrument transpose. With instrument transpose you can reach nearly
  827. the full range of notes.
  828.  
  829. NOTE: When you have a MIDI-instrument, its name doesn't really have any use.
  830.       However it's good practice to type in the names of the presets. This
  831.       way you can easily see the presets, and, if you give the song to
  832.       somebody else who may have different MIDI-equipment, he/she can
  833.       easily change the preset numbers to use the correct presets on his/her
  834.       MIDI-device.
  835.  
  836. +----------------------------+
  837. |        Transpose           |
  838. +----------------------------+
  839. This is the only panel which has not changed at all from MED V2.00.
  840. It contains functions that transpose some part of the song, and two
  841. block functions (expand/shrink).
  842.  
  843. Song, Block, Track: Octave up/down, halfstep up/down
  844.          Song transposes the whole song, Block transposes this block,
  845.          Track transposes this track.
  846.  
  847. Play Transpose
  848.          Play transpose doesn't affect the notes at all. Instead it
  849.          only changes the playing.
  850.  
  851. S: All  Only this
  852.          If you want to transpose only one instrument, select Only this.
  853.          Now only the current instrument will be transposed. "All"
  854.          transposes everything.
  855.  
  856. Expand   When you have created a nice-sounding block, but you would like
  857.          to include e.g. some fast rhythm patterns, but you notice that
  858.          the block plays too slowly for the patterns. "Expand" doubles
  859.          the size of the block and creates empty lines between notes.
  860.          Now you can double the tempo and insert the rhythm patterns.
  861.  
  862.          NOTE: When you expand, the block must not be more than 128
  863.          lines long. If you want to make fast rhythm patterns, see
  864.          first instructions for commands FF1, FF2, FF3. They may be
  865.          an easier way.
  866.  
  867. Shrink   When you have expanded the block, you can return it to the
  868.          original state by pressing shrink. This function exists for
  869.          symmetry. It has not much real use.
  870.  
  871. +----------------------------+
  872. |       Samplelist           |
  873. +----------------------------+
  874. Finally a last panel...I'm a bit fed up with writing these instructions..
  875. And now back to the point...this panel lists the MED_paths file. If you
  876. don't have the file MED_paths, then this display is empty.
  877.  
  878. ------- How to create MED_paths??
  879.  
  880.           Using the filerequester, load the directory of your sample
  881.           disk/dir.
  882.           Then go to the "Samplelist"-panel. Now click "Add: Dir".
  883.           You should see the filenames of the directory to appear.
  884.           You can now examine the list, and if there are files which
  885.           are not samples, destroy them from the list with "Del: Name".
  886.           Repeat this procedure for each sampledisk/dir you have.
  887.           You can select the displayed directory with <- -> (big arrows).
  888.  
  889.           When you have made the MED_paths, you probably want to save it.
  890.           L->CD S: does the job. If you click CD, the path file will be
  891.           saved to the current directory (be sure that it is the same where
  892.           you started MED). If you click "S:", the file will be saved
  893.           to the S:-directory. I prefer placing the file in S:, because
  894.           then it doesn't matter which is the current directory when
  895.           starting MED.
  896.  
  897.           If you later want to add entries to the directory, you can
  898.           delete the whole directory from the list with "Del: Dir".
  899.           Then you can reload the directory. You can also add entries
  900.           one at a time. If you click "Add: Name", the name of the
  901.           current sample is added to the list. Also the repeat/rep.length
  902.           values are then added to the list (form: Asia::480/5362).
  903.           Note that the previous entry with same name is not deleted,
  904.           so you must delete it by hand (if you want to add rep./rep.len
  905.           values to the list).
  906.  
  907.           If the current instrument is a MIDI-instrument when you add
  908.           the name, the name will be a form E.Piano::M6/4 . The 1st
  909.           number is the channel, the 2nd is the preset. When you later
  910.           load instrument of that name, the MIDI-channel/preset will be
  911.           set. Note that the instrument with this name doesn't really
  912.           have to exist in that directory, it's like a "dummy" entry.
  913.           You may want to create a "dummy" directory for these dummy
  914.           MIDI entries (empty dir).
  915.  
  916.           On the top right corner is the box displaying the directory
  917.           name. In fact it displays only the name of the last directory
  918.           in the path, because it's the most meaningful. For example
  919.           some of my instruments are located in directory:
  920.  
  921.                 dh0:music/sampledinstr/ST-01/
  922.  
  923.           Then the box would only show "dh0:music/" for every directory,
  924.           but because it shows only the last dir, there's "ST-01/", which
  925.           is much more helpful, I think.
  926.  
  927.           <- and -> move you to next/previous directory. Directory number
  928.           is shown in a little box.
  929.  
  930.           Finally there's a gadget: "Load". This is used to load the
  931.           instrument, which name has a white background.
  932.  
  933.           More finally, I reveal the keyboard shortcuts...
  934.  
  935.                 Alt-numeric keypad-8 = scroll the list up (very useful)
  936.                 Alt-numeric keypad-2 = scroll the list down (very too)
  937.                 Alt-numeric keypad-4 = previous dir
  938.                 Alt-numeric keypad-6 = next dir
  939.                 Alt-keypad-9 (PgUp)  = scroll the list 1 page (5 entries) up
  940.                 Alt-keypad-3 (PgDn)  = scroll the list 1 page down
  941.                 Alt-keypad-7 (Home)  = to the beginning of the list
  942.                 Alt-keypad-1 (End)   = to the end of the list
  943.                 Alt-keypad-5         = load sample
  944.  
  945. +-------------------------------------------------------------------+
  946. |+-----------------------------------------------------------------+|
  947. ||             MED V2.1x player commands/effects                   ||
  948. |+-----------------------------------------------------------------+|
  949. +-------------------------------------------------------------------+
  950.  
  951. This section gives information about commands/effects. They are events
  952. which affect the playing and they are handled by the MED player routine.
  953.  
  954.          C - 2  1 2 3 4
  955.                   | \ |
  956.      command number  \|
  957.                       data byte
  958.  
  959. You insert the commands usually by hand (turn editing on, move cursor
  960. on the command numbers and type the numbers). It may be a bit easier
  961. if you turn off automatic-advance with Ctrl-A.
  962.  
  963. Currently recognized commands are 0, 1, 2, 3, 4, 5, A, B, C, D, E and F.
  964.  
  965. Here are the descriptions of each one:
  966.  
  967.  
  968. +---------------------------------------------------+
  969. | Command 0:  ARPEGGIO       MIDI: no action        |
  970. +---------------------------------------------------+
  971.  
  972. This command changes the pitch of the note quickly (6 times during 1 note).
  973. It can be used to create "chords" or special effects. If you've listened
  974. to music made with the C-64, you MUST have heard arpeggios. The pitch is
  975. changed between 3 different pitches during one note:
  976.          the 1st pitch is the pitch of the original note
  977.          the 2nd pitch is the pitch of the original note + the 1st number
  978.                 of databyte halfsteps up
  979.          the 3rd pitch is the pitch of the original note + the 2nd number
  980.                 of databyte halfsteps up
  981.  
  982. Note: 3rd pitch | 2nd pitch | 1st pitch | 3rd pitch | 2nd pitch | 1st pitch
  983.       changed 6 times during note
  984.  
  985. It may be a bit difficult to understand, so here's an example:
  986. You want to make an arpeggio which sounds like C-major chord.
  987.  
  988. The lowest pitch is C (C-2 in this example).
  989. The second is E-2 (4 halfsteps higher than C-2).
  990. The third is G-2 (7 halfsteps higher than C-2).
  991.  
  992. 4 halfsteps from C-2 -+ 7 halfsteps from C-2
  993.                       |/
  994. That produces:  C-2 1047
  995.                 --- 0047
  996.                 --- 0047 and so on...
  997.  
  998. Data byte for a minor chord would be 37.
  999.  
  1000. The arpeggios sound better with some instruments than others.
  1001.  
  1002.  
  1003. +---------------------------------------------------+
  1004. | Command 1:  SLIDE UP       MIDI: pitchbender up   |
  1005. +---------------------------------------------------+
  1006.  
  1007. This command slides up the pitch of the current track.
  1008.  
  1009. With Amiga samples:
  1010.          Decreases the period of the note 6 * databyte during one note.
  1011.          Sounds rather technical?? Yes... The instructions for previous
  1012.          versions of MED contained detailed instructions for making
  1013.          good-sounding slides with this command. Because of this version
  1014.          now contains the easy automatic slide making (Amiga-T), I felt
  1015.          that these instructions are not necessary any more. If you
  1016.          use this function for special effects (not real slides) then
  1017.          you can experiment with the values for the databyte.
  1018.          Example:
  1019.                 A-1 1000
  1020.                 --- 0000
  1021.                 --- 010F <- slide up a bit
  1022.  
  1023. With MIDI:
  1024.          This commands works very differently with MIDI. It actually
  1025.          "turns" the pitchbender 48 * databyte steps up. Because the
  1026.          actual range of the pitchbender may be different with different
  1027.          MIDI-devices, you must find the right value by experimenting.
  1028.          There's also one thing you should know: when a new note is played,
  1029.          the pitchbender is not resetted automatically. To reset the
  1030.          pitchbender, you use this command with databyte zero.
  1031.          Example:
  1032.                 G-2 L1FF <-turn it up very quick
  1033.                 --- 0000
  1034.                 --- 0100 <- then reset the pitchbender
  1035.  
  1036.  
  1037. +---------------------------------------------------+
  1038. | Command 2:  SLIDE DOWN     MIDI: pitchbender down |
  1039. +---------------------------------------------------+
  1040.  
  1041. Not much about this command. It's just like command 1 except it slides
  1042. down.
  1043.  
  1044.  
  1045. +---------------------------------------------------+
  1046. | Command 3:  PORTAMENTO     MIDI: no action        |
  1047. +---------------------------------------------------+
  1048.  
  1049. This is another slide command (if you've used the previous versions of
  1050. MED and think that this is vibrato, see command 5). It can be used to
  1051. make perfect slides more easily. First an example:
  1052.  
  1053.          C-2 5000 <- played note C
  1054.          --- 0000
  1055.          E-2 5305 <- this note is not played!! Instead, slide target is set
  1056.          --- 0300    to G-2 and slide speed is 5
  1057.          --- 0300 <- when speed is zero, use the previous speed
  1058.          --- 0306 <- the speed can be changed, of course
  1059.  
  1060. This example would slide from C-2 to E-2, but the slide stops EXACTLY
  1061. when E-2 is reached. The remaining 3's have no effect. This command
  1062. is easier to handle with automatic slide making (see Edit/S1 above).
  1063.  
  1064.  
  1065. +---------------------------------------------------+
  1066. | Command 4:  VIBRATO        MIDI: modulation wheel |
  1067. +---------------------------------------------------+
  1068.  
  1069. This is the new vibrato command (compatible with NoiseTracker). This
  1070. is far better than the poor vibrato from previous MEDs.
  1071.  
  1072. The first number of the data byte is vibrato speed, the second is
  1073. vibrato depth. If the numbers are zeros, the previous speed and depth
  1074. is used.
  1075.  
  1076. Example: F-215000
  1077.          --- 0000
  1078.          --- 0433 <- slow, not much depth
  1079.          --- 0437 <- more depth
  1080.          --- 043F <- full depth
  1081.          --- 0482 <- fast, not very deep
  1082.  
  1083. MIDI: This command affects the modulation wheel of the current channel.
  1084.       The data byte can be 00 - 7F. 00 = no modulation, 7F = maximum.
  1085.       Values 80 - FF are reserved for future expansion (and won't work).
  1086.  
  1087.  
  1088. +---------------------------------------------------+
  1089. | Command 5:  OLD VIBRATO    MIDI: no action        |
  1090. +---------------------------------------------------+
  1091.  
  1092. This is the old vibrato command (previously it was 3). The command 3 is
  1093. automatically converted to 5 when loading old MED songs. The pitch of
  1094. the note is changed between two values, databyte is the depth.
  1095.  
  1096. Example: A#1 J502
  1097.          --- 0507 increasing depth
  1098.          --- 0517 v
  1099.          --- 0527
  1100.          --- 0537
  1101.  
  1102.  
  1103. +---------------------------------------------------+
  1104. | Command A:  VOLUME SLIDE   MIDI: no action        |
  1105. +---------------------------------------------------+
  1106.  
  1107. This command exists for Tracker compability. Please use command D
  1108. (if I run out of free command numbers some day, I'll use number A!!).
  1109.  
  1110. +---------------------------------------------------+
  1111. | Command B:  POSITION JUMP  MIDI: position jump    |
  1112. +---------------------------------------------------+
  1113.  
  1114. This command lets you make songs that have beginning which is played
  1115. only once and then some part which is looped forever. Position jump
  1116. causes the jump to playsequence number pointed by the data byte. If the
  1117. data byte is e.g. 0, then the playseq jumps to the first entry.
  1118.  
  1119. Example:    --- 0B02 <- start playing from playsequence number 3
  1120.  
  1121. +---------------------------------------------------+
  1122. | Command C:  SET VOLUME     MIDI: set volume       |
  1123. +---------------------------------------------------+
  1124.  
  1125. You can override the default volume of the instrument with this command.
  1126. Example:
  1127.          A-3 4C20 <- played with volume 20
  1128.  
  1129. There are 65 volume levels (0 - 64), 0 = no sound, 64 = maximum. The
  1130. data byte of command C can be 00 - 64 or 00 - 40 (decimal or hex).
  1131. Non-programmers will probably want to use the decimal numbers. See
  1132. (Play/[Dec/Hex]).
  1133.  
  1134. It is also possible to change the volume of already played note. Note
  1135. that it doesn't work with MIDI-instruments.
  1136.  
  1137. Example:
  1138.          A-3 4000
  1139.          --- 0000
  1140.          --- 0C10 <- volume to 10
  1141.  
  1142. +---------------------------------------------------+
  1143. | Command D:  VOLUME SLIDE   MIDI: no action        |
  1144. +---------------------------------------------------+
  1145.  
  1146. You can increase/decrease volume smoothly with this command. The data
  1147. byte is divided in two parts:
  1148.  
  1149.          C-3 3D01
  1150.                ||
  1151.                |+- Amount of decresdendo
  1152.                +-- Amount of crescendo
  1153.  
  1154. If crescendo is zero, then the decrescendo is performed. Otherwise only
  1155. crescendo is performed.
  1156.  
  1157. Example:
  1158.          C-2 3C40
  1159.          --- 0D01 <- a bit more quiet
  1160.          --- 0D01 <- even more
  1161.          --- 0D20 <- and crescendo back to original
  1162.  
  1163. One unit in these commands means six actual volume units, so this example
  1164. would look like this, when using the C-command (except that it doesn't
  1165. sound so smooth):
  1166.          C-2 3C40 (volumes are decimal in this example)
  1167.          --- 0C34 <- -6
  1168.          --- 0C28 <- -6
  1169.          --- 0C40 <- +12
  1170.  
  1171. +---------------------------------------------------+
  1172. | Command E:  no action      MIDI: pan control      |
  1173. +---------------------------------------------------+
  1174.  
  1175. With MIDI-instruments, this command controls the stereo location of the
  1176. sound. The data byte can be 00 - 7F.
  1177.  
  1178.         left           mid            right
  1179.          |              |               |
  1180.         00             3F               7F
  1181.  
  1182. If you've used MED V2.00/V2.01 or Noise/SoundTracker, you may remember
  1183. that this command controlled the low-pass filter. I think that it was
  1184. unnecessary to spend the command E only for controlling only a single
  1185. switch. See command F.
  1186.  
  1187. +---------------------------------------------------+
  1188. | Command F:  TEMPO/MISC.    MIDI: tempo/misc.      |
  1189. +---------------------------------------------------+
  1190.  
  1191. Command F has many different actions depending on the data byte.
  1192.  
  1193. If the data byte is zero (00), this command causes the immediate jumping
  1194. to the next block on the playing sequence (or to the beginning of this
  1195. block if you're only playing the block). This function is better to
  1196. implement by making the block shorter (takes less memory).
  1197.  
  1198. Example:
  1199.          C-2 4F00 <- this is the last note of this block
  1200.  
  1201. When the data byte if 01 - F0, the command changes the tempo.
  1202.  
  1203. If the new tempo is 01 - 0A, it is Tracker-compatible.
  1204.  
  1205. Example:
  1206.          E-3 6FF0 <- highest tempo
  1207.          --- 0000
  1208.          --- 0F0B <- slowest
  1209.  
  1210. Data bytes FF1 - FFF are reserved for special actions, some of them
  1211. are currently used:
  1212.  
  1213. FF1 causes the same note played actually twice. This way it's possible
  1214. to create fast rhythms.
  1215.  
  1216.          C-3 2FF1 is same as C-3 2000
  1217.                              C-3 2000 with double tempo
  1218.  
  1219. FF2 plays the note only once, but it is not started immediately:
  1220.  
  1221.          C-3 2FF2 is same as --- 0000
  1222.                              C-3 2000 with double tempo
  1223.  
  1224. FF3 works like FF1 except the note is played three times (very fast).
  1225.  
  1226. FF8 turns off the low-pass filter (power-LED will dim).
  1227.  
  1228. FF9 turns the low-pass filter on (bright LED).
  1229.  
  1230. FFA sends MIDI "hold pedal on"-command (works only with MIDI-instruments).
  1231.  
  1232. FFB sends MIDI "hold pedal off"-command (works only with MIDI-instruments).
  1233.  
  1234. FFD works only with Amiga-samples. It causes the pitch of the channel to
  1235.     be set to the pitch of the new note, but the new note is not replayed.
  1236.  
  1237.          C-1 2000 <- play note
  1238.          --- 0000
  1239.          C-2 2FFD <- don't replay the note, just set the pitch to C-2
  1240.  
  1241. FFE stops playing immediately. If you want to make a song which plays only
  1242.     once, put this command to the end of the song. This command can be
  1243.     easily entered: Click "Stop playing" while holding the Shift-key.
  1244.  
  1245. FFF Stops the note on the current track. Works with both Amiga- and MIDI-
  1246.     instruments. Nearly identical to "C00" on Amiga-samples, but because
  1247.     "C00" doesn't work with MIDI, I made this command.
  1248.  
  1249.  
  1250. +-------------------------------------------------------------------+
  1251. |+-----------------------------------------------------------------+|
  1252. ||             MED V2.1x keyboard equivalents/functions            ||
  1253. |+-----------------------------------------------------------------+|
  1254. +-------------------------------------------------------------------+
  1255.  
  1256.       Cursor up              Cursor up
  1257.       Cursor down            Cursor down
  1258.       Cursor right           Cursor right
  1259.       Cursor left            Cursor left
  1260. -- then a bit more complex ones
  1261.       DEL                    Delete note or number under cursor
  1262.       Shift-DEL              Delete the note and the command numbers
  1263.       Shift-Cursor up        Previous block
  1264.       Shift-Cursor down      Next block
  1265.       Shift-Cursor left      Previous sample
  1266.       Shift-Cursor right     Next sample
  1267.       Alt-Cursor up          First block
  1268.       Alt-Cursor down        Last block
  1269.       Alt-Cursor left        Cursor over previous track
  1270.       Alt-Cursor right       Cursor over next track
  1271.       Alt-Shift-Cursor right 16 samples forward
  1272.       Alt-Shift-Cursor left  16 samples backward
  1273.       Ctrl-Cursor left       Previous screenful of tracks
  1274.       Ctrl-Cursor right      Next screenful of tracks
  1275.       Space bar              Stop playing
  1276.       Alt-Space              Continue block
  1277.       Ctrl-Space             Reset MIDI pitchbenders/mod. wheels/presets
  1278.       Shift-Space            Continue song
  1279.       Shift-Alt-Space        Play song
  1280.       Esc                    Editing on/off
  1281.       ~                      Double space on/off
  1282.       F1 - F4                Select keyboard octaves 1+2 - 4+5.
  1283.       F6                     Cursor to the first line of the block
  1284.       F7                     Cursor to the second quarter of the block
  1285.       F8                     Cursor to the middle of the block
  1286.       F9                     Cursor to the last quarter of the block
  1287.       F10                    Cursor to the last line of the block
  1288.       Ctrl-F1 - F10          Select displayed panel
  1289.       Ctrl-Shift-0 - 9       Pick note 0 - 9
  1290.       Ctrl-5, Ctrl-6         Sliding ST or MED
  1291.       Ctrl-A                 Automatic advance on/off
  1292.       Ctrl-F                 Display free memory (chip, fast, largest chip)
  1293.       Ctrl-M                 Set mark for copying/cutting regions
  1294.       Ctrl-R                 Revert filename
  1295.       Amiga-F                Low-pass filter on/off
  1296.       Amiga-I                Activate sample name gadget.
  1297.       Shift-Amiga-I          Clear and activate sample name gadget
  1298.       Amiga-J                Jumping on/off for this sample
  1299.       Amiga-L                Load song
  1300.       Amiga-P                Play song (Shift-Alt-Space)
  1301.       Amiga-R                Activate repeat gadget (in Sample-panel)
  1302.       Amiga-T                Create slide using command 3 (transform)
  1303.       Amiga-Shift-T          Create slide using command 1 and 2
  1304.       Amiga-X/C/V            Cut/copy/paste current track
  1305.       Amiga-Shift-X/C/V      Cut/copy/paste current block
  1306.       Shift-0 - 9            Enter note 0 - 9
  1307.       TAB                    Highlight this line
  1308.  
  1309. Numeric keypad:
  1310.       1 - 9, Shift-1 - 8 Tracks on/off
  1311.       Ctrl-8             Scroll the playing sequence list up
  1312.       Ctrl-2             Scroll the playing sequence list down
  1313.       Ctrl-4             Decrease the block number of the psl
  1314.       Ctrl-6             Increase the block number of the psl
  1315.       Ctrl-7             Move to the beginning of the psl (psl = the
  1316.       Ctrl-1             Move to the end of the psl        playing
  1317.       Ctrl-5             Insert this block to the psl      sequence
  1318.       Ctrl-0             Insert number 0 to the psl        list)
  1319.       Ctrl-.             Delete the block number from the psl
  1320.       Alt-8              Scroll samplelist up
  1321.       Alt-2              Scroll samplelist down
  1322.       Alt-4              Previous sample dir
  1323.       Alt-6              Next sample dir
  1324.       Alt-9              Scroll samplelist one page up
  1325.       Alt-3              Scroll samplelist one page down
  1326.       Alt-7              Beginning of the samplelist
  1327.       Alt-1              End of the samplelist
  1328.       Alt-5              Load selected sample
  1329.       
  1330. ***************************************************************************
  1331. I'm sorry if these instructions are difficult to understand, confusing
  1332. or something like that. It's just difficult for me to write instructions
  1333. for beginners, tutorials, etc... Feel free to contact me if you have any
  1334. questions. Also if you think you could write a good tutorial about writing
  1335. songs, please write!! I could add it to the documents of the next version.
  1336.  
  1337. !!! ICON ARTISTS !!! -- I know that there are guys (or girls???) who could
  1338.     design much more beautiful icons (especially MEDPlayer has very
  1339.     ugly icon). If you've designed better-looking icon(s), please send
  1340.     them to me!!!!
  1341.  
  1342. All right, I won't beg anything any more. For © information and my address,
  1343. see the "Read me"-file. Bye!!! See you in the next release of MED!!!
  1344. ***************************************************************************
  1345.