NAME
rmvrst - temporarily remove and restore a picture
SYNOPSIS
#include <mpict_p.h>
rmvpic (pic)
PICT pic;
rstpic (pic)
PICT pic;
DESCRIPTION
rmvpic
temporarily removes all occurrences of picture
pic. pic
may be a basic, complex, or top picture, previously built by calling
any of the mk...(3U) routines. It may refer to a occurences of
picture in the current display (see
vad(3U)
) as well as occurrences in pictures that will be presented later.
rmvpic
effectively removes a picture by skipping over it when any
display-list containing that picture is executed.
Removed pictures may be restored by calling
rstpic. rstpic
must refer to a picture that previously has been removed and has not
yet been restored.
SEE ALSO
vad(3U)
DIAGNOSTICS
rmvpic
and
rstpic
both return -1 for the following:
-
pic
is equal to EOP.
-
Errors occur while writing display-list memory.