home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / ST_USER / 1990 / USERAU90.MSA / TEXT_XBIOS.DOC < prev    next >
Text File  |  1990-06-24  |  8KB  |  197 lines
  1.                      XBIOS MUSIC CONSTRUCTION KIT
  2.  
  3.  
  4.           Make music like Mozart (or Motorhead) with maestro
  5.                David O'Connell's powerful song editor
  6.  
  7.  
  8. With this program you can easily include superb music in your programs, and it
  9. works in BASIC, too. Using only about six commands you can load into your game
  10. or demo music that was written with this program and it will play in the
  11. background while your program runs uninterrupted. By including a few more
  12. commands you can detect the end of the music and either restart it or load in
  13. more music
  14.  
  15.     Don't worry if you don't can't compose to save your life and understand all
  16. those tadpoles and telegraph wires as you can simply buy some sheet music and
  17. copy it into the program. (However, most music is copyright so don't pass your
  18. - copied - music around.)
  19.  
  20.  
  21.                    ****************************************
  22.  
  23.  
  24.                             MENU BAR FUNCTIONS
  25.  
  26. CHANGE PAGE   - Takes you to the voice editing page
  27. QUIT          - Quits program
  28. SAVE VOICES   - Saves voices created with the program
  29. SAVE SONG     - Saves song in program's internal format
  30. LOAD VOICES   - Loads a set of voices
  31. LOAD SONG     - Loads a song into program for editing
  32. VOICE CHANGE  - When editing a song you can include voice changes
  33. COPY          - Copy part of song to new location
  34. SAVE FOR XBIOS- Saves song as an XBIOS file - use this in your programs
  35. TEST XBIOS FILE- Loads and plays an XBIOS file
  36. NEW           -Deletes all song
  37. SET MARK      -Sets a mark in the song
  38. FIND MARK     -Finds mark set with "SET MARK"
  39. REDUCE SONG   -Reduces size of song to end of the two bars displayed
  40.  
  41.  
  42.                    ****************************************
  43.  
  44.  
  45.                            MAIN PAGE FUNCTIONS
  46.  
  47. Top left is the bar indicator which shows the number of the bar displayed
  48. onscreen. Under this are the arrows for moving the display of your song up one
  49. bar, up two bars, back one bar and back two bars.
  50.  
  51.     Below this is the mark indicator which shows the part of the song being
  52. edited. Clicking on this will also take you to the FIND MARK menu. Double
  53. clicking lets you set a new mark at the current bar.
  54.  
  55.     To the right and at the top of the page is "TRACK 3 FEATURE" for switching
  56. in the special effects of track three (more about this later). Below this is
  57. "TRACK 2 FEATURE" which enables you to split track to at any point and assign
  58. different voices to the upper and lower parts. To the right are the note values
  59. and to the right of these is TIE to tie two notes together. Just click on TIE
  60. then on the note you want to tie and it will be tied to the note in front.
  61.  
  62.     Next is SLUR. If two notes are slurred together the second note starts its
  63. envelope from where the first note finished. Also there is a slight slide to
  64. the second note. Because of the limitations in the ST's XBIOS routine the tempo
  65. change is quite limited. When you click on PLAY a menu will appear giving you
  66. options on where to play from. STOP, stops playback of song.
  67.  
  68.     To input notes on to screen just click mouse on the stave. Some rests are
  69. added automatically, but you can also input a note of the same value then
  70. finish the bar and go back and delete the note where you want the rest. To
  71. delete a note double click on the track and a rubber band will appear. Hold
  72. down the mouse button and drag the box to enclose all notes you want to delete
  73. then let go of the mouse button.
  74.  
  75.     When you move the bar display the bars shown are included in the length of
  76. the song even if you don't input any notes. This is why you can reduce the song
  77. so that when you compile it for an XBIOS file these unwanted bars aren't
  78. included.
  79.  
  80.  
  81. Resolution differences
  82. HI REZ: All three channels (tracks) of the ST are shown and to MUTE a track
  83. click on the track number. On the voice edit page the "TEST SEQUENCE" is
  84. displayed.
  85.  
  86. IN MED REZ: Only one channel (track) is displayed and to display other tracks
  87. click on the track number to right of "EDIT TRACK". To mute a track click on
  88. track number to right of mute track. On the voice edit page to edit the test
  89. sequence click on "EDIT TEST EQUENCE"
  90.  
  91.  
  92.                    ****************************************
  93.  
  94.  
  95.                             VOICE EDITING PAGE
  96.  
  97. VOICE No.?: These are the voices you can create. To the right of each one is a
  98. small box and clicking here will enable you to edit it. Double clicking on the
  99. name enables you to rename it.
  100.  
  101. ENVELOPE: Displays the envelope of the voice being edited.
  102.  
  103. SLIDERS: UP/DOWN is the volume of the envelope.
  104.          LEFT/RIGHT is the envelope speed.
  105.  
  106. NOISE GEN.: Turns the noise effect on/off for each voice and sets the
  107. frequency. (The ST has only one noise frequency control therefore you will get
  108. peculiar results by having noise on more than one track.) The two boxes under
  109. the NOISE GEN. box display the voice name and number of the voice being
  110. edited.
  111.  
  112. VIBRATO/TREMOLO: Click here toggle from one effect to the other.
  113.  
  114. VIBRATO:  Makes voices sound more realistic, but uses a lot of memory when
  115. compiled for playing in your program.
  116.  
  117. TREMELO: Like vibrato, but changes the volume, not pitch.
  118.  
  119. If a voice file with the name DEF.VOC is on the disk when the program loads it
  120. will be automatically loaded into the program.
  121.  
  122.  
  123.                    ****************************************
  124.  
  125.  
  126.                              EDIT MODE FUNCTIONS
  127.  
  128. VOICE: Edits the voices
  129.  
  130. TRACK: Clicking on track puts you into another edit mode hear the voices are
  131. assigned to a note(like a drum machine) this means you can make up complex drum
  132. patterns without making voice changes every note.To the left are the Different
  133. Notes by clicking on a note number you can edit it The note value can now be
  134. edited in the box witch is now under the Noise Gen.Box when this note is played
  135. during your song it will have the note value you have set
  136. hear for it THIS WILL ONLY WORK ON TRACK THREE AND ONLY WHEN THIS FEATURE IS
  137. ON
  138.  
  139.  
  140.                    ****************************************
  141.  
  142.  
  143.                          FILE TYPES AND EXTENDERS
  144.  
  145. .VOC   All voice info and the two sort sequences on voice edit page
  146.  
  147. .SNG   Song info for reloading into this program
  148.  
  149. .XBS   This is the file to use in you programs
  150.  
  151.  
  152.                    ****************************************
  153.  
  154.  
  155.                              MUSIC FROM BASIC
  156.  
  157. There are two program examples in GFA BASIC. One of these is a demo which came
  158. free with GFA BASIC and has been changed to include sound files. The commands
  159. in GFA BASIC to load the XBIOS music are:
  160.  
  161. OPEN "I",#1,F$                    !F$=name of file
  162. A%=LOF(#1)                        !find length of music
  163. DIM MUSIC_ADDR%(A%/4)             !and reserve memory
  164. BLOAD F$,VARPTR(MUSIC_ADDR%(0))   !load
  165. CLOSE #1
  166.  
  167.     To play music from GFA BASIC:
  168.  
  169. VOID XBIOS(32,l:VARPTR(MUSIC_ADDR%(0))
  170.  
  171.  
  172.     To detect the end of the music:
  173.  
  174. A%=xBIOS(28,0,7)
  175. IF A%=255 ... then the music has ended
  176.  
  177.     When music is playing using the Xbios routine it will be stopped by the
  178. keyboard's key click, but this can be disabled with:
  179.  
  180. SPOKE &H484,PEEK(&H484) AND NOT 1
  181.  
  182.     And turned back on again with:
  183.  
  184. SPOKE &H484,PEEK(&H484) OR 1
  185.  
  186.  
  187.     To halt the music while its playing:
  188.  
  189. NO_PLAY$=CHR$(8)+CHR$(0)+CHR$(9)+CHR$(0)+CHR$(10)+CHR$(7)+CHR$(255)+
  190.          CHR$(-1)+CHR$(0)
  191. VOID XBIOS(32,l:VARPTR(NO_PLAY$))
  192.  
  193.  
  194. HARDWARE: ALL STs, MONO AND MEDIUM RES COLOUR
  195.  
  196.  
  197.