clear_view_surface(3G)

NAME

clear_view_surface − set all or part of physical view surface to background_color

SYNOPSIS

C Syntax:

void clear_view_surface(fildes);
int fildes;

FORTRAN77 Syntax:

subroutine clear_view_surface(fildes)
integer*4 fildes

Pascal Syntax:

procedure clear_view_surface(fildes:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphic device is opened.

Discussion

Clear_view_surface repaints a portion of the view surface as indicated by clear_control with the index set by the last background_color call. Only planes that are write enabled are affected. A replacement rule of 3 (source) is used, regardless of the rule set with drawing_mode.

For multi-bank graphics devices in the default mode, only the current bank as selected by bank_switch is cleared. All banks can be cleared simultaneously with the proper call to clear_control.

Continuous-feed hardcopy devices may eject a new page, depending on the setting of clear_control.

Museum

Related Articles