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

COPY

TYPE: BASIC I/O Statement

FORMAT: COPY

Action: Copies the text screen to the printer.

  • If no printer is attached, COPY will execute, but produce no output.

Advanced: The COPY statement assumes an original Aquarius 40 column printer is attached. It sends the entire 1000 bytes of screen RAM to the printer, with no carriage returns or line feeds. If used with a non-compatible printer, it will print a continuous stream of characters, and any characters outside the range of ASCII codes 32 through 126 will produce unpredictable results.

Examples:

COPY

Prints a copy of the current text screen.

LOAD SCREEN

TYPE: plusBASIC v0.22o disk statement

FORMAT: LOAD SCREEN filespec

Action: Loads the contents of the specified file into Screen and Color RAM.

  • filespec is a string expression containing an optional path and the full file name.
  • Bad file error results if the file does not match a valid screen file format.
    • Valid screen file formats are described under SAVE SCREEN.

SAVE SCREEN

TYPE: plusBASIC v0.22o disk statement

FORMAT: LOAD SCREEN filespec

Action: Loads the contents of the specified file into Screen and Color RAM.

  • filespec is a string expression containing an optional path and the full file name.

plusBASIC v0.27g enhancement

FORMAT: LOAD SCREEN filespec { { , PALETTE } , BORDERMAP}

  • The options PALETTE and BORDERMAP are used to write current palette and/or border mapping flag to the file.
  • In plusBASIC versions prior to v0.27g, SAVE SCREEN always writes the palette and border mapping flag.
Save Option File Formats

LOAD SCREEN filespec

  • For 40-column screens, contains 1024 continuous bytes of Screen RAM followed by 1024 continuous bytes of Color RAM for a total of 2048 bytes.
  • For 80-column screens, contains 2048 continuous bytes of Screen RAM followed by 2048 continuous bytes of Color RAM for a total of 4096 bytes.

LOAD SCREEN filespec , PALETTE

  • For 40-column screens, contains the 2048 bytes of Screen and Color RAM followed by the 32 byte palette data for a total of 2080 bytes.
  • For 80-column screens, contains the 4096 bytes of Screen and Color RAM followed by the 32 byte palette data for a total of 4128 bytes.
  • The palette data is the same as returned by the function GETPALETTE$(0).

LOAD SCREEN filespec , BORDERMAP

  • For 40-column screens, contains the 2048 bytes of Screen and Color RAM followed by a 1 byte border remap flag for a total of 2049 bytes
  • For 80-column screens, contains the 4096 bytes of Screen and Color RAM followed by a 1 byte border remap flag for a total of 4097 bytes.
  • The border map flag is set using the fifth argument of the SCREEN statement and returned in bit 5 of the SCREEN function.
  • If border is remapped, this byte will contain the value 255, otherwise it will contain the value 0.

LOAD SCREEN filespec , PALETTE , BORDERMAP

  • For 40-column screens, contains the 2048 bytes of Screen and Color RAM followed by the 32 byte palette and 1 byte border remap flag for a total of 2081 bytes.
  • For 80-column screens, contains the 4096 bytes of Screen and Color RAM followed by the 32 byte palette and 1 byte border remap flag for a total of 4129 bytes.
⚠️ **GitHub.com Fallback** ⚠️