home *** CD-ROM | disk | FTP | other *** search
/ Dave Lowe: Latest Version…itors Megaman XInfo File / Lowe_LatestVersionsOfMusicEditors_MegamanXInfoFile.img / BACKUP.ZIP / SNES / MANUALSN.DOC < prev   
Encoding:
Text File  |  1994-11-04  |  25.6 KB  |  727 lines

  1. ******************************************************************************
  2.                   SUPER N.E.S. EDITOR Version 4.6
  3. ******************************************************************************
  4.  
  5. NEW FEATURES IN THIS VERSION
  6.  
  7. 4.6  Release date 31/10/94
  8. --------------------------
  9. 4. Auto parallel port detection of comms. board (allows you to use any of LPT1
  10. 2 or 3). If comms. board is found the port number is displayed on screen.
  11.  
  12. 5. Bug causing editor screen to appear blank if entered from Windows in
  13. windowed mode cured.
  14.  
  15. 3. Some minor improvements to screen layout to bring all editors into line.
  16.  
  17.  
  18.  
  19.  
  20. 4.5  Release date 31/08/94
  21. --------------------------
  22. 1. New command 'I' (Info toggle) toggles between note names (useful with
  23. music) and note value (more useful with effects).
  24.  
  25. 2. 'Play' indicator now in hex as well as decimal.
  26.  
  27. 3. Filename for load/save no longer corrupted after a 'Find'.
  28.  
  29. 4. All downloads to console now verified. Single byte edits are still sent to
  30. the console immediately, but any block edits (C/R/A/ALT A/ALT C/ALT E) are
  31. only updated on the PC. When the next 'Play' command is sent, the console is
  32. updated and the new data verified. This ensures:
  33. a) On-screen editing is always as quick as possible.
  34. b) The data is only sent and verified when next needed. If your ESYS has any
  35. problems downloading you will know straight away (normally you can just try
  36. downloading straight away unless a hardware problem has occurred).
  37.  
  38. 6. Keyboard repeat speed forced to maximum for quick movement while editing.
  39.  
  40.  
  41.  
  42.  
  43. 4.4  Release date 22/02/94
  44. --------------------------
  45. 1. 'ALT X' added to convert SNES format .SND file to MEGADRIVE format.
  46. Procedure is:a) Alt L to load in SNES file b) Alt X to convert c)Alt S to Save
  47. (use NEW filename to avoid writing over SNES file).
  48.  
  49.  
  50.  
  51.  
  52. 4.3 Release date 20/12/93
  53. -------------------------
  54. 1. Editor 'ch0 tmp glb' display
  55.  
  56. 2. Append shows error if no SUB or TRK end found to append to.
  57.  
  58. 3. Malibu bug fix.
  59.  
  60. 4. Digit checks for time signature/ banks etc. e.g. previous entry of 4/4 time
  61. was 0004/0004, new entry can be 4/4 or 04/04.
  62.  
  63. 5. 'ALT F' FIND added /'ALT N' NEXT added. These commands work with either 1 or
  64. 2 byte entries e.g. 80 will find all voice commands/ 8005 will find all VOICE
  65. 05 occurrences (Previous ALT F - Full size command changed removed).
  66.  
  67. 6. 'CTRL HOME' and 'CTRL END' added to move to start/end of current column
  68. data.
  69.  
  70.  
  71.  
  72.  
  73. 4.2 Release date 10/11/93
  74. -------------------------
  75. 1. 'END' keyboard command added to move instantly to end of current column.
  76.  
  77. 2. Maximum expanded size of SUBs and TRKs increased to 128 bytes for more
  78. flexibility.
  79.  
  80. 3. Globoffset for individual channels reset to 0 with each new call.
  81.  
  82. 4. Detune now works properly with BEND.
  83.  
  84. 5. External clock now also indicates status of music (stopped/started).
  85.  
  86. 6. Info_Mode command added for programmers to test status of each channel.
  87.  
  88. 7. Fixed special ($80) added to voices. When on this ignores GLOBOFFSET and
  89. CHANOFFSET, and is very useful when transposing sections of music - set it on
  90. all drum voices and they will stay at the correct pitch whilst the tonal
  91. voices transpose correctly.
  92.  
  93. 8. Start of Musicdata moved from $1200 to $1300 to make room for new features.
  94.  
  95. 9. BEND replaces previous bend commands for clarity. Bend is now only for the
  96. duration of a single note - it no longer needs a BEND OFF after each note.
  97.  
  98. 10. CHANFADE is now cancelled by a subsequent CHANVOL.
  99.  
  100. 11. TRACK LINK added to tracks. Example 'FD,01' at the end of a track will
  101. link to track 1. This can be used to link modules of music, or automatically
  102. return to a main piece of music after a jingle.
  103.  
  104. 12. CALL LINK added to tracks. Example 'FC,01' at the end of a track will
  105. start call 1. This can be used to write music in self-contained sections, each
  106. calling the next.
  107.  
  108. 13. TRK0call can be read by programmers externally. The currently playing CALL
  109. in channel 0 can be used with CALL LINK so that the current section of music
  110. can be read by the programmer - this can be used as an intelligent pause mode
  111. - read the current section before stopping the music and then use this CALL
  112. number to restart the music from the beginning of the same section.
  113.  
  114. 14. GLB FADE replaces FADE ALL. This now allows a fade in multiple channels
  115. without affecting sound effect volumes in other channels.
  116.  
  117. 15. Channel MUTE added in editor on keys F1 to F8.
  118.  
  119.  
  120.  
  121.  
  122. 4.1 Release date 26/08/93
  123. -------------------------
  124. 1. Global clock added for realtime readout from SNES
  125.  
  126. 2. Global Offset readout in editor
  127.  
  128.  
  129.  
  130.  
  131. 4.0 Release date 18/05/93
  132.  
  133. 1.  SETPAN CANCELS AUTOPAN (previously a new SETPAN was ignored with AUTOPAN
  134.     on).
  135.  
  136. 2.  NEW .SND FILE FORMAT WITH BANK ADDRESSES INSIDE MUSIC DATA. The driver now
  137.     reads all addresses from inside the data file, so that no changes ever
  138.     need to be made to the driver source code (D-SNES27.ASM identical for each
  139.     project).
  140.  
  141. 3.  A NEW SUB RESETS RANDOFFSET AND RAND DUR (previously these always had to
  142.     be cancelled by hand).
  143.  
  144. 4.  NEW OPCODE GLB VOL ($9D) ADDED. Enables easy master volume changes for
  145.     all selected channels. This was introduced primarily for the setup SUB
  146.     used at the start of a piece of music, to aid level balancing of all music
  147.     channels against effects.
  148.  
  149. 5.  PLAY LIMITS CHECKED AGAINST CALL. Using '[' and ']' now only allows
  150.     settings within the current range of CALL. Using 'P' to play is very
  151.     useful when trying out two different calls - set up P to play the first
  152.     and use Return in the normal way for the second.
  153.  
  154. 6.  ALT M (MASK) REMOVED. This is no longer needed now that masks (.SND,.IFF)
  155.     are automatically provided by the editor.
  156.  
  157. 7.  ALT B ADDED TO ALLOW ENTRY OF NEW BANK ADDRESSES.
  158.  
  159. 8.  NEW VOICENUM RESETS LEGATO (previously this needed to be reset by hand,but
  160.     it is most likely that any different voice setting will need LEGATO to be
  161.     cancelled).
  162.  
  163. 9.  WARNING IF ALTERED DATA BEFORE NEW LOAD OR ESCape (this reduces the risk of
  164.     losing new data by loading something else over the top before saving it).
  165.  
  166. 10. COMPRESSION CHECKS FOR BLANK SUB. A warning box will appear if any SUB is
  167.     found during compression which is completely blank. Normally compression
  168.     stops at this point and discards any higher SUBS, assuming that the
  169.     highest SUB has already been found, but in many cases this may not be true
  170.     - you have the safer option of including the blank SUB (answer 'Y'), or
  171.     finishing at this point and discarding all higher SUBs (answer 'N').
  172.  
  173. 11. COMPRESSION CHECKS FOR EXTRA DATA IN TRKs. A warning box will appear if
  174.     any TRK is found with additional non-zero bytes after the end ($FF or $FE)
  175.     is found. This might be temporary alternate arrangements which you wish to
  176.     keep for the time being. You have the option of inluding the extra data
  177.     (answer 'Y') or stripping it off the final version when no longer needed
  178.     (answer 'N').
  179.  
  180. 12. LOOP TIMER DOUBLED TO 4mS - This cures 'slowing' of fast bends when many
  181.     channels are in operation simultaneously.
  182.  
  183. 13. OVER-RUN CHECKS FOR MUSIC DATA. A check is made every time the music data
  184.     grows in size to make sure it doesn't corrupt BANK1 samples. If corruption
  185.     would occur, Download is automatically switched off and the user alerted.
  186.     This avoids having to exit the editor and re-send the corrupted samples.
  187.  
  188. 14. 'INSTANT' SCREEN UPDATES BYPASSING BIOS.
  189.  
  190. 15. GENERAL SCREEN UPDATES - real time clock added, better on-screen layout &
  191.     colours.
  192.  
  193. 16. CALLclock ADDED - An internal tick timer which can be read externally
  194.     using the $85 command. It keeps a running total of ticks at the current
  195.     global tempo whenever there is any channel active.
  196.  
  197. 17. ALT T ADDED TO ALLOW ENTRY OF TIME SIGNATURES.
  198.  
  199.  
  200.  
  201.  
  202. 3.3 Release date 10/03/93
  203. -------------------------
  204. Occasional restart clicks removed.
  205. LEGATO opcode ($84) added for extra long sounds.
  206. RAND_DUR moved to opcode $9C.
  207. Bug with $FF duration sounds over 2 seconds cured.
  208. All edit functions downloaded, including Expand (ALT E) and Add (ALT A).
  209. (Edited data is now ALWAYS the same as SONY data unless download is off).
  210.  
  211.  
  212. 3.2 Release date 09/03/93
  213. -------------------------
  214. Anti Crash built-in if you try to use non-existing opcodes.
  215. RAND DUR and RANDNOTE opcodes added.
  216. $80 and $40 bits of PAN set inverted phase for left and right channels.
  217. New pan values $00=left/$0C=centre/$18=right
  218. Feedback from SONY running on PC screen.
  219. Global TEMPO readout on PC screen.
  220. Priority with $80 bit set calls SUB directly.
  221. New CALL editor reads out TRK or SUB depending on priority settings.
  222. Current column limits checked for every Load, and zeroed if invalid.
  223.  
  224.  
  225. 3.1 Release date 26/02/93
  226. -------------------------
  227. Bug only loading maximum of 10,000 bytes of .IFF sample cured.
  228. Alt O switches download On/Off for extensive editing.
  229. Alt F expands all SUB/TRKs to Full size.
  230.  
  231.  
  232. 3.0 Release date 19/02/93
  233. -------------------------
  234. The current SONY end address is constantly updated.
  235. Up/down cursor limits are checked for all lengths of SUB and TRK.
  236. Compression now has extra checks and aborts with an error if the data is
  237. strange e.g. SUB 00 is blank.
  238. File size is shown at bottom right of screen in decimal bytes.
  239. Alt C can now be used as many times as needed to re-compress a file.
  240. Alt I is the changed command for IFF format conversion.
  241. Alt A now adds a column at the cursor position.
  242. Alt E now expands a compressed SUB or TRK column to full size (96 steps).
  243. SONY headers added to musicdata by Editor (SNMUSIC.ASM is now redundant).
  244. Backspace and Escape now work in filename entry.
  245.  
  246.  
  247. 2.1 Release date 11/02/93
  248. -------------------------
  249. Up to 128 samples allowed (see VOICENUM for details)
  250. More reliable PC edit downloads.
  251.  
  252.  
  253. 2.0 Release date 09/02/93
  254. -------------------------
  255. $83 downbyte sound call added.
  256. Interactive PC editor and crash-free download fully functional.
  257. SETGATE added to opcodes.
  258. '80' bit no longer needed for voice atkdec ($8F/$E0 can be $0F/$E0).
  259. Sample end duration added.
  260. Key Off clicks removed (this gives an 8mS response time to new calls).
  261.  
  262.  
  263. 1.5 Release date 05/02/93
  264. -------------------------
  265. Maximum Conversion error reduced from 6% to 3%.
  266. Maximum size of IFF samples now decreased to 24000 bytes.
  267. Rest added/opcodes reorganised.
  268. Hanging notes bug cured.
  269. Hardware reset bug removed.
  270. Voice detune added (added to current channel DETUNE).
  271. Two Filter  coefficients only.
  272. Modified sample format (use .SNS extender instead of .NES).
  273. Editor will compress any file size.
  274. Shuffled driver.
  275.  
  276.  
  277. 1.4 Release date 22/01/93
  278. -------------------------
  279. Mastervol now defaults to $A0 and is reset with every sound call.
  280. Channels now stop singly without stopping everything.
  281. Bug if Track loops at beginning cured.
  282. SNES 'Y' button now fades sound calls.
  283. 'Shift -' now works in editor.
  284. All 'Off' commands now need a second zero byte e.g. TREMOFF,0
  285. Verify removed from SNES download for greatly increased speed.
  286. AUTOPAN has new format and AUTPANOF has been removed.
  287. Bug in SUB calls over $7F cured.
  288. SUB loop and stop removed.
  289.  
  290.  
  291. 1.3 Release date 21/01/93
  292. -------------------------
  293. SUB limit increased to 160.
  294. Maximum size of IFF samples now decreased to 15000 bytes.
  295. SUB commands with 3 parameters now decode correctly with no rogue notes.
  296. Insert,Delete,Append,Play no longer send data to the SNES causing a crash.
  297.  
  298.  
  299. 1.2 Release date 20/01/93
  300. -------------------------
  301. File Compression routine implemented.
  302. Track looping added.
  303.  
  304.  
  305. 1.1 Release date 20/01/93
  306. -------------------------
  307. Basic Download to SNES added.
  308. Maximum size of IFF samples now increased to 17000 bytes.
  309.  
  310.  
  311. 1.0 Release date 18/12/92
  312. -------------------------
  313. Initial release for IFF sample file conversion only.
  314.  
  315.  
  316.  
  317.  
  318. FUNCTIONS
  319.  
  320. ESC              Escape from disk operation or editor
  321. Alt A            Add a column at the cursor position
  322. Alt B            Bank Address (1 then 2)
  323. Alt C            Compress a music file
  324. Alt D            Download current music file
  325. Alt E            Expand a compressed column to full size
  326. Alt F            Find a hex byte
  327. Alt I            IFF format conversion to SNES format
  328. Alt L            Load a music file
  329. Alt N            find Next matching hex byte
  330. Alt O            Download ON/OFF
  331. Alt S            Save a music file
  332. Alt T            Time signature (e.g. 0006/0008 for 6/8)
  333. Alt X            convert SNES to MEGADRIVE .SND format
  334. F1-F8            Toggle channel Mute
  335. Return/Enter     Play current music track
  336. Spacebar         Stop all music/effects
  337. F                Fade music
  338. I                Info switch (toggle between note number/ value display
  339. K                Keymode (toggle between sharps and flats)
  340.  
  341.  
  342. MOVEMENT
  343.  
  344. Home             Move cursor to top of column
  345. Ctrl Home        Move cursor to beginning of column data
  346. End              Move cursor to bottom of column
  347. Ctrl End         Move cursor to end of column data
  348. Right & Left     Change edit column
  349. Up & Page Up     Move cursor up
  350. Down & Page Down Move cursor down
  351.  
  352. + & Shift +      Channel up
  353. - & Shift -      Channel down
  354.  
  355. [ & ]            Play up/down
  356. P                Play (using setting above)
  357.  
  358.  
  359. EDITING
  360.  
  361. < & >            Up/Down current parameter
  362. Keypad *         Zero current parameter
  363.  
  364. D                Down 1 octave for current parameter
  365. U                Up 1 octave for current parameter
  366. 1/2/4/8          Bitflip current parameter
  367.  
  368. Insert           Insert a byte at current cursor position
  369. Delete           Delete a byte at current cursor position
  370.  
  371.  
  372. BLOCK
  373.  
  374. C                Copy current column into buffer
  375. R                Replace current column with buffer
  376. A                Append buffer to current column
  377.  
  378.  
  379.  
  380. ------------------------------------------------------------------------------
  381. DEMO FUNCTIONS
  382.  
  383. To help test the music files, a file named 'SNESMUS.ROM' may be supplied.
  384. You can download this to the SNES for a demo of the music and effets.
  385. The joypad keys to use are as follows:
  386.  
  387. UP/DOWN          Increment/Decrement current call number.
  388. SELECT           Stop all sound calls.
  389. START            Start music/effect.
  390. Y                Fades all sound calls.
  391.  
  392.  
  393.  
  394. VOICE PARAMETERS (VCE)
  395.  
  396. atkdec           Decay=$00 (1.2S) to $70 (37mS)
  397.                  Attack=$00 (4.1S) to $0F (0mS)
  398.                  e.g. $0F = Use ADSR with Attack=0mS/Decay=1.2S
  399.  
  400. susrel           Sustain=$00,$20,$40,$60,$80,$A0,$C0,$E0 (1/8 to Full)
  401.                  Release=$00 (Infinite) to $1F (18mS)
  402.                  e.g. $F5 = Sustain full (100%)/Release 14S
  403.  
  404. level            $00-$FF balancing level for this voice
  405.  
  406. sample           $00 uses a preset 1 cycle sinewave loop
  407.                  $01-$3F use the sounds from BANK1.ASM
  408.                  $40-$7F use the sounds from BANK2.ASM
  409.                  $80-$9F use the inbuilt SNES noise with freq. $00-$1F
  410.  
  411. offset           signed Offset to note (e.g. $0C=up 1 octave/$FF=down 1 note)
  412.  
  413. detune           $00-$FF ($00=no detune/$FF=1 semitone up default=$00)
  414.  
  415.  
  416. specls           $80 Fixed (unaffected by global offsets e.g. for drums)
  417.  
  418. vspeed           Vibrato speed.
  419.  
  420. vdepth           Vibrato depth.
  421.  
  422. vdelay           Vibrato delay $00-$FF (in frames)
  423.  
  424.  
  425.  
  426.  
  427. SUBROUTINE PARAMETERS (SUB)
  428.  
  429. NAME             NO.      PARAMETERS
  430. ------------------------------------------------------------------------------
  431. note             $00-$6B  ,duration ($00-$7F or $FF)
  432.                  $3C = C3 = middle C
  433.                  duration = $FF waits for the sample to end (non-looping only)
  434.  
  435.                  A duration value of $FF will wait for the end of the sample
  436.                  before continuing to the next step of a subroutine. This is
  437.                  extremely useful with single-shot sound effects, since it
  438.                  avoids having to experiment with a duration dependent on
  439.                  pitch. However, since a normal 'note off' must take place to
  440.                  end the sound, there will be an 8mS delay before the next
  441.                  sound can start.
  442.  
  443.  
  444. VOICENUM         $80      ,number
  445.  
  446.                  The number is:
  447.                  $00-$3F  (BANK1 samples)
  448.                  $40-$7F  (BANK2 samples)
  449.                  $80-$9F  (NOISE freq $00-$1F)
  450.  
  451.  
  452. REST             $81      ,duration ($00-$7F)
  453.  
  454.  
  455. CHNTEMPO         $82      ,tempo ($01-$FF default=$FF)
  456.  
  457.  
  458. GLBTEMPO         $83      ,channelbits,tempo,dummy ($01-$FF default=$FF)
  459.  
  460.                  Sets the channel tempo of all associated channels. This is
  461.                  the value shown as TEMPO on the PC screen.
  462.  
  463.  
  464. LEGATO           $84      ,switch (Off=$00/On=$01 default=OFF)
  465.  
  466.                  Defaults to OFF whenever a new CALL is started. The first
  467.                  note following a LEGATO ON will start normally, but it will
  468.                  not be gated off at the end. Subsequent notes will continue
  469.                  without a new envelope being triggered. This mode continues
  470.                  until a LEGATO OFF command is issued.
  471.  
  472.  
  473. SETGATE          $85      ,notelength (default=$FF)
  474.  
  475.                  At the end of the gated duration a note off is sent. This
  476.                  allows staccato notes to be produced. The default value of
  477.                  $FF is reset at the beginning of each new subroutine.
  478.  
  479.  
  480. SETPAN           $86      ,position (default=$0C)
  481.                  $00 = Left
  482.                  $0C = Centre
  483.                  $18 = Right
  484.                  $80 = Inverted Left phase
  485.                  $40 = Inverted Right phase
  486.  
  487.                  Sets the position of the sound in the current channel between
  488.                  the two speakers. All Pan positions default to $0C (centre)
  489.                  whenever a new call is started. Pan is altered by SETPAN,
  490.                  PANSLIDE and AUTOPAN only, so only 1 SETPAN need be issued
  491.                  for each channel - new subroutines will continue with the
  492.                  existing value. SETPAN cancels AUTOPAN.
  493.  
  494.  
  495. PANSLIDE         $87      ,speed,final position,dummy
  496.  
  497.                  Moves the position of the sound in the current channel
  498.                  between the current position and the desired final position
  499.                  at the desired speed.
  500.  
  501.  
  502. AUTO PAN         $88      ,switch (Off=$00/On=$01 default=OFF)
  503.  
  504.                  Sets a random position between the speakers for each
  505.                  subsequent note when the switch = 1. A value of 0 cancels
  506.                  AUTO PAN. The final pan position is maintained for all
  507.                  subsequent notes until a new SETPAN or AUTO PAN command is
  508.                  encountered. AUTO PAN is cancelled by SETPAN.
  509.  
  510.  
  511.  
  512. DETUNE           $89      ,value
  513.  
  514.                  All following notes in the channel have a fractional pitch
  515.                  added to anyvoice detune.$00 is no detune/$FF is the maximum
  516.                  setting of 1 full semitone up.
  517.  
  518.  
  519. CHNOFFST         $8A      ,transpose
  520.  
  521.                  Acts similarly to the GLOBOFFS command, but on the current
  522.                  channel only. Channel offsets are independent, and
  523.                  can be used in tandem with a global offset.
  524.  
  525.  
  526. GLBOFFST         $8B      ,channelbits,transpose,dummy (default=$00)
  527.  
  528.                  Adds ($00-$7F) or subtracts ($FF-$80) the transpose setting
  529.                  to all subsequent notes in all associated channels. It is
  530.                  reset to zero on starting any new piece of music, or by
  531.                  resetting the sound driver using the external command INIT
  532.                  (See SNES.DOC).
  533.  
  534.  
  535. CHANVOL          $8C      ,volume ($00-$FF default=$FF)
  536.  
  537.                  CHANVOL defaults to $FF when a new call is started, and
  538.                  affects all subsequent notes until another  CHANVOL command
  539.                  is issued.
  540.  
  541.  
  542. TREMOLO          $8D      ,speed,depth,delay
  543.  
  544.  
  545. TREMOFF          $8E      ,dummy
  546.  
  547.  
  548.  
  549. VIBRATO          $8F      ,speed,depth,delay
  550.  
  551.                  Starts a vibrato with the desired settings in the current
  552.                  channel, replacing any existing values set by VOICENUM. All
  553.                  subsequent notes will have these settings until another
  554.                  VOICENUM, VIBRATO or VIBOFF command is issued.
  555.  
  556.  
  557. VIBSWELL         $90      ,spread
  558.  
  559.                  After the Vibrato delay, this sets the time during which
  560.                  the vibrato amplitude builds up gradually to its setting.
  561.  
  562.  
  563. VIBOFF           $91      ,dummy
  564.  
  565.  
  566.  
  567. BEND             $92      ,speed,to interval,delay
  568.  
  569.                  Starting from the next note, the pitch will bend up (interval
  570.                  $00-$7F) or down (interval $FF-$80) from the note value to
  571.                  the interval.
  572.  
  573.  
  574. BEND OFF         $94      ,dummy
  575.  
  576.                  All Bend settings are cancelled.
  577.  
  578.  
  579.  
  580. ECHOTYPE         $95      ,delay($00-$0C),filter ($00-$01),feedback($00-$7F)
  581.  
  582.                  This sets the 'sound' of echo. The echo system uses a portion
  583.                  of sound memory as a buffer. The amount used depends on the
  584.                  delay setting as detailed below:
  585.  
  586.                  Setting   Time     Memory Used  Address
  587.                  0           0mS    4 bytes      $FF00-$FF03
  588.                  1          16mS    2K           $F700-$FEFF
  589.                  2          32mS    4K           $EF00   "
  590.                  3          48mS    6K           $E700
  591.                  4          64mS    8K           $DF00
  592.                  5          80mS    10K          $D700
  593.                  6          96mS    12K          $CF00
  594.                  7         112mS    14K          $C700
  595.                  8         128mS    16K          $BF00
  596.                  9         144mS    18K          $B700
  597.                  A         160mS    20K          $AF00
  598.                  B         176mS    22K          $A700
  599.                  C         192mS    24K          $9F00
  600.                  D         208mS    26K          $9700
  601.                  E         224mS    28K          $8F00
  602.                  F         240mS    30K          $8700 maximum allowable
  603.  
  604.                  The feedback setting determines the amount of delayed sound
  605.                  returned to the input, and hence the decay time. $FF is 100%
  606.                  feedback which will continue indefinitely. Filter sets the
  607.                  equalisation of the feedback path. There are currently two
  608.                  preset settings ($00-$01) which are:
  609.                  0        No EQ (flat)
  610.                  1        Low Pass Filter
  611.  
  612.  
  613. ECHOCHAN         $96      ,channelbits,Rlevel,Llevel ($00-$7F)
  614.  
  615.                  'channelbits' determines which of the 8 channels will have
  616.                  echo. The second and third parameters set the master echo
  617.                  volumes for each speaker.
  618.  
  619.  
  620. ECHO OFF         $97      ,0 (default=off)
  621.  
  622.                  The volumes of both left and right Echo channels are reset
  623.                  to zero.
  624.  
  625.  
  626.  
  627. ECHOFADE         $98      ,speed,vol_L,vol_R ($00-$7F)
  628.  
  629.                  This works similarly to CHANFADE, but controls the volume
  630.                  of both echo channels (left & right) simultaneously.
  631.  
  632.  
  633. CHANFADE         $99      ,speed,final volume,dummy
  634.  
  635.  
  636. GLB FADE         $9A      ,channelbits,speed,final volume
  637.  
  638.                  Starts a fade of CHANVOL in all specified channels.
  639.  
  640.  
  641. RANDNOTE         $9B      ,and mask ($00-$FF default=$00=Off)
  642.  
  643.                  All following note pairs will have a random offset added to
  644.                  the normal note with a value set by the and mask. The default
  645.                  value of $00 is reset at the beginning of each new
  646.                  subroutine.
  647.  
  648.  
  649. RAND DUR         $9C      ,and mask ($00-$FF default=$00=Off)
  650.  
  651.                  All following note pairs will have a random duration added to
  652.                  the normal duration with a value set by the and mask.
  653.                  e.g. mask=$07 random added = 0,1,2,3,4,5,6 or 7
  654.                       mask=$04 random added = 0 or 4 ('4' bit randomly set)
  655.                  The defualt value of $00 is reset at the start of each new
  656.                  subroutine.
  657.  
  658.  
  659. GLB VOL          $9D      ,channelbits,volume,dummy ($00-$FF default=$FF)
  660.  
  661.                  Sets a master volume for each associated channel, from $FF
  662.                  (full) to $00 (off). This is useful for balancing music
  663.                  levels against effects without altering the music balance.
  664.  
  665.  
  666. END              $FF
  667.                  Indicates the final byte of a subroutine.
  668.  
  669.  
  670.  
  671.  
  672. TRK PARAMETERS
  673.  
  674. BYTE 1              BYTE 2              DETAILS
  675.  
  676. 00-3F no. of times  00-7F sequence no.  normal subroutine pair
  677.  
  678.  
  679. 40    loop end      -                   use only after loop start
  680.  
  681.  
  682. 41-7F loop start    -                   e.g. 46 = loop 6 times
  683.  
  684.  
  685. FC    call          00-FE call no.      start this call next
  686.  
  687.  
  688. FD    link          00-7F track no.     link to this track next
  689.  
  690.  
  691. FE    end           00    (dummy)       end in this channel
  692.  
  693.  
  694. FF    loop channel  00-7F loop point    loop channel to any step
  695.                                         e.g. FF/02=loop to step 02
  696.  
  697.  
  698.  
  699.  
  700. CALL PARAMETERS
  701.  
  702. prior            priority setting $00 (highest) to $7F (lowest)
  703.                  bit 7 set ($80) forces direct call to SUB
  704.  
  705. 0-7              TRK used in this channel (prior less than $80)
  706.                  SUB used by this channel (prior greater than $80)
  707.  
  708.  
  709.  
  710.  
  711. NOTE VALUES
  712.  
  713. NAME             NORMAL         DOTTED         DOUBLE DOT     TRIPLET
  714.  
  715. Semibreve        30h            48h            54h            20h
  716.  
  717. Minim            18h            24h            2Ah            10h
  718.  
  719. Crotchet         0Ch            12h            15h            08h
  720.  
  721. Quaver           06h            09h            -              04h
  722.  
  723. Semiquaver       03h            -              -              02h
  724.  
  725. Demisemiquaver   2/2/1/1        -              -              01h
  726.  
  727.