home *** CD-ROM | disk | FTP | other *** search
/ Dave Lowe: Latest Version…itors Megaman XInfo File / Lowe_LatestVersionsOfMusicEditors_MegamanXInfoFile.img / GEAR / MANUALGG.DOC < prev    next >
Encoding:
Text File  |  1994-11-04  |  10.5 KB  |  369 lines
  1. ******************************************************************************
  2.                   SEGA GAMEGEAR EDITOR Version 3.0
  3. ******************************************************************************
  4.  
  5. NEW FEATURES IN THIS VERSION
  6.  
  7. 3.0  Release date 31/10/94
  8. --------------------------
  9. 1. Update to 'tiny' format version to bring into line with Gameboy
  10. improvements.
  11.  
  12. 2. Bug causing clock to start after ALT L cured.
  13.  
  14. 3. 'ALT X' added to convert GAMEGEAR format .SND file to GAMEBOY format.
  15. Procedure is:a) Alt L to load in GAMEGEAR file b) Alt X to convert c)Alt S to
  16. Save (use NEW filename to avoid writing over GAMEGEAR file).
  17.  
  18. 4. Auto parallel port detection of comms. board (allows you to use any of LPT1
  19. 2 or 3). If comms. board is found the port number is displayed on screen.
  20.  
  21. 5. Bug causing editor screen to appear blank if entered from Windows in
  22. windowed mode cured.
  23.  
  24. 6. Bug causing 'half' switching to malfunction after using copy or replace
  25. while simultaneously playing back cured.
  26.  
  27. 7. Drumbend voice special added ($40). Note1 value gives amount & direction.
  28.  
  29. 8. Master sytem version removed so that Gameboy/ Gamegear both run at 60Hz.
  30. (programmer's document GEAR30.DOC has references to Master system removed).
  31.  
  32.  
  33.  
  34.  
  35. ------------------------------------------------------------------------------
  36. FUNCTIONS
  37.  
  38. ESC               Escape from editor ('no' option re-initialises ESYS)
  39. Alt A             Add a column at the cursor position
  40. Alt C             Compress a music file
  41. Alt D             Download current music file
  42. Alt E             Expand a compressed column to full size
  43. Alt F             Find 1 or 2 hex bytes
  44. Alt L             Load a music file
  45. Alt N             find Next matching hex byte
  46. Alt O             download On/Off
  47. Alt S             Save a music file
  48. Alt T             Time signature (e.g. 0006/0008 for 6/8)
  49. Alt X             convert GameGear to GameBoy .SND format
  50. Return/Enter      Play current music track
  51. Spacebar          Stop all music/effects
  52. F                 Fade music (uses value 84h)
  53. H                 Half switching (toggle between parameter/envelope)
  54. I                 Info switch (toggle between note name/ note value display
  55. K                 Keymode (toggle between sharps and flats)
  56. S                 Play current SFX effect (use when editing a single sound)
  57. T                 play current TAB effect (for channel allocated sounds)
  58.  
  59.  
  60. MOVEMENT
  61.  
  62. Home              Move cursor to top of column
  63. Ctrl Home         Move cursor to beginning of column data
  64. End               Move cursor to bottom of column
  65. Ctrl End          Move cursor to end of column data
  66. Right & Left      Change edit column
  67. Up & Page Up      Move cursor up
  68. Down & Page Down  Move cursor down
  69.  
  70. + & Shift +       Channel up
  71. - & Shift -       Channel down
  72.  
  73. [ & ]             Play up/down
  74. P                 Play (using setting above)
  75.  
  76.  
  77. EDITING
  78.  
  79. < & >             Up/Down current parameter
  80. Keypad *          Zero current parameter
  81.  
  82. D                 Down 1 octave for current parameter
  83. U                 Up 1 octave for current parameter
  84. 1/2/4/8           Bitflip current parameter
  85.  
  86. Insert            Insert a byte at current cursor position
  87. Delete            Delete a byte at current cursor position
  88.  
  89.  
  90. BLOCK
  91.  
  92. C                 Copy current column into buffer
  93. R                 Replace current column with buffer
  94. A                 Append buffer to current column
  95.  
  96.  
  97.  
  98.  
  99. GAMEGEAR FUNCTIONS
  100.  
  101. To help test the music files, several keys have been set up on the Gameboy,
  102. as follows:
  103.  
  104. UP/DOWN           Increment/Decrement current call number.
  105. LEFT/RIGHT        Stop all sound/Re-Initialise sound driver
  106. 1                 Start music.
  107. 2                 Start effect.
  108.  
  109.  
  110.  
  111.  
  112. SOUND EFFECT PARAMETERS (SFX)
  113.  
  114. atkwve            Attack waveform 00-03     (see waveform table)
  115.  
  116. endwve            Sustain waveform 00-03    (see waveform table)
  117.  
  118. atkcnt            length of atkwve portion
  119.  
  120. endcnt            length of endwve portion (FF=continuous)
  121.  
  122. freqhi            High byte of start frequency (00-FF only 00-07 used)
  123.  
  124. freqlo            Low byte of start frequency (00-FF)
  125.  
  126. nsefreq           type of noise 00-07
  127.  
  128. bend              Bend type 00-09 (see below)
  129.  
  130. bendhi            High byte of bend
  131.  
  132. bendlo            Low byte of bend
  133.  
  134. specls            Specials (see below)
  135.  
  136. newcnt            Extra counter used by specials (see below)
  137.  
  138. newfhi            Extra freqhi used by specials (see below)
  139.  
  140. newflo            Extra freqlo used by specials (see below)
  141.  
  142.  
  143. ENVELOPE PARAMETERS (Use H to toggle between parameter/envelope)
  144.  
  145. frames            number of frames between each count (01-7F)
  146.                   80 = end of envelope (hold at final level)
  147.                   C0/C4/C8/CC loop back to stage 1,2,3,4 etc.
  148.  
  149. stpval            signed change to envelope level (e.g. FF = -1)
  150.  
  151. number            number of these steps before moving to next stage
  152.  
  153.  
  154.  
  155. EFFECT SPECIALS
  156.  
  157. 01                Swap bytes (freqhi/freqlo swapped every frame)
  158.  
  159. 02                Complex Hi (freqhi - bendhi/ eor with newfhi)
  160.  
  161. 04                Waver hi   (adds small random to freqlo every frame)
  162.  
  163. 08                Reload     (freqhi reloaded with newfhi after each newcnt)
  164.  
  165. 10                Swap nibbles (freqlo nibbles swapped every frame)
  166.  
  167. 20                Complex Lo (freqlo - bendlo/ eor with newflo)
  168.  
  169. 40                Waver lo   (adds tiny random to freqlo every frame)
  170.  
  171. 80                Fixed      (unaffected by global offsets e.g. for drums)
  172.  
  173.  
  174. EFFECT BEND TABLE
  175.  
  176. 00                No bend
  177. 01                Up
  178. 02                Down
  179. 03                Up start              (only during atkcnt)
  180. 04                Down start
  181. 05                Up/down               (up during atkcnt/down during endcnt)
  182. 06                Down/up
  183. 07                Up release            (only during endcnt)
  184. 08                Down release
  185. 09                Up/down cycle         (changes direction every newcnt)
  186.  
  187.  
  188. EFFECT TABLE PARAMETERS (TAB)
  189.  
  190. prior             priority 0 (highest) to FF (lowest)
  191.  
  192. chan0             sfx to be called in channel 0 (FF=unused)
  193.  
  194. chan1             sfx to be called in channel 1 (FF=unused)
  195.  
  196. chan2             sfx to be called in channel 2 (FF=unused)
  197.  
  198.  
  199. MUSIC VOICE PARAMETERS (VCE)
  200.  
  201. wvefrm            Waveform (see waveform table)
  202.  
  203. nsefreq           type of noise 00-07
  204.  
  205. specls            Specials (see voice specials)
  206.  
  207. drmdec            Bend down value used by 04 special
  208.  
  209. offset            signed Offset to note (e.g. 0C=up 1 octave/FF=down 1 note)
  210.  
  211. atkcnt            Attack count 00-03
  212.  
  213. atkwve            Attack wave (see waveform table)
  214.  
  215. note 1/2/3/4      Used by chord/atkwave/atknote specials
  216.  
  217. trills            Used by trill special
  218.  
  219. vibrto            Vibrato presets 00-12h (0=off)
  220.  
  221. vdelay            Vibrato delay 00-FF (in frames)
  222.  
  223.  
  224. VOICE SPECIALS
  225.  
  226. 01                Arpeggio   (uses Note 1/2/3/4 values at half chord speed)
  227.  
  228. 02                Trill note (alternating with normal note)
  229.                   24-7F/80-FF Normally used with drum sounds.
  230.  
  231. 04                Drum       (wave alternates with voice/freq bend down)
  232.  
  233. 08                Chord      (uses Note 1/2/3/4 values)
  234.  
  235. 10                Atk wave   (Used instead of Wavfrm during Atkcnt)
  236.                   Normally used with 81h value for noise 'chiff' attack.
  237.  
  238. 20                Atk note   (used instead of normal note during Atkcnt)
  239.  
  240. 40                DrumBend (note1 sets amount & direction)
  241.  
  242. 80                Fixed      (unaffected by global offsets e.g. for drums)
  243.  
  244.  
  245. NOTE 1/2/3/4 VALUES
  246.  
  247. 24-7F fixed notes    (e.g. 3C = C3 = middle C)
  248. 80-BF offsets higher (e.g. 8C = 12 up = 1 octave higher)
  249. C0-FF offsets lower  (e.g. C7 = 7 down = perfect 5th lower)
  250.  
  251.  
  252. WAVEFORM TABLE
  253.  
  254. 00                no waveform (can be used to delay start of sound
  255. 01                square wave on
  256. 02                noise wave on
  257.  
  258. N.B. Noise & pulse waves may be used simultaneously.
  259.  
  260.  
  261. NOISE TABLE
  262.  
  263. synchronous noise type
  264. 00                low freq
  265. 01                mid freq
  266. 02                high freq
  267. 03                freq set by 3rd channel
  268.  
  269. white noise type
  270. 04                low freq
  271. 05                mid freq
  272. 06                high freq
  273. 07                freq set by 3rd channel
  274.  
  275. Noise is provided by an independant noise source, but any noise needed to be
  276. set by note frequency using noise type 03 or 07 must be in the 3rd channel of
  277. music to operate properly.
  278.  
  279.  
  280. SUBROUTINE PARAMETERS
  281.  
  282. BYTE 1            BYTE 2                DETAILS
  283.  
  284. 24-7F NOTE        00-7F duration        normal note pair
  285.  
  286.  
  287. 80    VOICE       00-1F voice number    change to new voice
  288.  
  289.  
  290. 81    REST        00-7F duration        ADSR is set to release
  291.  
  292.  
  293. 82    BEND        00-7F bend up         reset to 0 with next note
  294.                   80-FF bend down       (use '8' to set up/down)
  295.  
  296. 83    TEMPO       01-FF value           global tempo (default is 6C = 125bpm)
  297.  
  298.  
  299. 84    TIED        0     (dummy)         the following note pair is legato
  300.  
  301.  
  302. 85    GATE        00-FF length          notes gated off (released) at length
  303.  
  304.  
  305. 86    GLBOF       00-FF signed offset   global key change
  306.  
  307.  
  308. FF    END         -                     End of subroutine
  309.  
  310.  
  311. N.B. When using frequency effects in combination, please note that the Trill
  312. and Chord specials override all vibrato and bend settings. For minimum GameGear
  313. processor usage set Vibrto=0/ Vdelay=FF when using these specials.
  314.  
  315.  
  316. MASTER PARAMETERS
  317.  
  318. BYTE 1              BYTE 2              DETAILS
  319.  
  320. 00-3F no. of times  00-BF sequence no.  normal subroutine pair
  321.  
  322.  
  323. 40    loop end      -                   use only after loop start
  324.  
  325.  
  326. 41-7F loop start    -                   e.g. 46 = loop 6 times
  327.  
  328.  
  329. FD    fade          00-FF time          start fade in all channels
  330.  
  331.  
  332. FE    end           00    (dummy)       end in all channels
  333.  
  334.  
  335. FF    loop channel  00-5F loop point    loop channel to any step
  336.                                         e.g. FF/02=loop to step 02
  337.  
  338.  
  339.  
  340.  
  341. APPENDIX A - NOTE VALUES
  342.  
  343. NAME           NORMAL         DOTTED         DOUBLE DOT     TRIPLET
  344.  
  345. Semibreve      30h            48h            54h            20h
  346.  
  347. Minim          18h            24h            2Ah            10h
  348.  
  349. Crotchet       0Ch            12h            15h            08h
  350.  
  351. Quaver         06h            09h            -              04h
  352.  
  353. Semiquaver     03h            -              -              02h
  354.  
  355. Demisemiquaver 2/2/1/1        -              -              01h
  356.  
  357.  
  358.  
  359. APPENDIX B - FILE COMPRESSION/ TESTING
  360.  
  361. See Gameboy manual!
  362.  
  363.  
  364.  
  365. APPENDIX C - HINTS AND TIPS
  366.  
  367. See Gameboy manual!
  368.  
  369.