
*Instrument/SFX commands:

*  Common commands:
        ------------------------------------------------------
      E:v:d:s      -  Envelope: 1, 2 and 4 only, not for channel 3
                          Initial Volume (0-F)
                          Direction ('U'p or 'D'own)
                          Speed (0-7) 0 beeing no change
                              1-7 number of frames per volume changes

      E:d:s        -  Envelope: 1, 2 and 4 only, not for channel 3
                          Direction ('U'p or 'D'own)
                          Speed (0-7) 0 beeing no change
                              1-7 number of frames per volume changes
                          (volume is set using Vxx pattern command)

      G:           -  Go: note specified in pattern, not for SoundFX

      G:note       -  Go: for SoundFX/Instruments, not for channel 4                            
                          note = C0, C#1, D3, D#3, ... 
                          (octave range from 0 to 5)

      P:p          -  Panning: p = L(eft), R(ight), M(iddle)
                          middle is in fact BOTH channels on.
                          it sounds twice as loud.

      E            -  End: release soundfx locking. 
                          for instruments the end can be put right at 
                          the end of the instrument script.
                          for soundfx it is put on the frame where 
                          music can restart playing on that channel.  

        ------------------------------------------------------  
*  Chnl 1 and 2:

      R:r      - pulse Ratio: length of square pulse
                      0: -_______ 12.5%
                      1: --______ 25%
                      2: ----____ 50%
                      3: ------__ 75%
      
      F:s:d:h   - Frequency Sweep: only for channel 1, ignored by #2
                      dont forget to put one in every instruments that 
                      uses channel 1 as it is not reset when an 
                      instrument start, another instrument or sound fx
                      could have changed it and will affect music 
                      playback.

                      Speed: (0 - 7)
                             0 = off
                             x = x/128 of a second for every frequency
                                 changes
                      Direction:
                             'U'p or 'D'own
                             
                      sHifts: h = (0 - 7)
                             frequency +/- (frequency / (2 POW h))

                             The bigger the value, the smaller the 
                             change in the frequency for every steps
                               
        ------------------------------------------------------  
*  Chnl 3:
      W:id     - ID of the wave to load into channel 3
                     wave must be exactly 32 samples long

      V:v      - Volume (0 - 3)
                     0: Off
                     1: 1/4 volume
                     2: 1/2 volume
                     3: full volume

      X:id:s   - play long wave <id> at speed <s>
                    wave length must be a multiple of 32

                    s is the number of frames to pause
                    after every chunk of 32 samples

                    (0 = play at 1920Hz, 1= @ 960Hz, 
                    2 = @ 480Hz, ...)

                    use C-1 or B-0 to play wave at 1920Hz
                    C-0 for 960Hz
                    
        ------------------------------------------------------  
*  Chnl 4:
      P:r:s:d  - Polynominal counter load: (noise)
                     clock Ratio: (0 - 13)
                        shift right the clock's frequency by r+1 bits
                        (divided by 2 to the power of (r+1))
                     Steps: (0 or 1)
                        0: 15 steps (shhhhhhhh noise)
                        1: 7 steps (buzzing noise)
                     Divider: (0-7)
                        re-divide the resulting frequency from the 
                        clock Ratio by (d) 
                        (0 is worth 0.5, multiplying by 2)

        ------------------------------------------------------  
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

*Instruments can only use one channel.
*Sound effects are free to use any number of channels.

*The player is limited to 64 instruments.

*Instruments on channels 1 and 2 are interchangeable, the others arent.

*Channel 2 ignores Frequency sweep commands.
*Channel 1 keeps the last Frequency sweep setting until set in the
* instrument or sound effect.

*Channel 3 stop playing when the end (e) command is reached.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

*Instrument/SFX editor keys:
        ------------------------------------------------------
        Alt+Space    -  Test SoundFX (no specified note)
        Alt+NoteKey  -  Test Instrument/SoundFX (with specified note)

        Ctrl+Shift+S -  Save current instrument (IGB format)
        Ctrl+O       -  Open & Insert instrument (IGB format)
        
        Ctrl+E       -  Export Instrument/SFX Bank

        ------------------------------------------------------
*    instrument list:
        ------------------------------------------------------
        Insert       -  Insert a new instrument after the current
        Shift+Insert -  Insert a new instrument before the current
        Alt+Del      -  Delete current instrument

        ------------------------------------------------------
*    instrument editor:
        ------------------------------------------------------
        Insert       - insert an empty row in the current channel 
                       before the current line

        Shift+Insert - insert an empty row in the current channel 
                       after the current
                       
        Alt+Del      - delete row in the current channel
        ------------------------------------------------------

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
!!
