BASIC Screen Statements and Functions - fvdhoef/aquarius-plus GitHub Wiki

CLS

TYPE: _extended BASIC screen statement


CLS COLOR

TYPE: _plusBASIC screen statement


SCREEN

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 if 0.
      • text_priority - displays the text screen in front of the graphics screen if 1, and behind it if 0.
      • remap_border - sets the address that set the border character and colors.
        • 0 maps the border control character and color to the offset 0 in screen and color RAM, respectively.
        • 1 maps the control character and color to the offset 1023 in 40 column mode or 2047 in 80 column mode.
  • 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.


SET COLOR

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.

GETCOLOR

TYPE: plusBASIC screen statement

FORMAT: GETCOLOR

Action: Returns the current text printing color.

  • Returns -1 if color printing is disabled.
  • Returns the combined colors.
⚠️ **GitHub.com Fallback** ⚠️