Script Command: CLS

CLS [-t] [command]

Clear all text from the console window and place the cursor in the bottom left corner.

Options:

-t Clear the trace window instead of the console window.

Optional commands:

rgbsaveSave the current RGB values for text and console background.

fontrgb=rr,gg,bbSet a new RGB value for the font.

scrnrgb=rr,gg,bbSet a new RGB value for the console background (screen).

rgbrestoreRestore to the RGB values previously saved by 'rgbsave'.

Notes:

For each of the above commands with the xxx=rr,gg,bb format, this text is assumed to contain no whitespace.

Multiple commands can be on the same line, each should be separated by whitespace.

If any of the rgb commands above are executed, then the screen is not cleared, the new RGB attribute is applied to the current screen and left as-is.

EXAMPLE:

Use CLS to save the current font/background settings, then change them, then restore them...

CLS rgbsave

CLS scrnrgb=200,1,1 fontrgb=240,240,240

SLEEP 1000

CLS scrnrgb=1,200,1 fontrgb=240,240,240

SLEEP 1000

CLS scrnrgb=1,1,200 fontrgb=240,240,240

SLEEP 1000

CLS rgbrestore