Set the current background screen to modify.
Syntax[]
BGPAGE screen
| Input | Description |
|---|---|
screen
|
Screen to modify. 0 is the top screen, 1 is the bottom screen. |
Sets the current background screen. This changes which screen all following BG commands will affect.
Examples[]
PNLTYPE "OFF" 'so lower screen BG layers are visible ' Write something to the lower screen's BG layers BGPAGE 1 BGPUT 0,1,2,3 'pink tile at (1,2)
' Write something to the upper screen's BG layers BGPAGE 0 BGPUT 0,1,1,2 'red tile at (1,1)
Notes[]
screen is rounded down.
To actually see the lower screen's BG layers, it is necessary to first disable the keyboard with PNLSTR "OFF".
BGPAGE also influences other commands that interact with the background system's resources. For example, this includes LOAD, SAVE, the CHR* commands, and the COL* commands if specifying resource types without a screen.
Errors[]
| Action | Error |
|---|---|
| Zero arguments are provided | Syntax error |
screen is not zero or one
|
Out of range |
A string argument is provided for screen
|
Type Mismatch |