home *** CD-ROM | disk | FTP | other *** search
/ Da Capo / da_capo_vol1.bin / programs / amiga / edit / octamedv2 / docs / octamed2.0.doc < prev    next >
Text File  |  1993-03-13  |  90KB  |  1,906 lines
  1. ***************************************************************************
  2. **                                                                       **
  3. **              OctaMED - music editor, © 1991 Teijo Kinnunen            **
  4. **                                                                       **
  5. **   This version 2 is Freely Distributable but Copyright is retained    **
  6. **                                                                       **
  7. **                 Instructions for OctaMED V2.00                        **
  8. **                                                                       **
  9. ***************************************************************************
  10.  
  11. Welcome  to use the OctaMED music editor!!!  OctaMED is an all-purpose music
  12. editor that can be used to compose music for demos, games etc., and works as
  13. a stand-alone program as well.
  14.  
  15. First  few  words  about  editing.  If you've used any Tracker, you probably
  16. know  these  things.  OctaMED can display "standard" notes, but often you'll
  17. use  the  "Tracker-style" editing, in which the music is represented by note
  18. names and numbers.
  19. For example:
  20.         01  C-2 1000  --- 0000  E-5 K210  --- 0F20
  21.         02  D-2 1000  E#1 4000  --- 0000  --- 0000
  22.         03  --- 0000  --- 0000  --- 0000  --- 0000
  23.  
  24. In this form, the music is quite fast and handy to edit when you get used to
  25. it,  but it's quite useless when printed (nobody could play it).  That's why
  26. there's now a new notation printer in OctaMED V2.
  27.  
  28. The  song consists of blocks, every block contains 1 - 256 lines.  There can
  29. be  up  to  100 blocks and they can be played in any order and any number of
  30. times.   In addition, there can be up to 99 songs in memory at once (sharing
  31. the set of up to 63 instruments).
  32.  
  33. The  user  interface  of  OctaMED  is  divided  in  ten  "panels",  each one
  34. containing  different  gadgets.   Only one of these panels is visible on the
  35. screen.   You  can  select  the  displayed  panel with ten gadgets which are
  36. always visible.  There are lots of keyboard shortcuts.  After you've learned
  37. the  use  of the program, you probably want to learn these shortcuts because
  38. they make the program much more powerful to use.  There are also some things
  39. which  are available only by using the keyboard, so you should read the list
  40. of keyboard shortcuts at the end of this manual.
  41.  
  42. There  are  also  five  different  big  displays.   Normally  the  notes are
  43. displayed  in  this  area.   Optionally  you can choose the notation editor,
  44. synthsound  editor, sample editor or the sample list to be displayed on this
  45. area.
  46.  
  47.  
  48. Entering the notes
  49. ==================
  50. Notes are entered with Amiga's keyboard (entering with MIDI-keyboard is also
  51. possible).  The keys are ordered in piano style:
  52.  
  53.      2 3   5 6 7   9 0   ´ \
  54.     Q W E R T Y U I O P Å ]
  55.       S D   G H J   L Ö
  56.      Z X C V B N M , . /
  57.  
  58. This way you can enter about 2,5 octaves of the 5,2 octaves available.  Keys
  59. F1 - F4 can be used to switch the octaves.  The lower row of keys (Z - /) is
  60. the lower octave, Q - U is the higher octave and keys I - \ are part of even
  61. higher octave.
  62.  
  63. If  you have an instrument loaded, you can hear the sound when you press the
  64. keys.   If  you want to enter notes onto the block, you must turn on editing
  65. (Esc).   DEL-key  is used to enter the pause (---).  The cursor can be moved
  66. with the cursor keys.
  67.  
  68. Blocks and the playing sequence
  69. ===============================
  70. When you compose a song, you do it block-by-block.  Fill a block with notes,
  71. create new block, fill it with notes...
  72.  
  73. In order to get the blocks played in correct order, you must also create the
  74. playing  sequence  list.  It is just a list of block numbers, which are then
  75. played  in that order, from beginning to end.  This way you can use the same
  76. block  many  times in your song.  When the last block from the list has been
  77. played,  the song will start again from the beginning (it's also possible to
  78. stop  the  playing).   The  maximum  length  of  the playing sequence is 256
  79. numbers.
  80.  
  81. Status bar
  82. ==========
  83. Between  the  panel  and the block display is the status bar, which displays
  84. some "strategic" information which is always good to be visible.
  85.  
  86.                                                           Song/# of songs
  87.                                                                        |
  88.                                                 Song selection gadgets |
  89.                                                                   / \  |
  90.  +-------+-----+--+-+--+----+--------+--+------------------------+-+-+-----+
  91.  |001/003|00/02|12|E|SP|CHRD|::::::::|01|AnalogString            |<|>|01/02|
  92.  +-------+-----+--+-+--+----+--------+--+------------------------+-+-+-----+
  93.      |       |  |  |  |  |      |      |         |
  94. Playseq-ptr  |  |  |  |  |    Tracks  Instr #   Instrument name
  95.              |  |  |  |  Chord mode on/off
  96.         Block # |  |  Insert empty space between notes
  97.                 |  |
  98.  Keyboard octaves  Editing on
  99.  
  100. Playseq-ptr: The first number is the current playing sequence number
  101.              (starting from 1) and the second is the number of playing
  102.              sequence numbers in the song. The 1st number is meaningful
  103.              when you're playing the song or editing the playseq list.
  104.  
  105. Block #:     The first number is the number of the current block (starting
  106.              from 0) and the 2nd is the number of the last block. It does
  107.              not tell how many blocks there are, but if you add 1 to it,
  108.              it does. In the example there are 3 blocks, and the first
  109.              is currently displayed.
  110.  
  111. Keyboard octaves:
  112.              This number tells you which octaves are currently in use
  113.              when you play the Amiga keyboard. The first number is the
  114.              octave number of the lower row of keys and the 2nd is the
  115.              higher. It can be changed with F1 - F4.
  116.  
  117. Editing on:  This is a quite important option. When the editing is off,
  118.              you can't insert notes or numbers to the song. To turn it
  119.              on/off press Esc or click the "E" with mouse. When the "E"
  120.              is highlighted, editing is on.
  121.  
  122. SP:          This switch activates the extra space between the notes you
  123.              enter. It is useful when you're entering slow pieces of music.
  124.              You don't have to hit DEL so often.
  125.  
  126. CHRD:        This turns the chord entering mode on/off.
  127.  
  128. Tracks:      It's possible to switch tracks on/off during editing. The 16
  129.              points represent the 16 possible tracks. When the point is
  130.              red (default) the track is turned on. When it's white, then
  131.              this track is turned off.
  132.  
  133. Instr #:     The number of the current instrument. The maximum number of
  134.              instruments is 63. The instruments are numbered 01 - 1V
  135.              (01 - 09, 0A - 0V, 10 - 19, 1A - 1V).
  136.  
  137. Instrument name:
  138.              The name of the current instrument.
  139.  
  140. Song handling gadgets are discussed below.
  141.  
  142. You  can change the instrument number, current block and current playseq ptr
  143. by  clicking  on  the number you want to change with the mouse.  Left button
  144. increases,  right  button  decreases.   This  is  the fastest way to advance
  145. playseq ptr for example by 100:  click the 100's number with LMB.
  146.  
  147. Instruments
  148. ===========
  149. As  noted  above,  there can be up to 63 instruments in one song.  There are
  150. currently  four  types  of instruments:  samples, synthsounds, hybrid sounds
  151. and MIDI instruments.
  152.  
  153. Samples: These are the instruments which are played through four Amiga
  154.          audio channels. They can be played only within tracks 0 - 3.
  155.          OctaMED can load raw samples and IFF 8SVX 1, 3 and 5-octave samples.
  156.          It means that you can load practically any sample to OctaMED and
  157.          use it in your songs. Note that raw samples and 1-octave 8SVX
  158.          samples can use only octaves 1 - 3. Octaves 4 and 5 play from
  159.          octave 3.
  160.  
  161. Synthsounds:
  162.          These are a special instruments, that allow you to construct
  163.          a sound from simple pieces of waveforms, and controlling things
  164.          like waveform #, volume, pitch, arpeggio and vibrato using a
  165.          simple "programming language". Synthsounds sound usually quite
  166.          simple (C-64 style), but they don't take much memory, either.
  167.  
  168. Hybrid sounds:
  169.          This is a normal sample, but it can be controlled using the
  170.          same "programming language" as synthsounds.
  171.  
  172. MIDI instruments:
  173.          These are not actually instruments. They are just few settings
  174.          which cause the notes played with that instrument to be sent
  175.          through MIDI-interface. They don't take memory like the samples.
  176.          When you want some instrument to be a MIDI-instrument, you must
  177.          set the MIDI channel which is used when playing notes/effects.
  178.          You can also set the preset value for the instrument. Then
  179.          the instrument is automatically played using that preset number
  180.          of your MIDI-device (synthesizer, keyboard...). You can also
  181.          set the preset number to 0. Then the preset which is already
  182.          set in that channel is used.
  183.  
  184. Sample loading
  185. ==============
  186. Because  many  people  have  hundreds/thousands of samples, spread over many
  187. different  disks/directories,  the  samples  have  to be organized some way.
  188. OctaMED  handles  the organization using a file "MED_paths" (path file).  It
  189. contains  the name of the directory, names of the samples in that directory,
  190. name  of another directory...and so on.  This way OctaMED knows what samples
  191. each  of  your  sample  disks/directories  contain and can load samples from
  192. correct disks.  The path file is loaded when starting up OctaMED and it must
  193. be  located  in  the  current  directory  or S:-directory.  This file can be
  194. produced with text editor, but it is easier to do it with OctaMED.  Detailed
  195. instructions later in this manual.
  196.  
  197. Note
  198. ====
  199. The note and the numbers:
  200.  
  201.                 command
  202.                    |
  203.          D # 3   5 1 0 F
  204.            |     |   \ |
  205.          note    |    \|
  206.          instrument #  data byte (more information about command)
  207.  
  208. "note" is the note to be played (or "---" for no note)
  209. "instrument #" is the number of the instrument (01 - 1V). The leading
  210.                zero is displayed as a space. The number can also be 0.
  211.                It means that the note is played with same instrument
  212.                number and with same volume as previous note in that
  213.                track.
  214. "command" is the number of command/effect to play. If there are no
  215.           effect or commands, command nibble and data byte are zero.
  216. "data byte" gives more information about command/effect to the player.
  217.  
  218. Effects/commands are documented later...
  219.  
  220. The  numbers  can  be  changed  simply  with positioning the cursor over the
  221. number  to  be changed and typing the new number.  If you have to change the
  222. 5th  number (between the note and the other numbers:  C-212000), which means
  223. that  sample  10  -  1V  is  used, position the cursor over the first number
  224. that's  always  visible  (the  second  '2' in above example), hold Shift and
  225. enter  the  1st  number.  For example, to change instr.  number to 1E, press
  226. Shift-E.   Because  Shift-0  -  9 have other use, press Amiga-Shift-0 - 9 to
  227. change  the  instr.  number to 10 - 19.  This is not very handy, but because
  228. there  won't  probably  be a lot of songs which have over 31 instruments, it
  229. doesn't matter very much.
  230.  
  231. Prompts
  232. =======
  233. OctaMED   often  (especially  during  file  operations)  wants  to  ask  you
  234. something.   For  this  purpose OctaMED displays a line of text on the title
  235. bar e.g.
  236.     Remap instruments (Y/N)?
  237.  
  238. You  always  answer to these questions with keyboard, in this case you would
  239. press  'Y'  for  a  positive, and 'N' for a negative answer.  If you want to
  240. cancel the operation (loading, saving...), you can usually press 'Esc' to do
  241. that.
  242.  
  243. Multiple songs
  244. ==============
  245. OctaMED can have more than one song in memory at a time.  However, all songs
  246. share the same set of instruments.  This allows you to, for example, compose
  247. different songs for each level of a game, without having to load or keep the
  248. same instrument in memory more than once.
  249.  
  250. On the status bar there are two gadgets which control this feature (see the
  251. description of the status bar above).
  252.  
  253. If you click the right gadget (assuming you've just booted OctaMED), OctaMED
  254. will  request  "Add new song (Y/N)?".  If you answer 'Y', a new song will be
  255. created.  You can now move from song 1 to song 2 with these gadgets.  If you
  256. want  to delete the last song, press the left gadget while holding the Shift
  257. key.  Again, OctaMED will request you before proceeding.
  258. Note:  If you want to add a new song without the prompt, you can hold Shift
  259.        while clicking the right song selection gadget.
  260.  
  261. OctaMED  can  automatically  remap instruments while loading.  This feature
  262. saves  you  from  a lot of work.  For example, you have one song in memory,
  263. and  you add another (by clicking the right song selection gadget).  If you
  264. now  load  a  second  song  from disk, OctaMED will ask:  "Remap instrument
  265. (Y/N)?".   If  you reply 'N', all previous instruments will be lost and the
  266. instruments  of  the  new  song will be loaded.  But if you reply 'Y', some
  267. magic  will  happen.  First, the instruments of the new song will be loaded
  268. to  empty  slots, instruments already in memory will be preserved.  Second,
  269. the  instrument  numbers  of  the loaded song will be remapped so that they
  270. point to new places of the instruments.
  271.  
  272. Sometimes, when there are unused instruments in memory, OctaMED will ask if
  273. you want to flush them.  This can happen when you Clear the song, or load a
  274. new song (replacing another).
  275.  
  276. You  can  also  save  all  the songs as a single multi-module.  You have to
  277. select  "Module" in the save format requester, and answer 'N' at "Save only
  278. current  song"  prompt.   If you select 'Y', only the current song is saved
  279. (unused instruments won't be saved).
  280.  
  281. To get rid of all the songs/instruments, click "Clear all" on Misc panel.
  282.  
  283.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  284.  ***************************************************************************
  285.  *                                                                         *
  286.  *  +-------------------------------------------------------------------+  *
  287.  *  |                     Summary of the features                       |  *
  288.  *  +-------------------------------------------------------------------+  *
  289.  *                                                                         *
  290.  ***************************************************************************
  291.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  292.  
  293. +=========================================================+
  294. |           Files
  295. +=========================================================+
  296. This  panel  contains  the tools you need when handling files.  You can save
  297. and load with many different formats and also delete them.
  298.  
  299. First  of  all,  there's  a file requester.  There should be no difficulties
  300. with  using it.  It is simple, but it works.  Directory names are printed in
  301. white  and files in black.  There are three gadgets that allow you to choose
  302. what  is  displayed  in the requester.  If the Currdir is selected, files in
  303. the  current directory are displayed.  Devices lists all devices e.g.  DF0:,
  304. DF1:,  DH0:   etc..   Assign  lists  all assigned directories (e.g.  C:, S:,
  305. FONTS:).  You can also load a directory by typing its name on the Dir-gadget
  306. (and  pressing  Return).
  307.  
  308. The  File-gadget  contains the filename.  If you know already the filename,
  309. you  can ignore the file requester and type the filename (with correct path
  310. from the startup directory).
  311.  
  312. ------- Load
  313. Song:       This is the gadget used to load songs. Loads songs
  314.             with following formats:
  315.                   MED V1.12 - V3.20,
  316.                   OctaMED V1.00 - V2.00
  317.                   MMD0 (MED modules), SoundFX/old SoundTrackers.
  318.             The samples are automatically loaded after the song.
  319.             WARNING: Don't try to load anything as a song!!!
  320.             If OctaMED can't identify the file, it is loaded as an old
  321.             SoundTracker file. If it is an old SoundTracker file, it
  322.             should load well, but if it isn't, you may meet the GURU!!!!
  323.             OctaMED can't load packed SoundTracker/NoiseTracker files. To
  324.             import songs, save them as modules, then load into OctaMED with
  325.             "ST MOD". OctaMED also recognizes Noise/Protracker modules
  326.             and prompts if you want to load it as a such (usually you should
  327.             answer 'Y').
  328.  
  329. Instr:      Loads the sample. The title bar will display the length of
  330.             the sample if it loaded ok. This will load synthsounds and
  331.             hybridsounds as well.
  332.  
  333. ST MOD:     With this gadget you can load 31-instrument Sound/Noise/Pro-
  334.             tracker modules. There are some differences between MED's and
  335.             Tracker's commands, they're converted automatically.
  336.  
  337. ------- Save
  338. Song:       When you choose this one, a requester appears and asks you to
  339.             select the save format. The save formats are described a couple
  340.             of lines later. There's also "Icon" gadget. When it is selected,
  341.             OctaMED will create an icon file when saving Song or Sng+samples.
  342.             If you don't need the icon, turn it off to save some disk
  343.             space.
  344.  
  345. Instr:      Saves the current sample/synthsound/hybrid sound. If you want
  346.             to save samples in IFF-format, set the switch in sample editor.
  347.  
  348. Delete:     Deletes the file. OctaMED requests if you really want to delete
  349.             it.
  350.  
  351. ======= Save formats
  352.  
  353. There are several different file formats available:
  354.  
  355. Song     This is the normal song, which you will probably use most often.
  356.          The song is saved using a highly-compressing file format. The
  357.          samples are not saved. They are loaded from your instrument disk(s)
  358.          using the path list (or absolute paths if instrument names are e.g.
  359.          ST-01:Ringpiano).
  360.  
  361. Sng+samples
  362.          Saves the song like the previous one, but also attaches the
  363.          samples to the end of the file. The result is one big file which
  364.          contains everything needed. This format makes usually a bit
  365.          shorter files than Module, but I recommend that you now save
  366.          your songs as a module, at least if they'll be distributed.
  367.  
  368. Module (MMD0)
  369.          This is the most flexible file format, which allows you to save
  370.          all song information, like Sng+samples, but this format is most
  371.          likely understood by external programs, because Sng+samples is
  372.          quite tricky to load and use. Also, multiple songs can be saved in
  373.          one module. In general, files saved in this format are longer than
  374.          Sng+samples files.
  375.  
  376.          When you save a module, you'll be asked "Save instrument names etc".
  377.          If you answer 'Y', all data is saved. Otherwise only the data
  378.          required for playing the song is saved. The copyright/annotation
  379.          text is always saved.
  380.  
  381. ST-Module
  382.          If you want to export music to Sound/Noise/Protracker,
  383.          you can use this gadget to save the song as a module.
  384.          NOTE: Because there are many things in MED that are not supported
  385.                by Trackers, some information may be lost:
  386.                - samples 10 - 1V won't work
  387.                - only 4 tracks saved, no MIDI support
  388.                - blocks longer than 64 lines will be truncated to 64 lines
  389.                - no color or pointer jump information
  390.                - no relative volume settings, no play/instrument transpose
  391.                - no hold/decay
  392.                - no support for synthsound/hybrid sounds
  393.          NOTE 2: The resulted file will be a 31-instrument module. If you
  394.                  try to use it with programs supporting only old modules,
  395.                  it'll most likely fail.
  396.  
  397. +=========================================================+
  398. |            Play
  399. +=========================================================+
  400. This  is  a very important panel.  Here you can control the playing, set the
  401. playback speed (tempo), handle the playseq list...
  402.  
  403. Beginning from the left, there is a tall box which contains numbers "00" if
  404. there's  no  song  in  memory.   This  is a window to the playseq list.  As
  405. mentioned above, the playseq list is the list of blocks to be played.  This
  406. window  show  5  numbers  of  the list at a time.  There are gadgets on the
  407. right side of the box which scroll the list up/down/beginning/end.
  408.  
  409. The keyboard equivalent is to hold down the Ctrl-key and then press number 8
  410. from  numeric  keypad  to  scroll  up,  2  to  scroll  down, 7 (home) to the
  411. beginning, 1 (end) to the end.
  412.  
  413. On the right side of the scroll gadgets are the following gadgets:
  414.          +   -   Ins   Del   Ins (with small arrow pointing down)
  415.  
  416.          +      increases the current playseq number (Ctrl - keypad 6)
  417.          -      decreases the playseq number (Ctrl - keypad 4)
  418.          Ins    inserts a new sequence number (zero) under the cursor
  419.                 (Ctrl - keypad 0 (Ins))
  420.          Del    deletes the current sequence number (Ctrl - keypad . (Del))
  421.          Ins (w/arrow) inserts a new sequence number, the new number
  422.                 will be the number of current block (Ctrl - keypad 5)
  423.  
  424. ------- Controlling the playing
  425.  
  426. Play song       starts playing the song from the beginning.
  427. Continue song   starts playing from the current playseq entry and cursor pos.
  428. Play block      plays the current block (starts from the beginning).
  429. "D" (next to Play Block) starts playing block when you enter a note (editing
  430.                 must be on).
  431. Continue block  starts playing the current block from the cursor position.
  432. Stop playing    stops playing the song. You can also use it to kill the
  433.                 notes played from the Amiga/MIDI keyboard.
  434.  
  435. The shortcuts of these commands:
  436. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  437. Stop playing    press just Space
  438. Play song       press Space with Alt+Shift held down
  439. Continue song   press Space with Shift down
  440. Continue block  press Space with Alt held down
  441. Play block      no shortcut, sorry.
  442.  
  443. ------- Tempo (playing speed)
  444.  
  445. To  understand  this  completely,  you need to know some technical aspects.
  446. OctaMED  uses  the  CIAB timers for timing.  They give "timing pulses" that
  447. trigger  the  OctaMED's player interrupt.  On each timing pulse effects are
  448. handled (e.g.  commands 1,2,3,4,5,D, hold/decay, synthsounds), but new note
  449. is usually not played on each pulse.  The time between timing pulses can be
  450. changed  (primary  tempo).   The  new  note  is usually played on every 6th
  451. pulse,  but  this can be changed too (secondary tempo), for example, if new
  452. note  was  played  on  every 3th pulse, the playing speed would be twice as
  453. fast.  This doesn't affect the speed of effects.
  454.  
  455. Graphically:
  456. pulse   \         PLAY NOTE
  457.          the time between pulses can be changed (primary tempo)
  458. pulse   /         DO EFFECTS  \
  459.                                \
  460. pulse             DO EFFECTS    \ The number of pulses between
  461.                                 / notes can be changed (4 in this example).
  462. pulse             DO EFFECTS   /  This is the secondary tempo.
  463.                               /
  464. pulse             PLAY NOTE
  465. ...
  466.  
  467. The left proportional gadget controls the primary tempo.  It can be 1 - 240.
  468. The  bigger  the  number, the faster the speed.  Note that tempos 1 - 10 are
  469. Tracker-compatible (but obsolete, because secondary tempo can be used now).
  470.  
  471. The  right one controls the secondary tempo (default = 6).  It can be 1 - 20
  472. (note:   hexadecimal!!).   The  lower,  the faster.  This allows quite rough
  473. setting of playing speed (it's the way NoiseTracker etc.  set their tempos).
  474. In MIDI use (especially for syncing), you should leave this to 6 and use the
  475. primary tempo instead.
  476.  
  477. LP-Filter       with this gadget you can turn on/off the audio filter
  478.                 built into your Amiga. When this gadget is selected
  479.                 and the power-LED is bright, the filter is on. If
  480.                 the LED is dim, the filter is off. You probably want
  481.                 to keep it off.
  482.                 The state of this switch will be saved with songs.
  483.  
  484.         NOTE: With Amiga 1000's, it's not possible
  485.                 to turn off the filter without modifications to the
  486.                 computer. Please keep the filter off.
  487.  
  488. E1, E2, E3      If you've played something with OctaMED, you have found the
  489.                 three "equalizers" (in fact, they are not equalizers, but
  490.                 I'll use this word, because many others do so too...)
  491.                 E1 turns off/on the red bars at the bottom of the screen
  492.                 (PAL machines only). E2 turns off/on the four colorful
  493.                 sprites. E3 turns off/on the signal "oscilloscope" displays.
  494.  
  495.                 These all are turned off to save processor time when
  496.                 you click the right mouse button to show the title bar,
  497.                 but if you want to disable something, it probably is E3.
  498.                 The signal display eats lots of the processor time (on
  499.                 standard 68000). Because of that, the display is turned
  500.                 off during disk access to speed loading/saving. You may
  501.                 want to keep E3 disabled all the time.
  502.  
  503.         In OctaMED 5 - 8 channel modes these equalizers are turned
  504.         off automatically to decrease processor load.
  505.  
  506. STS             Normally effects are done on every timing pulse (see above).
  507.                 When this switch is on, the effects are NOT done on the
  508.                 first pulse (when the note is played). This is the way the
  509.                 Trackers do that, and this switch is for compatibility only.
  510.  
  511. V: Hex/Dec      This is another compability switch. While the data bytes
  512.                 of the commands are usually hex numbers, it's possible to
  513.                 use the volume-command with hex or decimal argument.
  514.                 When Hex is selected, the acceptable volumes are 00 - 40.
  515.                 When Dec is selected, the volume can be 00 - 64.
  516.                 If you are not a programmer (and even if you are), it may
  517.                 be easier to think the numbers in decimal. It is the
  518.                 default.
  519.                 The state of this switch will be saved with songs.
  520.  
  521.                 You can easily convert all volume commands from decimal to
  522.                 hex and vice versa. If Dec is selected and you click Hex
  523.                 while holding the Shift key down, automatic conversion is
  524.                 done (works on the same way to the opposite direction too).
  525.  
  526.                 I recommend using Hex volumes whenever possible. It is
  527.                 slightly faster (not noticeably, but faster anyway).
  528.  
  529. Channels 4 5 6 7 8
  530.                 These gadgets control the channel configuration of OctaMED.
  531.                 4 is selected when making four-channel and MIDI songs.
  532.                 When gadgets 5 - 8 are selected, OctaMED uses a different
  533.                 player, which allows "splitting channels", in other words,
  534.                 playing two sounds on one audio channel. When OctaMED is in
  535.                 8-channel mode, all four audio channel is splitted. When
  536.                 the 5-channel mode is selected, only one channel is splitted
  537.                 and the other channels can use high-quality DMA output.
  538.  
  539.                 Splitting channels causes heavy CPU load. The CPU load
  540.                 and some technical reasons set some limitations to the
  541.                 5 - 8 channel modes:
  542.                 - limited playing speed selection (only the secondary
  543.                   tempo can be changed)
  544.                 - synthetic/hybrid sounds can't be used
  545.                 - all equalizers are disabled
  546.                 - all MIDI features are disabled
  547.                 - instrument default volume is ignored
  548.                 - in standard (68000, 7.14 MHz) Amiga, screen depth should
  549.                   be 2 (automatically set) because of the heavy DMA load of
  550.                   the 8 color screen
  551.                 - relative volumes are ignored
  552.                 - limited repeat/repeat length (only in 400-byte steps)
  553.                 - mouse pointer jumping disabled
  554.  
  555.                 The sound quality is reduced on splitted channels (some
  556.                 distortion usually occurs). The audio filter can help in
  557.                 these cases. Also, some samples don't sound as good as the
  558.                 others: very bright samples cause more distortion.
  559.  
  560.                 Every sample played on a splitted channel must be 'halved'.
  561.                 This means halving the playback volume. When you load samples
  562.                 in 5 - 8 channel modes, they're automatically halved. You
  563.                 can prevent OctaMED from halving the sample if you hold
  564.                 Shift key when clicking 'Load sample'. You can use non-halved
  565.                 samples on non-splitted (DMA-driven) channels, or on a
  566.                 splitted channel if the other half of that channel is silent.
  567.         If you attempt to use non-halved sample on a splitted channel,
  568.         when there are two voices simultaneously, terrible noise
  569.         usually occurs.
  570.  
  571.                 The channel configuration on each of the modes is as follows:
  572.  
  573.                 S = splitted, N = not splitted, - = unused
  574.                 (L) = left, (R) = right
  575.  
  576.  Track          0       1       2       3       4       5       6       7
  577. +------------+-------+-------+-------+-------+-------+-------+-------+-------+
  578. |5 channels  | S (R) | N (L) | N (L) | N (R) | S (R) |  -    |  -    |  -    |
  579. +------------+-------+-------+-------+-------+-------+-------+-------+-------+
  580. |6 channels  | S (R) | S (L) | N (L) | N (R) | S (R) | S (L) |  -    |  -    |
  581. +------------+-------+-------+-------+-------+-------+-------+-------+-------+
  582. |7 channels  | S (R) | S (L) | S (L) | N (R) | S (R) | S (L) | S (L) |  -    |
  583. +------------+-------+-------+-------+-------+-------+-------+-------+-------+
  584. |8 channels  | S (R) | S (L) | S (L) | S (R) | S (R) | S (L) | S (L) | S (R) |
  585. +------------+-------+-------+-------+-------+-------+-------+-------+-------+
  586.  
  587.         Note that 5 - 8 channel mode does NOT mean how many tracks there are.
  588.         The number of tracks should be eight, and it is selected from the
  589.         'Block' panel.
  590.  
  591.         There should be as few channels as required. E.g. the 6 channel mode
  592.         is much faster than the 8 channel mode, in addition you get two high
  593.         quality tracks (2 and 3) without reduction in sound quality.
  594.  
  595.         Because there are only 4 hardware channels and 4 volume registers,
  596.         two channels must share each volume register. Channels 0 and 4, 1
  597.         and 5, 2 and 6, 3 and 7 each share one register. This means that
  598.         every volume change command (C) affects both tracks. For example:
  599.         Track:     0        1        2        3        4
  600.             000 C-1 3000 E-1 3000 G-1 3000 --- 0000 A#2 5C20 ...
  601.  
  602.         So, the C20-command on track 4 affects both tracks 4 and 0. The
  603.         default volume of instruments is ignored because it would affect
  604.         two tracks, and might cause quite a mess...
  605.  
  606. ------- Panic stop
  607. It's  possible  to  make  a song, which takes all of the processor time.  It
  608. will therefore be impossible to stop it.  This shouldn't happen accidentally,
  609. but  if  you  fill  a block with notes and command FF3 and set tempo to 240,
  610. you'll  get the idea.  To stop playing in this case, hold both mouse buttons
  611. down about 5 - 6 seconds.
  612.  
  613. +=========================================================+
  614. |           Instr
  615. +=========================================================+
  616.  
  617. Here  you can load samples and alter some characteristics of them.  First I
  618. should note out some important actions which are available on the keyboard:
  619.     Shift-Cursor Left/Right = select previous/next sample
  620.     Shift-Alt-Cursor L/R    = 16 samples forward/backwards
  621.     Amiga-I                 = activate sample name gadget
  622.     Shift-Amiga-I           = clear and activate sample name gadget
  623.     Amiga-R                 = activate repeat gadget
  624.     Amiga-J                 = jump on/off
  625.  
  626. At the top left corner of this panel is the sample number (01 - 1V) followed
  627. by  the sample name gadget followed by the length of current sample in bytes
  628. ("-" if no sample loaded).
  629.  
  630. To  load  a  sample, you can write the name of it in the string gadget, then
  631. click "^ Load Sample ^" (or just press Return).
  632.  
  633. Above  the  Load Sample gadget are gadgets that select first, previous, next
  634. or  last  sample.   L.U.   (Last  Used)  selects  the last sample that is in
  635. memory.
  636.  
  637. On  the  left side of them are two gadgets ("Jump", "Flush").  "Jump" causes
  638. jumping when this instrument is played. "Flush" removes this instrument.  It
  639. frees  the  memory  used  by  it  (handy when you're very low on memory) and
  640. clears all the values.  Jumpings will be saved with songs.
  641.  
  642. "Transpose"  is  one  of  the  new  features  of V2.10.  It works like "Play
  643. transpose"  but  only  for  this  instrument.  So, if "Transpose" is -2, for
  644. example, then this instrument is played two halfsteps lower.
  645.  
  646. Repeat  means  that when you play a note with some instrument, the note will
  647. play  forever,  until  you  play a new note.  A picture tells more than 1000
  648. words:
  649.  
  650.          the beginning              repeat start offset           the end
  651.          v                                v                             v
  652. Sample: | This part is played only once  | This part is looped forever | |
  653.  
  654.          \__________repeat_______________/ \________repeat length______/
  655.  
  656. "Repeat" is the length of the part which is played only once (in bytes).
  657. "Repeat length" is the length of the part which is played forever (also
  658. in bytes).
  659.  
  660. When  you load IFF-instruments, these values are automatically loaded.  They
  661. can  be also set in path file, so that when you load a sample, you will also
  662. get  the  repeat values.  Gadget REP/BEG is the repeat start offset, REP/LEN
  663. is the length.  If the repeat length is lower than 4, no repeat will occur.
  664.  
  665. The  big  proportional  gadget  controls  the  default volume of the current
  666. instrument:   64  =  maximum,  0  =  silent.  It's displayed in both hex and
  667. decimal.
  668.  
  669. ------- Hld/Dec (Hold/Decay)
  670. (again a thing, that is difficult to explain...)
  671. With  Hold,  you  can set the exact duration of the note (in timing pulses).
  672. The  note  is  then turned off (if decay is 0) or decay is started.  In this
  673. example,  I  assume  that  the  secondary tempo is 6 (one line is one timing
  674. pulse)
  675.  
  676. 1. no hold
  677.  
  678. 0 PLAY+fx C-2 1000 <= play note
  679. 1 fx
  680. 2 fx
  681. 3 fx
  682. 4 fx
  683. 5 fx
  684. 0 PLAY+fx D-3 1000 <= stop previous and play new
  685. 1 fx
  686. ...
  687.  
  688. 2. with hold set to '2'
  689.  
  690. 0 PLAY+fx C-2 1000 <= play note
  691. 1 fx
  692. 2 STOP+fx          <= stop it
  693. 3 fx
  694. 4 fx    (silence here)
  695. 5 fx
  696. 0 PLAY+fx D-3 1000 <= play new note
  697.  
  698. In  example  1,  (without  hold)  you can set the note duration only roughly
  699. (accuracy  of 6 timing pulses).  In example 2, the note duration is only two
  700. timing pulses (because hold = 2).
  701.  
  702. So,  this  allows  a  powerful definition of note length, but it can't be
  703. used with long notes, because the note stops immediately??  Wrong!!
  704.  
  705. Look at this:
  706.  
  707. 000 C-2 1000               / line# pulse# action
  708. 001 -|- 1000              /   003    0    continue note...
  709. 002 -|- 1000             /    003    1    continue note...
  710. 003 -|- 1000 => ZOOMED =>     003    2    STOP NOTE
  711. 004 --- 0000             \    003    3    (silence)
  712. 005 D-3 1000              \   003    4    (silence)
  713. ...
  714.  
  715. So,  the keep holding -symbol (-|-) allows you to make the note longer.  The
  716. keep  holding  -symbol  can  be entered by clearing the note and setting the
  717. instrument number only, or easier:  by pressing Return.
  718.  
  719. If  the  decay  is  0, the note is turned off immediately after the stopping
  720. point.   You  can  set  the  decay  to  happen as well (1 = slowest).  Decay
  721. doesn't work with MIDI-instruments.
  722.  
  723. If  you're  using synthsounds or hybrid sounds, see Synthsounds.doc, because
  724. the decay is handled quite differently with them.
  725.  
  726. The  hold/decay  is  a quite useful feature, so I recommend you learn to use
  727. it!!  (Thanks to ZAP for suggesting me this feature!!)
  728.  
  729. +=========================================================+
  730. |           Block
  731. +=========================================================+
  732. This  panel  contains  most  of  the  block  handling  things  and  the copy
  733. operations.
  734.  
  735. Trk: Cut Copy Paste Swap
  736.          These gadgets are used to cut/copy/paste tracks. Swap swaps
  737.          the contents of the copy buffer and current track.
  738.          The keyboard shortcuts for Cut/Copy/Paste are:
  739.                 Amiga-X, Amiga-C, Amiga-V
  740.  
  741. Blk:  Cut Copy Paste Swap
  742.          These work just like the previous, they just affect the entire
  743.          block. The keyboard shortcuts are also just like the previous
  744.          except hold down the Shift key too (Amiga-Shift-X...).
  745.  
  746. Del buff
  747.          When you don't need the contents of the buffer any more, you
  748.          can click this gadget to free the memory allocated for the buffer.
  749.          It's useful when you're very low on memory. The buffer is freed
  750.          automatically when you exit, so you may not need this gadget
  751.          at all.
  752.  
  753. Then there are the block commands.
  754.  
  755. Trks: 4 8 12 16
  756.          You can select how many tracks you want this block to have.
  757.          Note that tracks 4 - F can be used only with MIDI devices.
  758.          Note also that when you decrease the number of tracks, the
  759.          higher tracks will be lost (no Are you sure? requesters).
  760.  
  761. Lines: 64 < > « »
  762.          These gadgets are used for selecting the number of lines in
  763.          this block. « » gadgets increase/decrease the number by 10,
  764.          < > gadget by 1. The preferred way is to write the number
  765.          directly into the string gadget (less memory fragmentation).
  766.  
  767. 1 2 3 4 8 16 C
  768.          It may be helpful for easier positioning of notes to be able to
  769.          "mark" lines some way (especially if the block is long). You
  770.          can make some lines appear with reversed colors, if you want.
  771.          1 highlight every line, 2 highlights every other line, 3 high-
  772.          lights every third line and so on. C clears all highlighting from
  773.          this block. You can also mark individual lines with TAB-key.
  774.          The highlighting can be removed by highlighting the line(s) again.
  775.          The highlightings are saved with songs.
  776.  
  777. New block
  778.          This gadget creates a new block after the last block. The new
  779.          block will have the same number of tracks and lines as the
  780.          current block.
  781. DEF      This is the same as 'New block' except that the block length
  782.          is always set to 64 and the number of tracks to four (eight,
  783.          if you're in 5 - 8 channel mode).
  784.  
  785. New here
  786.          Creates a new block here, shifts all following blocks forward.
  787.          The playseq numbers are corrected so that the song won't change.
  788. DEF      Uses default length/number of tracks, see DEF definition above.
  789.  
  790. Del last
  791.          Deletes the last block (no warning messages, be careful).
  792.  
  793. Del this
  794.          Deletes the current block. Playseq numbers corrected.
  795.  
  796. Split    Splits the current block so that the current line will be the
  797.          first line of the next block.
  798.  
  799. Join     Joins this block and the following block together.
  800.  
  801. Ins.L.   Inserts an empty line under the cursor. The block length is
  802.          increased by one and the notes are shifted one step forward.
  803.  
  804. Del.L.   Deletes the current line. Block length is decreased and the lines
  805.          are shifted backwards.
  806.  
  807. Ins.Trk  Inserts a new track. The subsequent tracks are shifted one step to
  808.          right, and the rightmost track is lost.
  809.  
  810. Del.Trk  Deletes current track, and the subsequent tracks are shifted to
  811.          left one step.
  812.  
  813. Expand   When you have created a nice-sounding block, but you would like
  814.          to include e.g. some fast rhythm patterns, but you notice that
  815.          the block plays too slowly for the patterns. "Expand" changes
  816.          the size of the block and creates empty lines between notes.
  817.          Now you can increase the tempo and insert the rhythm patterns.
  818.  
  819.          NOTE: The maximum length of the expanded block may not be greater
  820.          than 256 lines. In that case, you'll get a warning, and expansion
  821.          is not done. Also, if you want to make fast rhythm patterns, see
  822.          first instructions for commands FF1, FF2, FF3. They may be an
  823.          easier way.
  824.  
  825. Shrink   When you have expanded the block, you can return it to the
  826.          original state by pressing shrink. This function exists for
  827.          symmetry. It has not much real use.
  828.  
  829. The number gadget between these two gadgets is the amount of expanding.
  830. E.g. 2 doubles the length (inserts one empty line between each note).
  831. 3 would triple the length, and so on.
  832.  
  833. +=========================================================+
  834. |           Edit
  835. +=========================================================+
  836. Edit-panel contains functions that help editing.
  837.  
  838. On:             These are the switches that allow you to switch temporarily
  839.                 any track off and back on. The 16 lights in the status bar
  840.                 show you which tracks are on, when you're not using the
  841.                 Edit panel. ST sets all tracks on, CL sets all tracks off.
  842.  
  843. Edit and SPC    at the right corner are the bigger equivalents of
  844.                 "E" and "SP" in the status bar. "Edit" turns editing
  845.                 on/off and SPC turns on/off extra spacing between notes.
  846.                 You can type the space value in the string gadget next
  847.                 to the SPC-gadget (1 - 16). When you enter notes during
  848.                 playing (in real time) with SPC on, the notes will be
  849.                 quantized e.g. if SPC = 2, the notes will be placed only
  850.                 on even-numbered lines.
  851.                 Keyboard: Edit on/off = Esc, SPC = ~ (below ESC)
  852.  
  853. 1+2, 2+3, 3+4, 4+5 on the left corner select the keyboard octaves which
  854.                 are used. This can be done also with F1 - F4 keys.
  855.  
  856.  
  857. ------- Programmable keys
  858. It's  possible  to assign 10 different notes/commands to number 0 - 9.  Then
  859. you  can  insert  the  note/command  with Shift- 0 - 9.  You can also assign
  860. commands to Left and Right Alt.  When you then enter notes, holding down the
  861. Alt,  command is inserted to the note.  The programmable keys are especially
  862. useful when entering drum-rhythms etc.  The definitions can be saved so that
  863. they're automatically loaded when you start OctaMED next time.
  864.  
  865. It's  also possible to pick up a range of notes (they can't be edited after
  866. picking).
  867.  
  868. "Edit"-panel  contains  gadgets,  which  you can use to edit the notes/cmds.
  869. Only one note/cmd of the 12 is displayed at a time.
  870.  
  871. 0-9      Shows the current 'Shift-number key' definition, the number is
  872.          shown above the arrow gadgets, which can be used to change it.
  873.  
  874. L.Alt    Shows the definition of Left Alt
  875.  
  876. R.Alt    Shows the definition of Right Alt
  877.  
  878. The current definition of each key is displayed on the Edit-panel. If some
  879. number is marked as "x", it's "transparent", the existing number will not
  880. be changed when the note is entered to the block (with Shift 0 - 9).
  881.  
  882. You can change the definition by picking a note, but you can change it in
  883. another  way  as  well.   Click  the  number to be changed, and enter a new
  884. number from keyboard while still holding the mouse button, and pointing the
  885. number  to  be  changed.   If you want to change several numbers, you don't
  886. have  to  release  the button.  Just position the mouse over the number you
  887. want to change.
  888.  
  889. For  example, if you wanted to clear all commands from this track (but leave
  890. the notes) you could make a following definition:
  891.  
  892.          xxx  xx000
  893.  
  894. Because  the  note  is  "xxx"  and  instrument number is "xx", they won't be
  895. changed,  and  only the command is cleared.  Then you can just hold down the
  896. Shift and the number key and let the key-repeat do the job.
  897.  
  898. R.Alt  and  L.Alt  are a bit different:  the note number is always "xxx" and
  899. the instrument number by default is "xx".
  900.  
  901. Pick note
  902.        copies the note currently under the cursor to this key. You can
  903.        also pick, for example #7 by pressing Shift-Ctrl-7.
  904. Pick range
  905.        picks the current range as a definition of this key
  906. Pick buf
  907.        picks the copy buffer as a definition of this key
  908. Clr    clears the definition of this key.
  909.  
  910. SPACE=DEL
  911.        Some people may prefer using the space bar instead of DEL when
  912.        entering blank notes. This switch makes it possible.
  913.  
  914. Keypad: Track on/off / Sel.instr
  915.        This allows you to set the keypad operating mode. When it's set
  916.        to "Track on/off", the keypad can be used to turn tracks 0 - F
  917.        on/off. When "Sel.instr" is selected, you can select quickly the
  918.        first 16 instruments. The layout is as follows:
  919.         [ = 0  ] = 1  / = 2  * = 3
  920.         7 = 4  8 = 5  9 = 6  - = 7
  921.         4 = 8  5 = 9  6 = 10 + = 11
  922.         1 = 12 2 = 13 3 = 14 . = 15
  923.  
  924. Advance
  925.         Here are some quite useful editing options, that control the
  926.         automatic advancing of the cursor after entering something.
  927.  
  928.         (down arrow)  When this is selected, the cursor automatically
  929.                       moves to the next line when a note is entered.
  930.                       Shortcut: Ctrl-A
  931.         (up arrow)    Moves the cursor to the previous line, when note
  932.                       entered. This is probably not very useful (but
  933.                       interesting...)
  934.         >             When entering effect numbers, the cursor is moved
  935.                       to right (but not to next line).
  936.         <             When entering numbers, the cursor moves to left.
  937.                       (again, not too useful...)
  938.         >>            When entering notes, the cursor is moved to the next
  939.                       track.
  940.         <<            When entering notes, cursor is moved to the previous
  941.                       track.
  942.  
  943. +=========================================================+
  944. |           Misc
  945. +=========================================================+
  946. Some  miscellaneous and not very important things and a VERY important thing
  947. (quitting).
  948.  
  949. On  the  left  there are gadgets for changing the screen colors.  No need to
  950. explain??   All right, I won't.  But just remember that the colors are saved
  951. when you save your song (they can give some "feel and expression").  You can
  952. also set the default colors of OctaMED by clicking Save prefs.
  953.  
  954. Jumping: Off 8th Smp
  955.          When you don't want to see the "funny" mouse pointer, select Off.
  956.          When you want him to jump every 8th note, select 8th.
  957.          When you want him to jump when some sample is played, select
  958.          Smp. The instruments which cause him to jump are selected from
  959.          "Instr"-panel (gadget name: Jump).
  960.  
  961.          The name of the pointer is Topi (according to my cousin).
  962.  
  963. Clear All, Clear song only, Quit
  964.          These are very dangerous functions, in fact they're so dangerous
  965.          that you must click 'Confirm' after you've selected one of them:
  966.  
  967.          "Clear All" does just as it says. Clears the song, removes all
  968.          instruments from memory. In two words: clears everything.
  969.          Note: This clears ALL songs.
  970.  
  971.          "Clear song only" is not as destructive. While it destroys the
  972.          song, it leaves the instruments (if you want to create a new
  973.          song without reloading the instruments).
  974.          Note: This clears only the current song.
  975.  
  976.          "Quit" is the most destructive. It does everything "Clear
  977.          All" does, but even worse, it quits OctaMED!!!!!!
  978.          This function was made for program testing and it probably
  979.          doesn't have any real use ;-)
  980.  
  981. Paths: Add/Rem
  982.          These affect the sample names when loading songs/samples.
  983.  
  984.           Add        Adds the complete path of the sample when you
  985.                      load e.g. if you load sample "PopSnare2" from
  986.                      "ST-01:", the sample name will be "ST-01:PopSnare2".
  987.  
  988.           Rem        Usually songs made with Trackers have sample names
  989.                      like "ST-02:AhhVox". If you want that the samples are
  990.                      loaded using the path list instead of absolute names
  991.                      (if your samples are in hard disk, for example) you
  992.                      can remove "ST-xx:" from sample names and reload them,
  993.                      but when you "Rem paths" is selected, any paths before
  994.                      the sample names are removed quickly and easily during
  995.                      loading.
  996.  
  997.          Both of these can be active at the same time. In that case the
  998.          original path is removed, instrument is loaded using the path list,
  999.          and the path name from the path list will be added.
  1000.          Note that the maximum length of a instrument name is 39 chars,
  1001.          so if the path name is very long, something may be lost.
  1002.  
  1003. H->B:
  1004.          This selects the name of the note between A# and C.
  1005.          In some countries, it's H. In some other countries it's B.
  1006.  
  1007. WB: Open/Close
  1008.          These gadgets allow you to easily close/reopen the Workbench
  1009.          screen to give you extra memory space.
  1010.  
  1011. Save prefs
  1012.          This will save the default settings of OctaMED to S:med.config.
  1013.          When you start OctaMED next time, these settings will be loaded.
  1014.          The following things will be saved:
  1015.                 Current screen colors as default colors
  1016.                 H->B
  1017.                 State of E1, E2 and E3 switches
  1018.                 Screen depth (Dep2)
  1019.                 NO16
  1020.                 Space = Del
  1021.                 Keypad mode
  1022.                 Automatic advance settings
  1023.                 Current programmable key definitions
  1024.                 Jump: Off
  1025.                 PTKey
  1026.  
  1027. Dep2    This changes the screen depth from 8-colors to 4 colors. This
  1028.         frees some chip memory, but most important: it releases lots of
  1029.         DMA-time. In plain English: OctaMED will run faster (but looks
  1030.         less pretty).
  1031.  
  1032. NO16    When there are 16 tracks, OctaMED uses the 16 track display.
  1033.         However, the text is then rather small, and if you don't have a
  1034.         good monitor - unreadable. If you select NO16, the 8 track
  1035.         display is used instead (you can scroll horizontally).
  1036.  
  1037. PTKEY   This switch changes the keyboard operation so, that the most common
  1038.         Protracker keyboard options will be recognized. This is helpful for
  1039.         those who have got used to Protracker keyboard layout. The following
  1040.         PT shortcuts are recognized:
  1041.  
  1042.         Right shift     Turns editing on, starts playing the block (= record)
  1043.         Right alt       Continue song
  1044.         Right Amiga     Play block
  1045.         L-Alt+curs.L/R  Previous/next block
  1046.         Shift+curs.L/R  Increase/decrease playseq position
  1047.         Space           Stops playing/toggles editing.
  1048.         TAB             Next track
  1049.         Shift-TAB       Previous track
  1050.         Shift-F3 - F5   Cut/Copy/Paste track
  1051.         Alt-F3 - F5     Cut/Copy/Paste block
  1052.  
  1053.         If there are any other Protracker options you'd like MED to recognize,
  1054.         please let me (Teijo) know.
  1055.  
  1056. Note that the S2FST switch of OctaMED V1 is now removed. OctaMED now loads
  1057. most of its graphic data into fast memory, leaving you about 90 K more chip
  1058. memory for samples.
  1059.  
  1060. +=========================================================+
  1061. |         Vol
  1062. +=========================================================+
  1063.  
  1064. This  panel  allows  you  to set the proportional volume of each track.  In
  1065. addition you can also set the master volume.  The proportional value can be
  1066. 1  -  64.  If both the master volume and the volume of a track are 64, that
  1067. track  is  played  on full volume.  If the master volume was 32 and a track
  1068. volume was 32, the volume of that track would be 1/4 of the full volume.
  1069.  
  1070. There  are  two  sets  of  « < 64 > » gadgets.  The one on the right is the
  1071. master volume.  The left one changes the volume of the selected track.  You
  1072. can  select  the  track,  by  clicking  a  number  above  the gadgets.  The
  1073. currently selected number is highlighted.
  1074.  
  1075. This  is  quite  easy,  so no problems should appear.  The track volumes and
  1076. the master volume are saved with songs.
  1077.  
  1078. +=========================================================+
  1079. |           MIDI
  1080. +=========================================================+
  1081. OctaMED  can  output  notes  and  some  commands  to  external MIDI-devices
  1082. (keyboards, synthesizers...).  The MIDI-panel contains the MIDI-stuff which
  1083. is needed for that.
  1084.  
  1085. When  you  decide  that  some  instrument  should be a MIDI-instrument, you
  1086. select  the  MIDI channel for it.  "MIDI ch"-gadgets are used for that.  If
  1087. you  select  e.g.  MIDI channel 2, the notes of this instrument are sent in
  1088. MIDI channel 2 (simple, isn't it?).
  1089.  
  1090. Also,  you  need to activate MIDI (click "MIDI active").  If the serial port
  1091. is  used by some other program, you can't use MIDI.  Then you must terminate
  1092. the other program and try again.
  1093.  
  1094. After  you  have  activated  MIDI,  OctaMED  starts sending "active sensing"
  1095. messages   ($FE).    Active   sensing   can   be   turned   off   with   the
  1096. "Act.sensing"-gadget.   Now you can try to play with this instrument and you
  1097. should  hear  the  sound  from  you MIDI-device (remember to set the default
  1098. volume of the sample [Sample-panel]).
  1099.  
  1100. OctaMED  uses now the default preset of that channel (which you have set on
  1101. your  MIDI device).   If you want to use other presets, you can select them
  1102. using the "MIDI pres #"-gadgets, in that case the program change message is
  1103. transmitted  when a note is played.  Preset number 0 means that the default
  1104. preset  is  used (the preset is never changed for this instrument).  If you
  1105. want  to  send  a preset change command, but don't want to play a note yet,
  1106. use  the  command  C00  with  any  note.   In that case, the preset will be
  1107. changed, but no note will be transmitted.
  1108.  
  1109. You  can have instruments with differents preset numbers, but which will use
  1110. the  same  MIDI  channel.  In that case, OctaMED will automatically send the
  1111. program  change message whenever the instrument with different preset number
  1112. is used.
  1113.  
  1114. You can use MIDI-instruments on all 16 tracks (if there are 16 tracks on the
  1115. current block).  You can also freely mix samples and MIDI-instruments on the
  1116. same track (tracks 0 - 3 only).
  1117.  
  1118. One  helpful  keyboard  command  is  Ctrl-Space.  This command resets pitch-
  1119. benders  and  modulation  wheels on all channels.  Also, if you have changed
  1120. presets  on  your MIDI-device, OctaMED can't detect this and thinks that the
  1121. preset  is  not changed.  Ctrl-Space causes OctaMED to resend program change
  1122. commands for all channels, when playing.  There's a gadget:  "Reset pb+pres"
  1123. that does the same thing.
  1124.  
  1125. The "MIDI reset"-gadget sends a MIDI reset command ($FF).
  1126.  
  1127. If  you  turn  "Send  sync" on, OctaMED will send MIDI sync information, and
  1128. allow  other  devices  to  synchronize with OctaMED.  When "Ext sync" is on,
  1129. OctaMED can be synced externally.  You must also have input active when this
  1130. is  turned  on.   The  synchronization  works  only when you play song, when
  1131. you're playing a single block, the syncing is disabled.
  1132.  
  1133. L.Ctrl  on/off  gadgets  allow  you  to  easily  send  Local  control on/off
  1134. messages.
  1135.  
  1136. Suppr.N.Off  suppresses  Note  Off messages of the current instrument.  Some
  1137. devices  may  have  some  instruments  (e.g.   one-shot  drum  sounds) which
  1138. actually  ignore  the Note Off messages.  When Suppr.N.Off is selected, Note
  1139. Offs are not sent for the current instrument.  This reduces some unnecessary
  1140. MIDI output (slightly faster).
  1141.  
  1142. There  are  commands  which  control  the pitchbender, modulation wheel etc.
  1143. Detailed documetation later (again??).
  1144.  
  1145. ------- Entering notes with MIDI
  1146. You  can  use  your  keyboard, synthesizer or whatever, to insert notes (you
  1147. don't need to use your Amiga's keyboard to entering).  You must activate the
  1148. "Input"-gadget.   If  editing  is  on and your MIDI-device is sending notes,
  1149. they  will be entered.  You can also enter Amiga-samples with MIDI.  Next to
  1150. the  Input-gadget, there's a integer gadget, that contains the number of the
  1151. input MIDI channel.  If it's 0, then OctaMED will accept input from all MIDI
  1152. channels.
  1153.  
  1154. "Read volume" gadget may be sometimes quite useful.  If you have a velocity-
  1155. sensitive  keyboard, the volume will be entered in the command-part when you
  1156. enter  notes  and  this gadget is selected.  "Read key-up" is not as useful.
  1157. When  it's  active,  OctaMED  records  key-up  events.   It  can  be used in
  1158. real-time recording (and mostly for long notes).
  1159.  
  1160. You  may  have noticed that you can't directly use all the octaves which are
  1161. available  on  the MIDI device.  "Instrument transpose" helps this.  You can
  1162. have two instruments with identical settings except for different instrument
  1163. transpose.  With instrument transpose you can reach nearly the full range of
  1164. notes.
  1165.  
  1166. NOTE: When you have a MIDI-instrument, its name doesn't really have any use.
  1167.       However it's good practice to type in the names of the presets. This
  1168.       way you can easily see the presets, and, if you give the song to
  1169.       somebody else who may have different MIDI-equipment, he/she can
  1170.       easily change the preset numbers to use the correct presets on his/her
  1171.       MIDI-device.
  1172.  
  1173. +=========================================================+
  1174. |        Trans
  1175. +=========================================================+
  1176.  
  1177. Starting  from  the  bottom,  there's  a long string gadget that can hold an
  1178. annotation  text  for  the  song.   When you save the song, the text in this
  1179. gadget will be saved, and it will be displayed when loading the song.
  1180.  
  1181. The  other  functions  of  this  panel  has something to do with transposing
  1182. notes.
  1183.  
  1184. When  you're doing some transposing, you should first decide which areas the
  1185. transposing  should  affect.   At  the top of the panel there are gadgets to
  1186. select this:
  1187.     Affect/song     the functions of this panel will affect the whole song
  1188.     Affect/block    the functions will affect the current block
  1189.     Affect/track    current track will be affected
  1190.     Affect/sel.trks selected tracks in this block will be affected
  1191.     Affect/range    the range selected with mouse will be affected
  1192.  
  1193.     Instr/all       all instruments affected
  1194.     Instr/curr      only the current instrument affected
  1195.  
  1196. First there are some simple transposing operations:
  1197.     1/2 ^ (<-arrow up) transposes the affection area up one half-step
  1198.     1/2 v (<-arrow down) transposes down one half-step
  1199.     oct ^ transposes one octave up
  1200.     oct v transposes one octave down
  1201.  
  1202. ------- Note (ex)change
  1203. Suppose  you want to change all D-3's of instr 2 in your song to C-1.  First
  1204. you  set  Affect/song  (affect the whole song).  The you go to instrument #2
  1205. and select Instr/curr (to affect only this instrument).
  1206.  
  1207. Now  you  click the box at the right of the text "Note", hold down the mouse
  1208. button,  and  enter note D-3 from keyboard (D-3 will be displayed).  This is
  1209. the  source  note  name.   Then you click the box at the right of the source
  1210. note  box, hold the mouse button again, and enter C-1.  Now you have set the
  1211. destination note.
  1212.  
  1213. Finally  you just click the "->" gadget at the right of the dest.  note box.
  1214. If  you  had  wanted  to exchange the notes (D-3 => C-1 AND C-1 => D-3), you
  1215. would have clicked the "<->" gadget instead.
  1216.  
  1217. ------- Instrument deletion/changing
  1218. The left instrument number is the source number and the right one is
  1219. the destination number. To set them, select the instrument (e.g. Shift-
  1220. cursor left/right) and click on the number.
  1221. Del        Deletes the notes with source instrument number.
  1222. ->         Changes the source instrument number to dest. instrument number
  1223. <->        Exchanges the source and instrument numbers
  1224.  
  1225. ------- Play transpose
  1226. This gadgets allows you transpose the whole song quickly.  It doesn't change
  1227. the notes, it only affects playing.
  1228.  
  1229. +=========================================================+
  1230. |       Range
  1231. +=========================================================+
  1232.  
  1233. This  panel  contains  many  of  the  range-editing options.  The range is a
  1234. rectangular  area of notes in a block.  It is selected by dragging using the
  1235. right  mouse  button and (then moving the mouse).  It only works on vertical
  1236. note display.
  1237.  
  1238. The  numbers  at the right bottom corner show you the starting/ending tracks
  1239. and starting/ending lines of the block.
  1240.  
  1241. At  the left side of the panel, there are gadgets "Select track" and "Select
  1242. block".   These allow you to select a single track or block quickly.  To the
  1243. right  of  them,  there  are  gadgets for range operations.  The simplest is
  1244. "Clear".   It  clears  all  notes in the range.  Above it is "Cut".  It also
  1245. clears  the  notes,  but  copies  them to the copy buffer for later pasting.
  1246. "Copy"  doesn't  clear  the notes, just copies them to the copy buffer.  You
  1247. can  paste  the  contents  of the copy buffer with "Paste".  The copy buffer
  1248. will  then  be  copied  starting at the cursor.  If the copy buffer contains
  1249. e.g.   3  tracks, and you don't want to copy them to consecutive tracks, but
  1250. e.g.   tracks  2,  7,  and  9,  You  would  select  tracks  2, 7, and 9 with
  1251. track-selection  gadgets  (at  the top), and then click "Paste select".  The
  1252. notes  will  be  pasted only to selected tracks.  The "Cancel" gadget can be
  1253. used to forget the range (e.g.  if you've accidentaly hit the RMB).  You can
  1254. achieve the same effect with moving to another block.
  1255.  
  1256. Spread  2/3/4  allow you to spread notes on one track to consecutive tracks.
  1257. For  example,  get  an  empty block, fill track 0 with notes, select track 0
  1258. (with "Select track" for example), and try these gadgets.
  1259.  
  1260. S1, S2          These gadgets can perform the quite tedious task of
  1261.                 creating slides. Here's how it works (example):
  1262.  
  1263.                 You want to make a slide from C-2 to G-2:
  1264.  
  1265.                     000 C-2 1000
  1266.                     001 --- 0000
  1267.                     002 --- 0000
  1268.                     003 --- 0000
  1269.                     004 --- 0000
  1270.                     005 G-2 1000
  1271.                     006 --- 0000
  1272.  
  1273.                 Move the cursor to the line where you want the
  1274.                 slide to begin (in this example, line 002). Then click
  1275.                 S1 or S2. Result:
  1276.  
  1277.                 If you click S1         If you click S2
  1278.                    000 C-2 1000            000 C-2 1000
  1279.                    001 --- 0000            001 --- 0000
  1280.                    002 G-2 1306            002 --- 0108
  1281.                    003 --- 0306            003 --- 0108
  1282.                    004 --- 0306            004 --- 0108
  1283.                    005 --- 0306            005 G-2 1000
  1284.                    006 --- 0000            006 --- 0000
  1285.  
  1286.                 The better result is usually achieved using S1. S1 and S2
  1287.                 use the different sliding commands (that's the difference).
  1288.                 With S2, the second note is also replayed. The commands
  1289.                 itself are documented later.
  1290.                         Keyboard: S1 = Amiga-T, S2 = Shift-Amiga-T
  1291.  
  1292. VOL             Creates a volume slide. With this option, it's possible
  1293.                 to create easily fades etc. Example:
  1294.  
  1295.                 009 --- 0C50 <-start volume   \    009 --- 0C50
  1296.                 010 --- 0000  =================\   010 --- 0C47
  1297.                 011 --- 0000  | Click "VOL"     \  011 --- 0C44
  1298.                 012 --- 0000  |                 /  012 --- 0C40
  1299.                 013 --- 0000  =================/   013 --- 0C37
  1300.                 014 --- 0C34 <-end volume     /    014 --- 0C34
  1301.  
  1302.                 The cursor must be positioned somewhere between the C-
  1303.         commands (on lines 10 - 13 in this example).
  1304.  
  1305. Select: 0, 1, 2, ... E, F
  1306.         These gadgets are used to select tracks (not range). Some track-
  1307.         based operations may need this (e.g. Paste select), or you can set
  1308.         the transpose operations to affect the selected tracks.
  1309.         ST selects all tracks, while CL deselects them.
  1310.  
  1311. Chord
  1312.         This gadget can be used if you want to enter chords. First you
  1313.         should select the tracks, which the chord entering affects (with
  1314.         above gadgets). The chord always starts from the current track and
  1315.         then continues to the next selected track etc...
  1316.         After you've selected this gadget and turned editing on, you can
  1317.         try entering a major C-chord (select all tracks now, because this is
  1318.         just an example!!).
  1319.         Press Q (C), hold it down. Then press E (E) holding both keys still
  1320.         down. Finally T (G). Now you can release the keys, and the cursor
  1321.         moves back to the starting track and advances line.
  1322.         Chord editing works well with MIDI too.
  1323.  
  1324. ============================================================================
  1325. ============================================================================
  1326.         Big displays
  1327.  
  1328. OctaMED  has  some  panels,  that are displayed in the large area (where the
  1329. notes usually are).  The rightmost strip of panel-selection gadgets are used
  1330. to  select  one  of  the five possible big displays.  The displays (gagdets)
  1331. are:
  1332.         Vertical note display
  1333.         Notation editor
  1334.         Synthetic sound editor
  1335.         Sample editor
  1336.         Sample list
  1337.  
  1338. *===========================================================================
  1339. *       Notation editor
  1340. *===========================================================================
  1341. See the doc file "Note_editor.doc" for description.
  1342.  
  1343. *===========================================================================
  1344. *       Synthetic sound editor
  1345. *===========================================================================
  1346. See the doc file "Synthsounds.doc"...
  1347.  
  1348. *===========================================================================
  1349. *       Sample editor
  1350. *===========================================================================
  1351. See the doc file "Sample_editor.doc"...
  1352.  
  1353. *===========================================================================
  1354. *       Sample list
  1355. *===========================================================================
  1356.  
  1357. ------- What is it??
  1358. Sample list is a list of all your samples and sample disks/directories.  You
  1359. can  easily scan through your sample lists and load a sample by clicking its
  1360. name.   When  you've  constructed  the  sample  list, it is saved and always
  1361. loaded  when  you  run  OctaMED.  You don't have to load directories of your
  1362. sample disks more than once.  Sample list (MED_paths) contains the directory
  1363. declarations,  so  OctaMED  can automatically load your samples from correct
  1364. disks, minimizing disk swappings, when you load songs.
  1365.  
  1366. ------- How to create a Sample list??
  1367.  
  1368.           Using the filerequester, load the directory of your sample
  1369.           disk/dir. Then go to the "SList"-panel. Now click Dir/ADD.
  1370.           You should see the filenames of the directory to appear.
  1371.           You can now examine the list, and if there are files which
  1372.           are not samples, destroy them from the list with Instr/DEL.
  1373.           Repeat this procedure for each sampledisk/dir you have.
  1374.           You can select the displayed directory with the right display,
  1375.           which displays the directory names.
  1376.  
  1377.           When you have made the list, you probably want to save it.
  1378.           Save/S: does the job. If you click CD, the path file will be
  1379.           saved to the current directory (be sure that it is the same where
  1380.           you started OctaMED). If you click "S:", the file will be saved
  1381.           to the S:-directory. I prefer placing the file in S:, because
  1382.           then it doesn't matter which is the current directory when
  1383.           starting OctaMED. The file is called "MED_paths".
  1384.  
  1385.           If you later want to add entries to the directory, you can
  1386.           delete the whole directory from the list with Dir/DEL. Then you
  1387.           must click the name of the directory to remove.
  1388.           Then you can reload the directory. You can also add entries
  1389.           one at a time. If you click Instr/ADD, the name of the
  1390.           current sample is added to the list. Also the repeat/rep.length
  1391.           values are then added to the list (form: Asia::480/5362).
  1392.           Note that the previous entry with same name is not deleted,
  1393.           so you must delete it by hand (using Instr/DEL), if you want to
  1394.           add rep./rep.len values to the list.
  1395.  
  1396.           If the current instrument is a MIDI-instrument when you add
  1397.           the name, the name will be a form E.Piano::M6/4 . The 1st
  1398.           number is the channel, the 2nd is the preset. When you later
  1399.           load instrument of that name, the MIDI-channel/preset will be
  1400.           set. Note that the instrument with this name doesn't really
  1401.           have to exist in that directory, it's like a "dummy" entry.
  1402.           You may want to create a "dummy" directory for these dummy
  1403.           MIDI entries (empty dir).
  1404.  
  1405.           At the top is the box displaying the directory name and number.
  1406.           The right display only displays the last 16 chars of the dir
  1407.           name, because it's the most meaningful. For example
  1408.           some of my instruments are located in directory:
  1409.  
  1410.                 work:samples/ST-01/
  1411.  
  1412.           If the box showed the first 16 chars, it would be
  1413.           "work:samples/ST-" (which isn't as helpful).
  1414.  
  1415.           The instrument loading is simple. Just click the instrument name
  1416.           on the left display, and it's loaded.
  1417.  
  1418. ------- Loading MED_paths
  1419.  
  1420.           You can load a new MED_paths file, using the file requester.
  1421.           If you select a file called MED_paths, you'll be immediately
  1422.           requested if you want to load it. If you press 'R', the list
  1423.           in the memory will be lost and the new one will be loaded. If
  1424.           'A' is pressed, the current path list is preserved and the new
  1425.           one will be appended to it.
  1426.  
  1427.           Finally, I reveal the keyboard shortcuts...
  1428.  
  1429.                 Alt-numeric keypad-8 = scroll the list up (very useful)
  1430.                 Alt-numeric keypad-2 = scroll the list down (very too)
  1431.                 Alt-keypad-9 (PgUp)  = scroll the list up fast
  1432.                 Alt-keypad-3 (PgDn)  = scroll the list down fast
  1433.                 Alt-keypad-7 (Home)  = to the beginning of the list
  1434.                 Alt-keypad-1 (End)   = to the end of the list
  1435.  
  1436. +-------------------------------------------------------------------+
  1437. |+-----------------------------------------------------------------+|
  1438. ||           OctaMED V2.00 player commands/effects                 ||
  1439. |+-----------------------------------------------------------------+|
  1440. +-------------------------------------------------------------------+
  1441.  
  1442. This section gives information about commands/effects. They are events
  1443. which affect the playing and they are handled by the MED player routine.
  1444.  
  1445.          C - 2  1 2 3 4
  1446.                   | \ |
  1447.      command number  \|
  1448.                       data byte
  1449.  
  1450. You insert the commands usually by hand (turn editing on, move cursor
  1451. on the command numbers and type the numbers). It may be a bit easier
  1452. if you turn off automatic-advance with Ctrl-A.
  1453.  
  1454. Here are the descriptions of each of the currently recognized commands:
  1455.  
  1456.  
  1457. +---------------------------------------------------+
  1458. | Command 0:  ARPEGGIO       MIDI: controller value |
  1459. +---------------------------------------------------+
  1460.  
  1461. This command changes the pitch of the note quickly (6 times during 1 note).
  1462. It can be used to create "chords" or special effects. If you've listened
  1463. to music made with the C-64, you MUST have heard arpeggios. The pitch is
  1464. changed between 3 different pitches during one note:
  1465.          the 1st pitch is the pitch of the original note
  1466.          the 2nd pitch is the pitch of the original note + the 1st number
  1467.                 of databyte halfsteps up
  1468.          the 3rd pitch is the pitch of the original note + the 2nd number
  1469.                 of databyte halfsteps up
  1470.  
  1471. Note: 3rd pitch | 2nd pitch | 1st pitch | 3rd pitch | 2nd pitch | 1st pitch
  1472.       changed 6 times during note
  1473.  
  1474. It may be a bit difficult to understand, so here's an example:
  1475. You want to make an arpeggio which sounds like C-major chord.
  1476.  
  1477. The lowest pitch is C (C-2 in this example).
  1478. The second is E-2 (4 halfsteps higher than C-2).
  1479. The third is G-2 (7 halfsteps higher than C-2).
  1480.  
  1481. 4 halfsteps from C-2 -+ 7 halfsteps from C-2
  1482.                       |/
  1483. That produces:  C-2 1047
  1484.                 --- 0047
  1485.                 --- 0047 and so on...
  1486.  
  1487. Data byte for a minor chord would be 37.
  1488.  
  1489. The arpeggios sound better with some instruments than others.
  1490.  
  1491. MIDI: See command 5 for a description.
  1492.  
  1493. +---------------------------------------------------+
  1494. | Command 1:  SLIDE UP       MIDI: pitchbender up   |
  1495. +---------------------------------------------------+
  1496.  
  1497. This command slides up the pitch of the current track.
  1498.  
  1499. With Amiga samples:
  1500.          Decreases the period of the note the amount of databyte on each
  1501.          timing pulse. Sounds rather technical?? Yes... The instructions for
  1502.          previous (before 2.10) versions of MED contained detailed
  1503.          instructions for making good-sounding slides with this command.
  1504.          Because this version now contains the easy automatic slide making
  1505.          (Amiga-T), I felt that these instructions are not necessary any more.
  1506.          If you use this function for special effects (not real slides) then
  1507.          you can experiment with the values for the databyte.
  1508.          Example:
  1509.                 A-1 1000
  1510.                 --- 0000
  1511.                 --- 010F <- slide up a bit
  1512.  
  1513. With MIDI:
  1514.          This commands works very differently with MIDI. It actually
  1515.          "turns" the pitchbender 8 * databyte steps up on each timing pulse.
  1516.          Because the actual range of the pitchbender may be different with
  1517.          different MIDI-devices, you must find the right value by
  1518.          experimenting. There's also one thing you should know: when a new
  1519.          note is played, the pitchbender is not resetted automatically. To
  1520.          reset the pitchbender, you use this command with databyte zero.
  1521.          Example:
  1522.                 G-2 L1FF <-turn it up very quick
  1523.                 --- 0000
  1524.                 --- 0100 <- then reset the pitchbender
  1525.  
  1526.  
  1527. +---------------------------------------------------+
  1528. | Command 2:  SLIDE DOWN     MIDI: pitchbender down |
  1529. +---------------------------------------------------+
  1530.  
  1531. Not much about this command. It's just like command 1 except it slides
  1532. down.
  1533.  
  1534.  
  1535. +---------------------------------------------------+
  1536. | Command 3:  PORTAMENTO     MIDI: set pitchbender  |
  1537. +---------------------------------------------------+
  1538.  
  1539. This is another slide command (on some old MED versions (2.00) this
  1540. was a vibrato command, see command 5 now). It can be used to
  1541. make perfect slides more easily. First an example:
  1542.  
  1543.          C-2 5000 <- played note C
  1544.          --- 0000
  1545.          E-2 5305 <- this note is not played!! Instead, slide target is set
  1546.          --- 0300    to G-2 and slide speed is 5
  1547.          --- 0300 <- when speed is zero, use the previous speed
  1548.          --- 0306 <- the speed can be changed, of course
  1549.  
  1550. This example would slide from C-2 to E-2, but the slide stops EXACTLY
  1551. when E-2 is reached. The remaining 3's have no effect. This command
  1552. is easier to handle with automatic slide making (see Edit/S1 above).
  1553.  
  1554. MIDI: By using this command, you can set the pitchbender to an absolute
  1555. value, instead of sliding as commands 1 and 2 do. The data byte is the
  1556. pitchbender value, expressed as a signed hexadecimal digit (a nightmare
  1557. to non-programmers!).
  1558.         00 = center position
  1559.         80 (-7F) = smallest value
  1560.         7F = largest value
  1561.  
  1562. Example:
  1563.         C-2 3000
  1564.         --- 037F <- pitchbender to max. value
  1565.         --- 0300 <- reset
  1566.  
  1567.  
  1568. +---------------------------------------------------+
  1569. | Command 4:  VIBRATO        MIDI: modulation wheel |
  1570. +---------------------------------------------------+
  1571.  
  1572. The first number of the data byte is vibrato speed, the second is
  1573. vibrato depth. If the numbers are zeros, the previous speed and depth
  1574. is used.
  1575.  
  1576. Example: F-215000
  1577.          --- 0000
  1578.          --- 0433 <- slow, not much depth
  1579.          --- 0437 <- more depth
  1580.          --- 043F <- full depth
  1581.          --- 0482 <- fast, not very deep
  1582.  
  1583. MIDI: This command affects the modulation wheel of the current channel.
  1584.       The data byte can be 00 - 7F. 00 = no modulation, 7F = maximum.
  1585.       Values 80 - FF are reserved for future expansion (and won't work).
  1586.  
  1587.  
  1588. +---------------------------------------------------+
  1589. | Command 5:  OLD VIBRATO    MIDI: controller number|
  1590. +---------------------------------------------------+
  1591.  
  1592. This is the old vibrato command (previously it was 3). The command 3 is
  1593. automatically converted to 5 when loading old MED songs. The pitch of
  1594. the note is changed between two values, databyte is the depth.
  1595.  
  1596. Example: A#1 J502
  1597.          --- 0507 increasing depth
  1598.          --- 0517 v
  1599.          --- 0527
  1600.          --- 0537
  1601.  
  1602. MIDI: Command 5 in conjunction with command 0 allows you to change any
  1603. controller of MIDI (command $Bx cc vv, where cc = controller number,
  1604. vv = value).
  1605.  
  1606. First you set the number of controller you want to change with command
  1607. 5. Then you can select the value with command 0. Subsequent uses of
  1608. command 0 will affect the controller previously set with command 5.
  1609. Each channel has its own controller number. If the controller value is
  1610. $00, you can't use '00', because the command '000' means 'do nothing'.
  1611. Instead, you type '80'. Acceptable controller numbers and values are
  1612. $00 - $7F.
  1613.  
  1614. For example: (assuming instrument 3 is set to MIDI channel 1)
  1615.         C-2 3000
  1616.         --- 0507 <- controller $07, volume, according to MIDI standard
  1617.         D-2 307F <- set max. volume ($7F), command $B0 $07 $7F is sent
  1618.         --- 0000
  1619.         F-3 3001 <- small volume ($01)
  1620.         --- 055C <- select controller $5C (tremolo depth)
  1621.         G-4 3080 <- set to 0 (note: $80 = $00)
  1622.  
  1623. +---------------------------------------------------+
  1624. | Command 8:  SET HOLD/DECAY MIDI: set hold only    |
  1625. +---------------------------------------------------+
  1626.  
  1627. This command must be located on the same line with a note. The command
  1628. assigns the hold and decay values for the note (see above for description
  1629. about hold/decay).
  1630.  
  1631.                 hold value
  1632. decay----------+|
  1633.                ||
  1634. Example: C-3 3824
  1635.          -|- 3000
  1636.          -|- 3000
  1637.          --- 0000
  1638.  
  1639. +---------------------------------------------------+
  1640. | Command 9:  SEC. TEMPO     MIDI: no action        |
  1641. +---------------------------------------------------+
  1642.  
  1643. This command sets the secondary tempo (the number of timing pulses/note).
  1644. The argument must be 01 - 20.
  1645.  
  1646. Example: --- 0903 <= double tempo
  1647.          --- 0000
  1648.  
  1649. +---------------------------------------------------+
  1650. | Command A:  VOLUME SLIDE   MIDI: polyph aftertouch|
  1651. +---------------------------------------------------+
  1652.  
  1653. This is the same as command D (for Noise/Protracker compatibility).
  1654. However, please use D instead of this. If I some day find that there
  1655. are no free commands, I'll use this!!
  1656.  
  1657. MIDI: Command A changes the polyphonic aftertouch of the most recent note.
  1658. The value should be $00 - $7F.
  1659. Example:
  1660.         C-3 4000
  1661.         --- 0A30 <- aftertouch $30
  1662.         --- 0000
  1663.         --- 0A00 <- aftertouch $00
  1664.  
  1665. +---------------------------------------------------+
  1666. | Command B:  POSITION JUMP  MIDI: position jump    |
  1667. +---------------------------------------------------+
  1668.  
  1669. This command lets you make songs that have beginning which is played
  1670. only once and then some part which is looped forever. Position jump
  1671. causes the jump to playsequence number pointed by the data byte. If the
  1672. data byte is 0, then the playseq jumps to the first entry.
  1673.  
  1674. Example:    --- 0B02 <- start playing from playsequence number 3
  1675.  
  1676. +---------------------------------------------------+
  1677. | Command C:  SET VOLUME     MIDI: set volume       |
  1678. +---------------------------------------------------+
  1679.  
  1680. You can override the default volume of the instrument with this command.
  1681. Example:
  1682.          A-3 4C20 <- played with volume 20
  1683.  
  1684. There are 65 volume levels (0 - 64), 0 = no sound, 64 = maximum. The
  1685. data byte of command C can be 00 - 64 or 00 - 40 (decimal or hex).
  1686. Non-programmers will probably want to use the decimal numbers. See
  1687. (Play/[Dec/Hex]). If you want the playroutine to have maximum performance,
  1688. then use hex values.
  1689.  
  1690. It is also possible to change the volume of already played note. Note
  1691. that it doesn't work with MIDI-instruments.
  1692.  
  1693. Example:
  1694.          A-3 4000
  1695.          --- 0000
  1696.          --- 0C10 <- volume to 10
  1697.  
  1698. It's possible to change the default volume of an instrument (OctaMED V2 and
  1699. later). The value must be between 80 and C0 (always hex!). Value $80 = volume
  1700. 0, and $C0 = 64. Note: This can cause trouble in multi-modules, because the
  1701. set of instruments (and their default volumes) are common. I recommend that
  1702. you change the default volume only on non-multi-modules.
  1703.  
  1704. +---------------------------------------------------+
  1705. | Command D:  VOLUME SLIDE   MIDI: channel pressure |
  1706. +---------------------------------------------------+
  1707.  
  1708. You can increase/decrease volume smoothly with this command. The data
  1709. byte is divided in two parts:
  1710.  
  1711.          C-3 3D01
  1712.                ||
  1713.                |+- Amount of decresdendo
  1714.                +-- Amount of crescendo
  1715.  
  1716. If crescendo is zero, then the decrescendo is performed. Otherwise only
  1717. crescendo is performed.
  1718.  
  1719. Example:
  1720.          C-2 3C40
  1721.          --- 0D01 <- a bit more quiet
  1722.          --- 0D01 <- even more
  1723.          --- 0D20 <- and crescendo back to original
  1724.  
  1725. One unit in these commands means six actual volume units, so this example
  1726. would look like this, when using the C-command (except that it doesn't
  1727. sound so smooth):
  1728.          C-2 3C40 (volumes are decimal in this example)
  1729.          --- 0C34 <- -6
  1730.          --- 0C28 <- -6
  1731.          --- 0C40 <- +12
  1732.  
  1733. MIDI: This command sends a channel pressure (channel aftertouch) message
  1734. using the channel in which the most recent note was sent. The databyte
  1735. should be $00 - $7F.
  1736.          D#5 J000
  1737.          --- 0D40 <- channel aftertouch $40
  1738.          --- 0D00 <- to $00
  1739.  
  1740. +---------------------------------------------------+
  1741. | Command E:  SYNTH/JMP      MIDI: pan control      |
  1742. +---------------------------------------------------+
  1743.  
  1744. When used with synth/hybrid instruments, this command triggers a jump
  1745. in the waveform command sequence. The databyte is the jump destination
  1746. (line number).
  1747.  
  1748. Example: C-4 4000 <- this should be synth/hybrid instrument
  1749.          --- 0000
  1750.          --- 0E05 <- cause a jump to line # 5
  1751.  
  1752. With MIDI-instruments, this command controls the stereo location of the
  1753. sound. The data byte can be 00 - 7F.
  1754.  
  1755.         left           mid            right
  1756.          |              |               |
  1757.         00             3F               7F
  1758.  
  1759. If you've used MED V2.00/V2.01 or Noise/SoundTracker, you may remember
  1760. that this command controlled the low-pass filter. I think that it was
  1761. unnecessary to spend the command E only for controlling only a single
  1762. switch. See command F.
  1763.  
  1764. +---------------------------------------------------+
  1765. | Command F:  TEMPO/MISC.    MIDI: tempo/misc.      |
  1766. +---------------------------------------------------+
  1767.  
  1768. Command F has many different actions depending on the data byte.
  1769.  
  1770. If the data byte is zero (00), this command causes the immediate jumping
  1771. to the next block on the playing sequence (or to the beginning of this
  1772. block if you're only playing the block). This function is better to
  1773. implement by making the block shorter (takes less memory).
  1774.  
  1775. Example:
  1776.          C-2 4F00 <- this is the last note of this block
  1777.  
  1778. When the data byte if 01 - F0, the command changes the tempo. This is the
  1779. primary tempo (length of the pause between timing pulses).
  1780.  
  1781. If the new tempo is 01 - 0A, it is compatible with Trackers, but now you
  1782. should use the command 9 instead of this command, as it's directly
  1783. Tracker-compatible (set the primary tempo to 33).
  1784.  
  1785. Example:
  1786.          E-3 6FF0 <- highest tempo
  1787.          --- 0000
  1788.          --- 0F0B <- slowest
  1789.  
  1790. Data bytes FF1 - FFF are reserved for special actions, some of them
  1791. are currently used:
  1792.  
  1793. FF1 causes the same note played actually twice. This way it's possible
  1794. to create fast rhythms.
  1795.  
  1796.          C-3 2FF1 is same as C-3 2000
  1797.                              C-3 2000 with double tempo
  1798.  
  1799. FF2 plays the note only once, but it is not started immediately:
  1800.  
  1801.          C-3 2FF2 is same as --- 0000
  1802.                              C-3 2000 with double tempo
  1803.  
  1804. FF3 works like FF1 except the note is played three times (very fast).
  1805.  
  1806. FF8 turns off the low-pass filter (power-LED will dim).
  1807.  
  1808. FF9 turns the low-pass filter on (bright LED).
  1809.  
  1810. FFA sends MIDI "hold pedal on"-command (works only with MIDI-instruments).
  1811.  
  1812. FFB sends MIDI "hold pedal off"-command (works only with MIDI-instruments).
  1813.  
  1814. FFD works only with Amiga-samples. It causes the pitch of the channel to
  1815.     be set to the pitch of the new note, but the new note is not replayed.
  1816.  
  1817.          C-1 2000 <- play note
  1818.          --- 0000
  1819.          C-2 2FFD <- don't replay the note, just set the pitch to C-2
  1820.  
  1821. FFE stops playing immediately. If you want to make a song which plays only
  1822.     once, put this command to the end of the song. This command can be
  1823.     easily entered: Click "Stop playing" while holding the Shift-key.
  1824.  
  1825. FFF Stops the note on the current track. Works with both Amiga- and MIDI-
  1826.     instruments. Nearly identical to "C00" on Amiga-samples, but because
  1827.     "C00" doesn't work with MIDI, I made this command.
  1828.  
  1829.  
  1830. +-------------------------------------------------------------------+
  1831. |+-----------------------------------------------------------------+|
  1832. ||           OctaMED V2.00 keyboard equivalents/functions          ||
  1833. |+-----------------------------------------------------------------+|
  1834. +-------------------------------------------------------------------+
  1835.  
  1836.       Cursor up              Cursor up
  1837.       Cursor down            Cursor down
  1838.       Cursor right           Cursor right
  1839.       Cursor left            Cursor left
  1840. -- then a bit more complex ones
  1841.       DEL                    Delete note or number under cursor
  1842.       Shift-DEL              Delete the note and the command numbers
  1843.       Alt-DEL                Delete only the command numbers
  1844.       Backspace              Deletes the note and moves following notes up
  1845.       Shift-Backspace        Inserts an empty note slot
  1846.       Alt-Backspace          Deletes the current track
  1847.       Alt-Shift-Backspace    Inserts a new track
  1848.       Shift-Cursor up        Previous block
  1849.       Shift-Cursor down      Next block
  1850.       Shift-Cursor left      Previous sample
  1851.       Shift-Cursor right     Next sample
  1852.       Left-Alt-Cursor up     First block
  1853.       Left-Alt-Cursor down   Last block
  1854.       Alt-Cursor left        Cursor onto previous track
  1855.       Alt-Cursor right       Cursor onto next track
  1856.       Alt-Shift-Cursor right 16 samples forward
  1857.       Alt-Shift-Cursor left  16 samples backward
  1858.       Ctrl-Cursor left       Previous screenful of tracks
  1859.       Ctrl-Cursor right      Next screenful of tracks
  1860.       Space bar              Stop playing (or delete note if SPC=CLR active)
  1861.       Alt-Space              Continue block
  1862.       Ctrl-Space             Reset MIDI pitchbenders/mod. wheels/presets
  1863.       Shift-Space            Continue song
  1864.       Shift-Alt-Space        Play song
  1865.       Esc                    Editing on/off
  1866.       ~                      Extra space on/off
  1867.       F1 - F4                Select keyboard octaves 1+2 - 4+5.
  1868.       F6                     Cursor to the first line of the block
  1869.       F7                     Cursor to the second quarter of the block
  1870.       F8                     Cursor to the middle of the block
  1871.       F9                     Cursor to the last quarter of the block
  1872.       F10                    Cursor to the last line of the block
  1873.       Ctrl-F1 - F10          Select displayed panel
  1874.       Ctrl-Shift-0 - 9       Pick note 0 - 9
  1875.       Ctrl-A                 Automatic advance down on/off
  1876.       Ctrl-F                 Display free memory
  1877.       Amiga-F                Low-pass filter on/off
  1878.       Amiga-I                Activate sample name gadget.
  1879.       Shift-Amiga-I          Clear and activate sample name gadget
  1880.       Amiga-J                Jumping on/off for this sample
  1881.       Amiga-L                Load song
  1882.       Amiga-P                Play song (Shift-Alt-Space)
  1883.       Amiga-R                Activate repeat gadget (in Sample-panel)
  1884.       Amiga-T                Create slide using command 3 (transform)
  1885.       Amiga-Shift-T          Create slide using command 1 and 2
  1886.       Amiga-X/C/V            Cut/copy/paste current track
  1887.       Amiga-Shift-X/C/V      Cut/copy/paste current block
  1888.       Shift-0 - 9            Enter note 0 - 9
  1889.       TAB                    Highlight current line
  1890.  
  1891. Numeric keypad (the non-shifted operations are described in Edit/pad on/off)
  1892.       Ctrl-8             Scroll the playing sequence list up
  1893.       Ctrl-2             Scroll the playing sequence list down
  1894.       Ctrl-4             Decrease the block number of the psl
  1895.       Ctrl-6             Increase the block number of the psl
  1896.       Ctrl-7             Move to the beginning of the psl (psl = the
  1897.       Ctrl-1             Move to the end of the psl        playing
  1898.       Ctrl-5             Insert this block to the psl      sequence
  1899.       Ctrl-0             Insert number 0 to the psl        list)
  1900.       Ctrl-.             Delete the block number from the psl
  1901.       Alt-8              Scroll samplelist up
  1902.       Alt-2              Scroll samplelist down
  1903.       Alt-9              Scroll samplelist up fast
  1904.       Alt-3              Scroll samplelist down fast
  1905.       Alt-7              Beginning of the samplelist
  1906.       Alt-1              End of the samplelist