home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 478.dms / 478.adf / BS.DOC < prev    next >
Text File  |  1988-07-26  |  6KB  |  143 lines
  1.            BRIAN'S SOUNDMON - DOC FILE
  2.  
  3. <Preface>
  4.  
  5. On this disk you will find one of the most powerfull Amiga soundeditors.
  6. It was written over a period of four days and is written in 100% assembler
  7. (source is over 70Kb longs). The program is a combination of the C64 sound-
  8. monitor and the Amiga Soundtracker. I decided to write my own music-player,
  9. because Soundtracker did not match my needs (I hated entering drums every
  10. new pattern again). For those who already know the C64 soundmonitor it won't
  11. be difficult to use this one, for those who don't I wrote this docfile.
  12. In this V1.0 version I have not added a file-requester nor gadgets, so all
  13. functions are called by pressing function-keys (I find this quicker then
  14. gadgets, once you know them). The program knows multitasking, so in order to
  15. know what songs are on your disk, enter the CLI and type 'DIR BPSONGS'.
  16. For info about the F-Keys read the file BSKeys.DOC.
  17. A filerequester and gadgets will problably be added in a later version, so
  18. watch out for it.
  19.  
  20.  
  21. <Get on with it>
  22.  
  23. Well, once you start up the soundmonitor your screen will be build up in
  24. 3 parts. 
  25. The first block (right on your screen) shows the used instruments (the
  26. active one is underlined), they should all read 'EMPTY'.
  27. The second block (top-left on your screen) shows the step-editor.
  28. The third block (bottom-left) shows the pattern-editor (should show pattern
  29. 1).
  30.  
  31.  
  32. <Instruments>
  33.  
  34. This one's very easy, read the BSKeys.DOC file for how to select instru-
  35. ments. When you press 'F8' you can change some sample parameters, like name
  36. length, repeat, replen and default volume.
  37.  
  38. Length: This is the length of the sample in bytes
  39. Repeat: This is the offset for the repeat part to the start of the sample.
  40. Replen: This is the length of the repeat part in bytes.
  41. Volume: This is the default volume in which the instrument will be played.
  42.  
  43. You can use presets, so you don't have to find out what repeat and replen to
  44. use. Also do some samples don't have a repeat part, in this case repeat=0
  45. and replen=2. (Again: read 'BSKeys.DOC' for how to use presets).
  46.  
  47. <Step-Editor>
  48.  
  49. One line of the step editor could look like this:
  50.  
  51. ST   PAT  ST TR   PAT  ST TR   PAT  ST TR   PAT  ST TR
  52.  
  53. 000  0001 00 00   0002 00 00   0003 01 00   0004 00 FC
  54.  
  55. The first number is the step number and can't be changed. Then you see 4
  56. times PAT, ST and TR. Where PAT is the number of the pattern to be played.
  57. ST is the SoundTranspose and TR the transpose. For each voice there is one
  58. PAT, one ST and one TR. All numbers in the pattern and step editor are
  59. entered in hexadecimal. 
  60.  
  61. -PAT
  62. Pattern numbers should go from $0001 till $155 (=341 patterns). It is better
  63. you don't use Pattern 1 for song data, because it is normally used as an
  64. empty pattern (no notes played). The pattern numbers is a 1 WORD (2 BYTES)
  65. number.
  66.  
  67. -ST
  68. The Soundtranspose is a 1 BYTE 2-complement number. What does this mean ?
  69. This means: a 1 is a +1, a 2 is a +2, but a $ff (255) is a -1.
  70. 2-complement means that any number greater than $80 (128) is negative, and
  71. it's value is NUMBER-256 (so 255-256=-1)
  72. Soundtranspose is used to play all notes in the pattern with higher instru-
  73. ment numbers. For example: If soundtranspose was set to 1 and in the pattern
  74. you would play a note with instrument 2 it would be really be played with
  75. instrument 3. Since there are only 15 instruments possible, only sound-
  76. transposes from -14 to +14 are meaningfull ($0-$E and $F2-$FF).
  77.  
  78. -TR
  79. The Transpose is also a 1 BYTE 2-complement number.
  80. Transposes are used to shift notes in the pattern. The transpose number
  81. indicates how many half-notes a pattern should be played higher or lower.
  82. For example: If transpose was set to $FC (-4) and I would play a C-2 in the
  83. pattern, a G#1 would really be played.
  84.  
  85.  
  86. <The Pattern Editor>
  87.  
  88. You can switch between the step and pattern editor by pressing the 'RETURN'
  89. key.
  90. In the pattern editor you can enter the notes you want to be played.
  91. When you enter the pattern editor it could look something like this :
  92.  
  93.     PATTERN : $0002
  94.  
  95.     C-2 1 0 00   --- 0 0 00   C-3 1 0 00   --- 0 0 00
  96.     C-2 1 0 00   C-2 1 1 20   C-2 1 1 18   C-2 1 1 10
  97.     C-2 1 1 08   C-2 1 1 00   C-3 1 0 00   --- 0 0 00
  98.     C-2 1 0 00   --- 0 0 00   C-3 1 0 00   --- 0 0 00
  99.  
  100. As you can see, there is room in the pattern for 16 notes.
  101. The first 3 symbols indicate the note to played (C-2 is a C on octave 2,
  102. there are 3 octave 1-3). You can enter these notes by pressing the key-
  103. board note keys (read BSKeys.DOC). The number after the note indicates
  104. the instrument in which the note will be played , in this example all notes
  105. are played with instrument 1 (this is a hex-number from 0-F). instrument
  106. 0 indicates that there is to play with the same instrument as used before.
  107. The next number is the option-select, read BSKeys.DOC to find out what
  108. options are available (also 0-F). The next 2 numbers are the data that a
  109. chosen option uses. In this example option 1 (volume setting is used),
  110. this means that some of the notes are played with other volume as the notes
  111. before (volume $20,$18,$10,$08 and $00 to be precise).
  112.  
  113.  
  114. <And now something about the Player>
  115.  
  116. The player is written in seka and can be used to play your songs, without
  117. the song-editor. There are 2 ways :
  118. 1-Save a module (F7): you must now adjust the length after the label BPSONG
  119.   to the length of your module. Assemble the program and load the datablock
  120.   created by the editor to bpsong. Now you can save the object file and
  121.   load it from the CLI. If you want to use it in your own program, make
  122.   sure you 'BSR' or 'JSR' to 'BPINIT' in the beginning of the program and
  123.   'BSR' or 'JSR' to BPMUSIC every vertical blank (This is heavy stuff, only
  124.   for people that know something about interrupts).
  125. 2-Save a song (F2): You should know write down the length's of the samples
  126.   used and the length of the song. Adjust the length after the label BPSONG
  127.   to the songlenght and adjust the length's after S1-SF (sample1 - Sample15)
  128.   to the length of the samples.
  129.   Assemble and then load the song to BPSONG and the samples to S1-SF.
  130.   You can leave out the BPINIT now (is not neccesary).
  131.  
  132.  
  133. <Finally, this is the end>
  134.  
  135. I guess this should be of some help. It would take me too much time to write
  136. a real good manual, I think you should play around a little with the program
  137. and you will learn all by yourself.
  138.  
  139. The Author: Brian Postma
  140.             J.v.Hartenstraat 51
  141.             7576VX Oldenzaal (NL)
  142.             tel:05410-14763
  143.