User Tools

Site Tools


ugbasic:user:kw:cls
Translations of this page:


ugBASIC User Manual

CLS ✓

SYNTAX

   CLS
   CLS color

PURPOSE

The CLS command is used to clear the screen and return the cursor to the upper left corner. In other words, CLS clears the screen, eliminating everything that was previously printed.

Before printing new data to the screen, it is often useful to use CLS to have a clean and tidy space. In combination with other instructions, CLS can be used to create simple animations by erasing and redrawing elements on the screen. It allows you to update the user interface without leaving traces of previous operations.

The CLS command is generally very fast to execute and can also be used in graphics mode to clear the entire drawing area. It also has the ability to set a default background color, if possible. The clearing occurs with respect to the selected mode, so it will be a “pixel by pixel” clearing (if in bitmap mode) or “tile by tile” (if in tile mode). In the second case, the value of the EMPTYTILE variable will be used, possibly overridden

EXAMPLE

  CLS
  CLS WHITE

See also the following example files:

ABBREVIATION

 Cl

AVAILABLE ON

  • Dragon 32
  • Commodore 128 (Zilog Z80)
  • Commodore 128 (MOS 8502)
  • SEGA SG-1000
  • ZX Spectrum 48
  • Commodore 64
  • Commodore VIC-20
  • Atari (400/800)
  • Commodore PLUS/4
  • VG-5000
  • Olivetti Prodest PC128
  • Dragon 64
  • Amstrad CPC 664
  • SEGA SC-3000
  • ColecoVision
  • TRS-80 Color Computer 3
  • MSX
  • TRS-80 Color Computer

ALIAS FOR

ANY PROBLEM?

If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please open an issue for this keyword on GitHub. Thank you!

POWERED BY