
                         EXTRA INSTRUCTIONS FOR v14.G0
                         

The sliding table


This page is an extra addition for the original instructions for NewPlayer
v14. The reason for this is that I forgot to describe the SLIDE table in
those instructions, and it is actually vital that you know something about
the bytes in this table as it is not as straight forward as you might think!
So here goes...

The slide table is the one you enter with the 'X' key. Here you will find two
bytes at each pointer, and as you can imagine this table can be called from
the sequence using a 'Sxx' command. Using a 'Sxx' inside a sequence will
point to this table which describes the natures of the choosen slide...

         00  00
         --  --
         A   B

Byte A is part hibyte sliding speed, part direction and part "ignore" bit.
The first byte looks like this in bits...

         1 0 1 0 0 0 0 0
         ^   ^ --------- = the hibyte part of the slide speed.
            
            
            the "ignore" bit, 1=slide on +++/---, otherwise on NOTE!
         
         direction of the slide, 1=down.

Byte B is the lobyte slide speed.

The big question mark here is the "ignore"-bit. What on heavens earth is
that? Well, in player v14 the music routine MUST know if you're starting your
slide on a NOTE or not (= on a +++ or ---) in the sequence. If you mix this
up you might end up getting weird bugs like the slide not stopping at the
next note (that sounds incredibly silly), so it is important that you
remember this.

Finally here follows some examples in using the slide table:

         00  80  -  slide up at speed 0080, the "Sxx" sits besides a note.
         02  C0  -  slide up at speed 02C0, the "Sxx" sits besides a note.
         80  20  -  slide down at speed 0020, the "Sxx" sits besides a note.
         20  C0  -  slide up at speed 00C0, the "Sxx" sits besides a +++/---.
         A1  40  -  slide down at speed 0140, the "Sxx" sits besides a +++/---.

Notice the first nibble's value when using the "ignore" bit.


Typed by JCH, 6/12-1990.


* ADDENDUM 19/8-1995: As far as I remember all this "ignore" business is not
* necessary in players v17 and up - I managed to enhance the slide routine.

