ERASE Procedure

Erases the display surface of the currently active window.

Usage

Input Parameters

NOTE: Not all devices support this parameter. Workstations and display terminals, such as X workstations and Tektronix terminals, generally do, while some hardcopy devices, such as HPGL plotters, do not.

Keywords

Channel

The destination channel index or mask for the operation. Use only with devices with multiple display channels. If Channel is omitted, the system variable !P.Channel is used.

Color The background color index. If specified (and the parameter background_color is not specified), Color overrides the value of the system variable !P.Background.

Discussion

ERASE is a low-level graphics routine. It resets the display surface to the default background color (normally 0), which is indexed from the current color translation tables by the system variable !P.Background. You can override the default by specifying background_color.

ERASE affects the current window only; to switch windows, use the WINDOW command.

A side effect of ERASE is that the device is reset to alphanumeric mode if it has such a mode (e.g., Tektronix terminals).

Example 1

ERASE

; Erase the display surface for the current window and use the value
; in !P.Background to set the background color.

Example 2

COLOR_PALETTE

; Create a color palette so the color table can be easily viewed.

LOADCT, 2

; Load in color table 2, GRN-RED-BLU-WHT, as it has distinctive colors.

WINDOW, 1

; Create window 1.

ERASE

; Erase it using !P.Background.

WINDOW, 2

; Create window 2.

ERASE, 22

; Erase it, setting the background color to 22 (lime green).

WINDOW, 1

; Switch back to window 1.

ERASE, 64

; Reset the background color to 64 (bright red).

WINDOW, 2

; Switch back to window 2.

!P.Background=180

; Explicitly set the background color to 180 (lavender).

ERASE

; Set the background color based on !P.Background.

ERASE Procedure

Usage

Input Parameters

Keywords

Discussion

Example 1

Example 2

See Also