Attempting to enter a layer number or parameter that's not supported according to this list, will result to a B Integer out of range error.

There's one more command of note and this is:

LAYER CLEAR

which will reset all layer information, including banks, mode, the Layer 2 display enable, layer offsets (see Chapter 17) and ordering to defaults. This is also done by NEW.

BORDER, PAPER, INK, BRIGHT and FLASH

Run this program:

  5 LAYER 0
 10 FOR m=0 TO 1: BRIGHT m
 20 FOR n=1 TO 10
 30 FOR c=0 TO 7
 40 PAPER c: PRINT "    ";:; 4 spaces
 50 NEXT c: NEXT n: NEXT m
 60 FOR m=0 TO 1: BRIGHT m: PAPER 7
 70 FOR c=0 TO 3
 80 INK c: PRINT c;"   ";:; 3 spaces
 90 NEXT c: PAPER 0
100 FOR c=4 TO 7
110 INK c: PRINT c;"   ";:;3 spaces
120 NEXT c: NEXT m
130 PAPER 7: INK 0: BRIGHT 0

This shows the fifteen colours (including white and black and the BRIGHT variants) that the ZX Spectrum Next can produce on the screen if switched to Layer 0 (or standard resolution modes of Layer 1) without the EnhancedULA functions enabled. Here is a list of the basic eight for reference; they are also written over the appropriate number keys on your ZX Spectrum Next's keyboard:

0 black
1 blue
2 red
3 purple –or magenta–
4 green
5 cyan –or pale blue–
6 yellow
7 white

If you're thinking to yourself that the total colours (taking account of brightness turned on) should be 16, you'd be technically right however there cannot be a BRIGHT black so the total amount of colours is indeed 15. As you've noticed, the program introduces three commands: PAPER, INK and BRIGHT. If you look back to the Colour attribute display section you will recognize the terms immediately. These commands are the primary way of applying colour to objects on screen in NextBASIC. There is a number of supporting colour commands as well which will examine further in the following sections.