
NewPlayer v19 Instructions
--------------------------

Typed by JCH, 1991. Update v2, 3/8-1991.

Now I better give you the important information about the newest player;
NewPlayer 19. This player is so RAW and DISGUSTING it'll make v17 look like
a hitech player - you have been WARNED! It was ONLY done with one thing in
mind, getting the rastertime as far down as possible. A lot of sacrifices
have been made; f.ex there is NO slide and NO vibrato at all.

The tables in the player are very simple, really. The pulsating table and the
slide table are not in use AT ALL (even though you might see three "1's" in
the pulsating table, but just leave them alone) and in the filtertable you
ONLY use the two first numbers. The arpeggio table works EXACTLY as in player
v17 and v18 and needs no introduction. In the filtertable, the very first
number should be "00" in the editor (it's the rasterdecrease option used in
the packer) and the second byte is the filter-passband, normally "01". This
leaves the 8-byte instrument table to be explained.

         00  00  00  00  00  00  00  00
         --  --  --  --  --  --  --  --
         A   B   C   D   E   F   G   H

Byte A and B is ADSR. Remember that v19 has full hard restart, like in v17.

Byte C is puls start, "00" to "0F", no puls lo is available!!

Byte D is the pulsating speed. There is no pulswidths available!!

Byte E is the filter-frequency start.

Byte F is the filter add. Remember that a reversing will SUBTRACT! In other
       words, a "FE" means "subtract with 02" - Just like the add filter-freq
       byte 2 in player v20!

Byte G is the duration (in frames) that the filter add should last before the
       filter add routine is suspended. As you can see (and hear in the test
       tunes on the disk) the filterfunction in v19 is actually quite good.

Byte H is the arpeggio pointer. It works as normal.

WARNING! NewPlayer v19 makes use of frames 3 down to 0 for calculation
purposes inside the music-routine. This means that the smallest theoretical
tune speed you may use is FOUR! However, if you're not typing duration 00
notes in the editor and always use "+++" at least one time after every note
you CAN use tune speed THREE as the packer will make sure their durations is
3*2 = 6 frames for the smallest note durations used. But never use speed TWO!
If you do, the music-routine cannot access the routines which updates the
sequence pointer in the track-table, meaning that the player seems to be
stuck at the first sequence in the tracktable - totally ignoring the ones
following it!

Also, I cannot tell you how important it really is to make sure you've put
"+++" between notes - everywhere! If you forget this rule the music will
sound terrible when setting the rasterdecrease flag in the packer (now
remember that's the first byte of the four!) which will tempt you into
leaving it at "00". If you don't set the flag, or you put "---" here and
there in the sequences, the music will take $0F scanlines instead of $0D. The
player was primary made for the very low rastertime, $0D scanlines, which you
get by setting the rasterdecrease flag as mentioned PLUS using "+++"
everywhere.

The problem with slide and vibrato missing can be compensated by using a lot
of arpeggio based instruments and tie-note. Especially tie-note in the bass
can give the impression of a slide - if you know how to make use of the
facilities left in this player it should be possible to knock everyones socks
off! And remember that this player is what most super-coders have been
looking for. It takes less rastertime and memory than that awful
Music-Assembler yet sounds a lot better in the arpeggio area.

WARNING: Because of this players very low-cost coding, I've had to abandon
the facility of editing instruments while listening to them with "F2" in the
editor. In other words: If you want to hear the instruments you're currently
editing in the tables, put a few notes in a dummy sequence and play it with
"F1" or "F3". I know this sounds irritating, but I couldn't make everything
work like a luxury player at THESE low raster scanlines!!


JCH of VIBRANTS.

