home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / SBST20D4.ZIP / SHEET < prev    next >
Encoding:
Text File  |  1994-07-16  |  14.4 KB  |  505 lines
  1.  
  2.  
  3.  
  4.             SBStudio II
  5.             (C) 1991-94 Henning Hellström
  6.             All rights reserved
  7.  
  8.  
  9.             Program documentation
  10.  
  11.             Programming the sheet
  12.  
  13.             ═══════════════════════════════════════════════════════
  14.  
  15.  
  16.             The sheet section in SBStudio is where the music is
  17.             made. It is located at the bottom half of page one,
  18.             and looks something like this:
  19.  
  20.  
  21.                    ┌─ Edit cursor
  22.                    │
  23.                ┌──┬│─────────┬──────────┬──────────┬──────────┐
  24.                │  ││         │          │          │          │
  25.                │  ││         │          │          │          │
  26.                │  ││         │          │          │          │
  27.                │  ││         │          │          │          │
  28.                │  ││         │          │          │          │
  29.                ├──┼═─────────┼──────────┼──────────┼──────────┤
  30.              ┌──00│-------000│-------000│-------000│-------000│
  31.              │ ├──┼═─────────┼──────────┼──────────┼──────────┤
  32.              │ │01│-------000│-------000│-------000│-------000│
  33.              │ │02│-------000│-------000│-------000│-------000│
  34.              │ │03│-------000│-------000│-------000│-------000│
  35.              │ │04│-------000│-------000│-------000│-------000│
  36.              │ │05│-------000│-------000│-------000│-------000│
  37.              │ └││─│ ││││││││───────────────────────│────────│┘
  38.              │  └┤ └─┤└┤└┤│└┤                       └────────┤
  39.              │   │   │ │ ││ └─ Parameter position            │
  40.              │   │   │ │ │└─ Command position                │
  41.              │   │   │ │ └─ Volume position                  │
  42.              │   │   │ └─ Sound number position              │
  43.              │   │   └─ Note position                        │
  44.              │   └─ Sheet row number            One channel ─┘
  45.              └─ Current row
  46.  
  47.  
  48.  
  49.             Use the grey arrow keys to navigate the edit cursor.
  50.             Press TAB to jump to the next channel, SHIFT+TAB jumps
  51.             to the previous.
  52.  
  53.             To edit the sheet, edit mode has to be engaged. Press
  54.             SPACE to enter edit mode. The mouse cursor will turn
  55.             blue to indicate that this mode is on.
  56.  
  57.  
  58.  
  59.             If you are standing at the NOTE POSITION, notes can be
  60.             written to the sheet using the keys:
  61.  
  62.  
  63.                2 3   5 6 7   9 0   =
  64.               Q W E R T Y U I O P [ ]
  65.  
  66.                 S D   G H J   L ;
  67.                Z X C V B N M , . /
  68.  
  69.  
  70.             They correspond to ordinary piano keys. 
  71.  
  72.  
  73.             When entering notes, the current sound number will
  74.             automatically be inserted at the SOUND NUMBER
  75.             POSITION. To enter the sound number manually, go to
  76.             the sound number position and enter a number from 1 to
  77.             99. A zero means no sound change, and is shown as two
  78.             dashes.
  79.  
  80.             The current octave is selected by the keys F1-F4, but
  81.             you may also edit it manually. Just go to the second
  82.             character (the octave) at the NOTE POSITION and enter a
  83.             number from 1 to 4.
  84.  
  85.             To delete a note and its sound number, press DELETE
  86.             anywhere but at the volume position.
  87.  
  88.  
  89.             Depending on the 'jump right' setting in EDIT setup,
  90.             you will either be moved right or down after entering
  91.             a number.
  92.  
  93.  
  94.  
  95.             The VOLUME POSITION is where you enter volume changes.
  96.             The sound volume ranges from 0 to 64.
  97.  
  98.             To remove a volume setting, press DELETE when standing
  99.             at the volume position.
  100.  
  101.  
  102.  
  103.               NOTE:
  104.  
  105.                 Read the keyboard reference for a complete list
  106.                 of sheet editing functions.
  107.  
  108.  
  109.  
  110.             The COMMAND and PARAMETER POSITION is where the
  111.             special effects and actions are set. To understand
  112.             these, it is important that you know a bit about how
  113.             SBStudio play back music.
  114.  
  115.             During playback, each sheet row of notes is serviced a
  116.             certain number of times before moving on to the next.
  117.             How many times each row will be serviced is controlled
  118.             by you, and is called the SONG SPEED.
  119.             The first time a row is serviced, any new sounds,
  120.             volume settings and commands are set up and the notes,
  121.             if any, are played. The rest of the row services deal
  122.             with the special effects.
  123.  
  124.             The normal SONG SPEED, or number of services per row,
  125.             is 6.
  126.  
  127.  
  128.  
  129.             Here are the different commands available in SBStudio.
  130.  
  131.             Each time a row of notes is serviced will in this list
  132.             be referred to as A TICK.
  133.  
  134.             The COMMAND is a hexadecimal number from 0h to Fh.
  135.             The PARAMETER is a hexadecimal number from 00h to FFh.
  136.  
  137.             Remember that just reading about the commands is not
  138.             enough, you have to try them to fully understand them.
  139.  
  140.  
  141.  
  142.             »The commands»
  143.             ────────────
  144.  
  145.  
  146.             - Command <0> - Arpeggio (or none).
  147.  
  148.               Parameter <xy> - First and second halfnote
  149.                                additions.
  150.  
  151.               Arpeggio is used to simulate chords. This is done by
  152.               rapidly changing the pitch between 3 (or 2) different
  153.               notes.
  154.  
  155.               Example:
  156.  
  157.                 C-1 -- -- 047
  158.  
  159.                 C-major chord: (C+E+G  or C+4+7 halfnotes).
  160.  
  161.                 C-1 -- -- 037
  162.  
  163.                 C-minor chord: (C+D#+G or C+3+7 halfnotes).
  164.  
  165.  
  166.  
  167.             - Command <1> - Frequency slide up.
  168.  
  169.               Parameter <xx> - Slide rate.
  170.  
  171.               Portamento up will simply slide the sample pitch up.
  172.               You can not slide higher than B-4.
  173.  
  174.  
  175.  
  176.             - Command <2> - Frequency slide down.
  177.  
  178.               Parameter <xx> - Slide rate.
  179.  
  180.               Same as <1>, but this slides down instead.
  181.               You can not slide lower than C-1.
  182.  
  183.  
  184.  
  185.             - Command <3> - Tone portamento.
  186.  
  187.               Parameter <xx> - Slide rate.
  188.  
  189.               Tone portamento slides the pitch toward a specific
  190.               note. To start a tone portamento, use the command
  191.               together with a note.
  192.  
  193.               Example:
  194.  
  195.                 C-3 01 -- 000
  196.                 --- -- -- 000    Ok, the note C-3 is playing...
  197.                 G-4 01 -- 320    ...Let's slide it to G-4!
  198.                 --- -- -- 300    We're sliding at speed 20, 00
  199.                 --- -- -- 300    means 'continue sliding at old
  200.                 --- -- -- 000    speed'.
  201.  
  202.  
  203.  
  204.             - Command <4> - Vibrato.
  205.  
  206.               Parameter <xy> - Rate/depth.
  207.  
  208.               This command will add a vibrato effect to the
  209.               current sound. The first parameter digit is the
  210.               vibrato speed, the second is the depth.
  211.               You only need to set the parameter once. To
  212.               continue vibrating, set the parameter to 00.
  213.  
  214.               Use the command E4x to change the vibrato waveform.
  215.  
  216.               Example:
  217.  
  218.                 C-4 01 -- 482
  219.                 --- -- -- 400
  220.  
  221.  
  222.  
  223.             - Command <5> - Volume slide, continue tone
  224.                             portamento.
  225.  
  226.               Parameter <xy> - Volume slide rate, up/down.
  227.  
  228.               This is really two commands, <Axy> and <300>.
  229.               See those commands for details.
  230.  
  231.  
  232.  
  233.             - Command <6> - Volume slide, continue vibrato.
  234.  
  235.               Parameter <xy> - Volume slide rate, up/down.
  236.  
  237.               This is really two commands, <Axy> and <400>.
  238.               See those commands for details.
  239.  
  240.  
  241.  
  242.             - Command <7> - Tremolo.
  243.  
  244.               Parameter <xy> - Rate/depth.
  245.  
  246.               This command vibrates the volume. It acts just like
  247.               command <4>, except with the volume instead of the
  248.               pitch.
  249.  
  250.               Use the command E7x to change the tremolo waveform.
  251.  
  252.  
  253.  
  254.             - Command <8> - UNUSED.
  255.  
  256.  
  257.  
  258.             - Command <9> - Set sample offset.
  259.  
  260.               Parameter <xx> - High byte of sample offset.
  261.  
  262.               With this command, the sample starting point may be
  263.               set. You have to use it together with a note.
  264.               Set the parameter to 00 to continue using the old
  265.               offset.
  266.  
  267.               Example:
  268.  
  269.                 C-4 06 -- 920    20h=32, *256=8192, which is where
  270.                                  sample 06 will start.
  271.                 D#4 06 -- 900    20h is used, because it was the
  272.                                  last one set.
  273.  
  274.  
  275.  
  276.             - Command <A> - Volume slide.
  277.  
  278.               Parameter <xy> - Volume slide rate, up/down.
  279.  
  280.               This command either slides the sound volume up or
  281.               down, depending on which parameter digit you use.
  282.  
  283.               Example:
  284.  
  285.                 C-4 01 -- A0F    Slide the volume down fast...
  286.                 --- -- -- AF0    ...And back up again.
  287.  
  288.  
  289.  
  290.             - Command <B> - Jump to position.
  291.  
  292.               Parameter <xx> - Position 00h-7Fh.
  293.  
  294.               With this command, you may jump to another position
  295.               in the song. Useful for 'restarting' the song at the
  296.               end.
  297.  
  298.  
  299.  
  300.             - Command <C> - Note off.
  301.  
  302.               Parameter <xx> - Speed.
  303.  
  304.               This command only works with the GUS and MIDI OUT.
  305.               If used on a MIDI OUT channel, it will send a note
  306.               off MIDI command. If used on a GUS sound channel,
  307.               the parameter will be used as speed for the volume
  308.               ramping hardware to fade the volume down.
  309.  
  310.  
  311.  
  312.             - Command <D> - Sheet break.
  313.  
  314.               Parameter <xx> - Row 00-63 to start next sheet
  315.                                from (decimal).
  316.  
  317.               This command will make the song jump to the next
  318.               position, and start from sheet row <xx>. Remember
  319.               that the parameter is in decimal!
  320.  
  321.  
  322.  
  323.             - Command <F> - Song speed.
  324.  
  325.               Parameter <xx> - 01h-1Fh = Ticks, or speed.
  326.                                20h-FFh = Beats per minute.
  327.                                00h     = Stop song.
  328.  
  329.               Standard speed is 6, standard BPM is 7Dh or 125.
  330.  
  331.  
  332.  
  333.             »The E commands»
  334.             ──────────────
  335.  
  336.  
  337.             The <E> command is a bit special. It contains several
  338.             subcommands, selected through the first digit in the
  339.             PARAMETER setting. The second digit is the E command
  340.             parameter.
  341.  
  342.  
  343.  
  344.             - Command <E0> - UNUSED.
  345.  
  346.  
  347.  
  348.             - Command <E1> - Frequency trim up.
  349.  
  350.               Parameter <x> - Factor.
  351.  
  352.               This command slides the sound pitch up just once.
  353.               Great for making chorus effects.
  354.  
  355.  
  356.  
  357.             - Command <E2> - Frequency trim down.
  358.  
  359.               Parameter <x> - Factor.
  360.  
  361.               Does the same as command <E1>, except this slides
  362.               the pitch DOWN.
  363.  
  364.  
  365.  
  366.             - Command <E3> - Glissando control.
  367.  
  368.               Parameter <x> - 0h=off, 1h=on.
  369.  
  370.               When glissando is enabled, tone portamento (command
  371.               3 and 5) will slide in halfnotes.
  372.  
  373.  
  374.  
  375.             - Command <E4> - Set vibrato waveform.
  376.  
  377.               Parameter <x> - 0h=sine, 1h=ramp down,
  378.                               2h=square wave.
  379.  
  380.               With this command, you may alter the vibrato
  381.               waveform. It's great for making psycho-sounds.
  382.  
  383.  
  384.  
  385.             - Command <E5> - Set finetune.
  386.  
  387.               Parameter <x> - Finetune.
  388.  
  389.               This command lets you set the fine tuning from the
  390.               sheet.
  391.  
  392.                 Value     :  7  6  5  4  3  2  1  0
  393.                 Finetune  : +7 +6 +5 +4 +3 +2 +1  0
  394.  
  395.                 Value     :  F  E  D  C  B  A  9  8
  396.                 Finetune  : -1 -2 -3 -4 -5 -6 -7 -8
  397.  
  398.  
  399.  
  400.             - Command <E6> - Sheet loop.
  401.  
  402.               Parameter <x> - 0h=loop start.
  403.                               1h-Fh=loop count.
  404.  
  405.               This command lets you repeat a part of the sheet <x>
  406.               times.
  407.  
  408.               Example:
  409.  
  410.                 F-2 01 -- E60    Loop start
  411.                 G-2 01 -- 000
  412.                 A-3 01 -- 000
  413.                 D#1 01 -- 000
  414.                 E-4 01 -- 000
  415.                 C-2 01 -- E63    Repeat 3 times. Remember that the
  416.                                  part will be PLAYED 4 times.
  417.  
  418.  
  419.  
  420.             - Command <E7> - Set tremolo waveform.
  421.  
  422.               Parameter <x> - 0h=sine, 1h=ramp down,
  423.                               2h=square wave.
  424.  
  425.               With this command, you may alter the tremolo
  426.               waveform.
  427.  
  428.  
  429.  
  430.             - Command <E8> - Pan control.
  431.  
  432.               Parameter <x> - Balance 0h-Fh, 7h=neutral.
  433.  
  434.               This command sets the channel's stereo balance.
  435.  
  436.  
  437.  
  438.             - Command <E9> - Retrig note.
  439.  
  440.               Parameter <x> - Ticks between retrigs.
  441.  
  442.               This command will wait <x> ticks, retrig the note,
  443.               and continue doing so until the next row (for <SONG
  444.               SPEED> ticks).
  445.  
  446.  
  447.  
  448.             - Command <EA> - Volume trim up.
  449.  
  450.               Parameter <x> - Factor.
  451.  
  452.               This command slides the volume up <x> points once.
  453.  
  454.  
  455.  
  456.             - Command <EB> - Volume trim down.
  457.  
  458.               Parameter <x> - Factor.
  459.  
  460.               This command slides the volume down <x> points once.
  461.  
  462.  
  463.  
  464.             - Command <EC> - Note cut.
  465.  
  466.               Parameter <x> - Ticks before cut.
  467.  
  468.               This command will wait <x> ticks, then set the sound
  469.               volume to 0.
  470.  
  471.  
  472.  
  473.             - Command <ED> - Note delay.
  474.  
  475.               Parameter <x> - Ticks to delay.
  476.  
  477.               This command will wait <x> ticks before trigging the
  478.               note.
  479.  
  480.  
  481.  
  482.             - Command <EE> - Sheet delay.
  483.  
  484.               Parameter <x> - Times to delay.
  485.  
  486.               This command will delay the sheet row <x> times.
  487.  
  488.  
  489.  
  490.             - Command <EF> - MIDI OUT toggle.
  491.  
  492.               Parameter <x> - MIDI channel 0h-Fh.
  493.                               Same again=off.
  494.  
  495.               After using this command, any notes will be sent to
  496.               the MIDI port as MIDI channel <x> data, together
  497.               with program change and velocity, if any.
  498.  
  499.               Select the same channel again to return to normal
  500.               mode.
  501.  
  502.  
  503.             ═══════════════════════════════════════════════════════
  504.  
  505.