NAME

replace_ele − switch a display list into replace mode

SYNOPSIS

C Syntax:

void replace_ele(fildes)
int fildes;

FORTRAN77 Syntax:

subroutine replace_ele(fildes)
integer*4 fildes

Pascal Syntax:

procedure replace_ele(fildes:integer);

DESCRIPTION

Input Parameters

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

Discussion

Replace_ele places the specified display list in "replace mode".  In replace mode, the next element to be added to the open segment replaces the current element.  The element pointer position is not affected by the replacement. 

Replace mode is only in effect for the replacement of a single element.  After an element is replaced, replace mode is exited and subsequent additions to the currently open segment will be inserted until replace mode is re-entered. 

When the currently open segment is empty or the current element is element 0, replace mode has no effect; replacement is effectively an insertion and replace mode is exited. 

ERRORS

1 Graphics device is not initialized for this operation. 

DEFAULTS

When a graphics device is gopened, the display list for that device is in insert mode.

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992