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