home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 478.dms / 478.adf / version1.doc < prev    next >
Text File  |  1977-12-31  |  12KB  |  289 lines
  1.  
  2.                      BRIAN'S SOUNDMON - DOC FILE
  3.  
  4. <Preface>
  5.  
  6. On this disk you will find one of the most powerfull Amiga soundeditors.
  7. It was written over a period of four days and is written in 100% assembler
  8. (source is over 70Kb longs). The program is a combination of the C64 sound-
  9. monitor and the Amiga Soundtracker. I decided to write my own music-player,
  10. because Soundtracker did not match my needs (I hated entering drums every
  11. new pattern again). For those who already know the C64 soundmonitor it won't
  12. be difficult to use this one, for those who don't I wrote this docfile.
  13.  
  14. In this V1.0 version I have not added a file-requester nor gadgets, so all
  15. functions are called by pressing function-keys (I find this quicker then
  16. gadgets, once you know them). The program knows multitasking, so in order to
  17. know what songs are on your disk, enter the CLI and type 'DIR BPSONGS'.
  18. For info about the F-Keys read the file BSKeys.DOC.
  19. A filerequester and gadgets will problably be added in a later version, so
  20. watch out for it.
  21.  
  22.  
  23. <Get on with it>
  24.  
  25. Well, once you start up the soundmonitor your screen will be build up in
  26. 3 parts. 
  27.  
  28. The first block (right on your screen) shows the used instruments (the
  29. active one is underlined), they should all read 'EMPTY'.
  30. The second block (top-left on your screen) shows the step-editor.
  31. The third block (bottom-left) shows the pattern-editor (should show pattern
  32. 1).
  33.  
  34.  
  35. <Instruments>
  36.  
  37. This one's very easy, read the BSKeys.DOC file for how to select instru-
  38. ments. When you press 'F8' you can change some sample parameters, like name
  39. length, repeat, replen and default volume.
  40.  
  41. Length: This is the length of the sample in bytes
  42. Repeat: This is the offset for the repeat part to the start of the sample.
  43. Replen: This is the length of the repeat part in bytes.
  44. Volume: This is the default volume in which the instrument will be played.
  45.  
  46. You can use presets, so you don't have to find out what repeat and replen to
  47. use. Also do some samples don't have a repeat part, in this case repeat=0
  48. and replen=2. (Again: read 'BSKeys.DOC' for how to use presets).
  49.  
  50. <Step-Editor>
  51.  
  52. One line of the step editor could look like this:
  53.  
  54. ST   PAT  ST TR   PAT  ST TR   PAT  ST TR   PAT  ST TR
  55.  
  56. 000  0001 00 00   0002 00 00   0003 01 00   0004 00 FC
  57.  
  58. The first number is the step number and can't be changed. Then you see 4
  59. times PAT, ST and TR. Where PAT is the number of the pattern to be played.
  60. ST is the SoundTranspose and TR the transpose. For each voice there is one
  61. PAT, one ST and one TR. All numbers in the pattern and step editor are
  62. entered in hexadecimal. 
  63.  
  64. -PAT
  65. Pattern numbers should go from $0001 till $155 (=341 patterns). It is better
  66. you don't use Pattern 1 for song data, because it is normally used as an
  67. empty pattern (no notes played). The pattern numbers is a 1 WORD (2 BYTES)
  68. number.
  69.  
  70. -ST
  71. The Soundtranspose is a 1 BYTE 2-complement number. What does this mean ?
  72. This means: a 1 is a +1, a 2 is a +2, but a $ff (255) is a -1.
  73. 2-complement means that any number greater than $80 (128) is negative, and
  74. it's value is NUMBER-256 (so 255-256=-1)
  75. Soundtranspose is used to play all notes in the pattern with higher instru-
  76. ment numbers. For example: If soundtranspose was set to 1 and in the pattern
  77. you would play a note with instrument 2 it would be really be played with
  78. instrument 3. Since there are only 15 instruments possible, only sound-
  79. transposes from -14 to +14 are meaningfull ($0-$E and $F2-$FF).
  80.  
  81. -TR
  82. The Transpose is also a 1 BYTE 2-complement number.
  83. Transposes are used to shift notes in the pattern. The transpose number
  84. indicates how many half-notes a pattern should be played higher or lower.
  85. For example: If transpose was set to $FC (-4) and I would play a C-2 in the
  86. pattern, a G#1 would really be played.
  87.  
  88.  
  89. <The Pattern Editor>
  90.  
  91. You can switch between the step and pattern editor by pressing the 'RETURN'
  92. key.
  93. In the pattern editor you can enter the notes you want to be played.
  94. When you enter the pattern editor it could look something like this :
  95.  
  96.     PATTERN : $0002
  97.  
  98.     C-2 1 0 00   --- 0 0 00   C-3 1 0 00   --- 0 0 00
  99.     C-2 1 0 00   C-2 1 1 20   C-2 1 1 18   C-2 1 1 10
  100.     C-2 1 1 08   C-2 1 1 00   C-3 1 0 00   --- 0 0 00
  101.     C-2 1 0 00   --- 0 0 00   C-3 1 0 00   --- 0 0 00
  102.  
  103. As you can see, there is room in the pattern for 16 notes.
  104. The first 3 symbols indicate the note to played (C-2 is a C on octave 2,
  105. there are 3 octave 1-3). You can enter these notes by pressing the key-
  106. board note keys (read BSKeys.DOC). The number after the note indicates
  107. the instrument in which the note will be played , in this example all notes
  108. are played with instrument 1 (this is a hex-number from 0-F). instrument
  109. 0 indicates that there is to play with the same instrument as used before.
  110. The next number is the option-select, read BSKeys.DOC to find out what
  111. options are available (also 0-F). The next 2 numbers are the data that a
  112. chosen option uses. In this example option 1 (volume setting is used),
  113. this means that some of the notes are played with other volume as the notes
  114. before (volume $20,$18,$10,$08 and $00 to be precise).
  115.  
  116.  
  117. <And now something about the Player>
  118.  
  119. The player is written in seka and can be used to play your songs, without
  120. the song-editor. There are 2 ways :
  121. 1-Save a module (F7): you must now adjust the length after the label BPSONG
  122.   to the length of your module. Assemble the program and load the datablock
  123.   created by the editor to bpsong. Now you can save the object file and
  124.   load it from the CLI. If you want to use it in your own program, make
  125.   sure you 'BSR' or 'JSR' to 'BPINIT' in the beginning of the program and
  126.   'BSR' or 'JSR' to BPMUSIC every vertical blank (This is heavy stuff, only
  127.   for people that know something about interrupts).
  128. 2-Save a song (F2): You should know write down the length's of the samples
  129.   used and the length of the song. Adjust the length after the label BPSONG
  130.   to the songlenght and adjust the length's after S1-SF (sample1 - Sample15)
  131.   to the length of the samples.
  132.   Assemble and then load the song to BPSONG and the samples to S1-SF.
  133.   You can leave out the BPINIT now (is not neccesary).
  134.  
  135.  
  136. --------------------------------------------------------------------------
  137.            The Sound Monitor KeyBoard function keys description
  138. --------------------------------------------------------------------------
  139.  
  140. Use The following keys:
  141.  
  142. a) In step edit mode:
  143.    F1 - Load Song
  144.    F2 - Save Song
  145.    F3 - Play Song all over
  146.    F4 - Play Song from current step
  147.    F5 - Stop Playing
  148.    F6 - Change Songlength
  149.    F7 - Save Module
  150.    F8 - Edit current Sample
  151.    F9 - Insert Step
  152.    F10- Delete Step
  153.    =  - Toggle Noteinsert (for patterneditor)
  154.    \  - Toggle KeyBoardPlay (for patterneditor)
  155.    [  - Shift KeyBoard to lower octave (dito.)
  156.    ]  - Shift KeyBoard to higher octave (and again)
  157.    ESC- Clear Song
  158.    `  - Goto
  159.    DEL- Reload Samples
  160.    HELP- Quit
  161.    A-F/0-9 - Edit data
  162.  
  163.    Keypad:
  164.    +  - Next Sample
  165.    -  - Previous Sample
  166.    ENTER   - Use Preset (When presets are loaded). The Preset file is named
  167.              PLST, and is in the same format as the soundtracker PLST. (so
  168.              you can use ST's PED too).
  169.              Use cursor keys to select preset, RETURN              to use, ENTER to cancel
  170.  
  171.    *  - Asks for a samplename (without diskname) and searches this one in the
  172.         presets list and loads it. (Where a '*' in the samplename stands for
  173.         any number of any kind of char. For example:
  174.         BASS* could mean BASSDRUM or BASSGUITAR or BASS.
  175.         Note that BASS*DRUM is the same as BASS* cause wildcards are only
  176.         usefull at the end of the samplename).
  177.  
  178. b) In Pattern edit mode:
  179.  
  180.    Most keys do the same except,
  181.    F9 - Copy Pattern
  182.    F10- Clear Pattern
  183.  
  184.    The keyboard is now transfered into a Piano-like keyboard as follows
  185.  
  186.              2     3           5     6     7           9     0
  187.             C#2   D#2         F#2   G#2   A#2         C#3   D#3
  188.  
  189.           Q     W     E     R     T     Y     U     I     O     P
  190.          C-2   D-2   E-2   F-2   G-2   A-2   B-2   C-3   D-3   E-3
  191.  
  192.              S     D           G     H     J           L     ;
  193.             C#1   D#1         F#1   G#1   A#1         C#2   D#2
  194.  
  195.           Z     X     C     V     B     N     M     ,     .     /
  196.          C-1   D-1   E-1   F-1   G-1   A-1   B-1   C-2   D-2   E-2
  197.  
  198. (Like SoundTracker...)
  199.  
  200. --------------------------------------------------------------------------
  201.    Technical Details:
  202.  
  203.    This is the second version of my soundeditor, the first one was written
  204.    in Basic (yes, Basic). The player was created in august 1988, so was
  205.    the first editor. This second version was written entirely in assembler
  206.    (yes, Assembler !!!), and it was created in four days (from 29-1-1989
  207.    till 1-2-1989). The source code is over 60Kbytes long. In the near
  208.    future I will probably improve some functions (like the character-read-
  209.    routine and the keyboard-play-routine). Brian's soundmon contains the
  210.    following options:
  211.  
  212.    0 = arpeggio
  213.    1 = set volume
  214.    2 = set tempo (6=normal,1=fastest)
  215.    3 = set LED status
  216.    4 = slide up
  217.    5 = slide down
  218.    6 = set repeat counter
  219.    7 = decreases repeat counter and branches to pattern number in data
  220.        when repeat counter reached zero
  221.    8 = Set Auto Slide
  222.    9 = Set Auto Arpeggio
  223.    A = Transposes off. As follows: If the hi-nibble of the data is not
  224.        zero then transpose is turned off, if the low-nibble of the data is
  225.        not zero then soundtranspose is turned off.
  226.        Example: A-00 ->normal, A-10->no transpose, A-01->no soundtranspose
  227.                 and A-11 is no transpose and no soundtranspose.
  228.  
  229.    Options 6 & 7 can be used to repeat a song part several times.
  230.    Problaly there will be some options added in the future.
  231.  
  232.    You can edit up to 341 (=$155) patterns, because I allocated 16Kb of
  233.    memory for the patterns, if you need more -> call me. The maximum
  234.    samplelength = 65534 bytes.
  235.  
  236.    Update 29-3-1989: Today I added Module Saving, use the normal Player to
  237.    play modules, adjust the length of the 'bpsong: blk.b' to the module
  238.    length and set the length of 's1-sf' to zero.
  239.    Modules are saved in 'ST-00:MODULES/"
  240.  
  241.    For more detailed instructions read: BS.DOC (also on this disk)
  242.  
  243.    Brian's Soundmon was created by Brian Postma.
  244.  
  245.    N.B.: I have not added a filerequester (yet), instead of this you can
  246.          type 'DIR BPSONGS' from your CLI. Use the normal Amiga keys to
  247.          switch screens (these are: 'LEFT-AMIGA+N' and 'LEFT-AMIGA+M')
  248.  
  249. --------------------------------------------------------------------------
  250.    For questions, remarks, compliments or complaints contact:
  251.  
  252.    Brian Postma
  253.    J.v.Hartenstraat 51
  254.    7576VX Oldenzaal
  255.    Holland
  256.    Tel: 05410-14763
  257.  
  258.  
  259. --------------------------------------------------------------------------
  260.    Special thanks to: -Martin, for pushing me all the time to write this
  261.                        program (Otherwise it was never written).
  262.                       -Rush,Metallica,Queensryche,Megadeth and Sanctuary,
  263.                        for aural stimulation.
  264.  
  265. --------------------------------------------------------------------------
  266.  
  267. <Finally, this is the end>
  268.  
  269. I guess this should be of some help. It would take me too much time to write
  270. a real good manual, I think you should play around a little with the program
  271. and you will learn all by yourself.
  272.  
  273. --------------------------------------------------------------------
  274. This program is ShareWare, if you like it send a small donation to :
  275.  
  276.                             Brian Postma
  277.                         J.v.Hartenstraat 51
  278.                         7576VX  Oldenzaal (NL)
  279.                            tel:05410-14763
  280. --------------------------------------------------------------------
  281.  
  282. The main instructions and the key functions were added together for
  283. ease of use by 17Bit. Thanks to Brian for his work - PLEASE send him
  284. some sort of donation for his hard work - look out for Version 2,
  285. better still why not write and tell us/him just what you would like
  286. featuring in further versions...
  287.  
  288. -------------------------------------------------------------------
  289.