BASIC Screen Statements and Functions - fvdhoef/aquarius-plus GitHub Wiki
TYPE: _extended BASIC screen statement
TYPE: _plusBASIC screen statement
TYPE: plusBASIC v0.16d screen statement
FORMAT: SCREEN [text_screen] , [graphic_mode] , [sprites] , [text_priority], [remap_border]
Action: Sets the video output mode.
- The parameters are positional, but are all optional.
- If a parameter is not specified, that setting is not changed.
-
text_screen selects the text screen to display.
-
0
disables the text screen. -
1
selects the default 40-column screen. -
2
selects the secondary 40-column screen. -
3
selects the 80-column screen.
-
-
graphics_mode specifies which graphics mode to use.
-
0
disables the graphics screen. -
1
selects Tilemap graphics. -
2
selects 1bpp Bitmap graphics. -
3
selects 4bpp Bitmap graphics.
-
-
sprites - enables sprite display if
1
, and disables it if0
. -
text_priority - displays the text screen in front of the graphics screen if
1
, and behind it if0
. -
remap_border - sets the address that set the border character and colors.
-
0
maps the border control character and color to the offset0
in screen and color RAM, respectively. -
1
maps the control character and color to the offset1023
in 40 column mode or2047
in 80 column mode.
-
-
text_screen selects the text screen to display.
- If a parameter is not specified, that setting is not changed.
- In direct mode, the text screen is enabled and the graphics screen disabled.
Examples:
SCREEN 0,2,0
Displays the only the 1bpp bitmap screen.
` SCREEN 1,0,1
Displays the default 40 column text screen and sprites, with the graphics screen disabled.
SCREEN 1,3,,1
Displays the 40 column text screen in front of the 4bpp bitmap screen.
SCREEN 2
Selects the secondary 40-column screen.
SCREEN 3
Selects the 80=column screen.
TYPE: plusBASIC screen statement
FORMAT: SET COLOR fgcolor , bgcolor ...
Action: Enables color text printing mode and sets the text colors.
- fgcolor is the foreground color and bgcolor is the background color.
- All text displayed by the PRINT statement will have the specified foreground and background colors.
- When the screen scrolls, the colors will scroll with it and the bottom line will be filled with the selected background color.
-
CLS
with no operands will clear the screen using the selected colors.
FORMAT: SET COLOR OFF
Action: Disables color text printing, restoring the default BASIC behavior.
- Using
PRINT CHR$(11)
to clear the screen will also disable color printing.
TYPE: plusBASIC screen statement
FORMAT: GETCOLOR
Action: Returns the current text printing color.
- Returns
-1
if color printing is disabled. - Returns the combined colors.