BASIC FILL SCREEN Statement - fvdhoef/aquarius-plus GitHub Wiki

FILL SCREEN

TYPE: plusBASIC graphics statement

Note: Syntax changed as of v0.20g.


FORMAT: FILL SCREEN ( startcol , startrow ) - ( endcol , endrow ) CHR character COLOR forecolor , backcolor

Action: Fills a rectangular section of the text screen with the specified character and colors.

  • startcol and startrow specifies the upper-left corner of the rectangle.
  • endcol and endrow specifies the lower-right corner of the rectangle.
  • character is either a numeric or string expression.
    • If numeric, it is the ASCII value of the character.
    • If string, the first character character is used.
  • forecolor and backcolor are the foreground and background color of the filled area.
  • Illegal Quantity results from any of the following conditions:
    • startcol or endcol are not in the range 0 through 39.
    • startrow or endrow are not in the range 0 through 24.
    • endcol is less than startcol or endrow is less than startrow.
    • character is string with length zero, a number not in the range 0 through 255.
    • forecolor or backcolor are not in the range 0 through 15.

FORMAT: FILL SCREEN ( startcol , startrow ) - ( endcol , endrow ) CHR character

Action: As above, but fills screen RAM without changing color RAM.


FORMAT: FILL SCREEN ( startcol , startrow ) - ( endcol , endrow ) CHR _COLOR forecolor , backcolor

Action: As above, but fills color RAM without changing screen RAM.


FORMAT: FILL SCREEN CHR character COLOR forecolor , backcolor

Action: As above, but fills entire screen.


FORMAT: FILL SCREEN CHR character

Action: As above, but fills entire screen.


FORMAT: FILL SCREEN COLOR forecolor , backcolor

Action: As above, but fills entire screen.