Brief Index      Full Index      Events Index      I.M. Reference

Clear_Display

Functions

void Clear_Display (void)

Function Documentation

void Clear_Display ( void  )

Clears all the geometrical primitives out of the scene. Current attribute settings are left unchanged.

DETAILS

Use Clear_Display() when running in "non-segmented" mode. You call it just after a screen update. Clear_Display() provides a handy way to clear geometries out in preparation for drawing a new scene. All the geometrical primitives (geometries that were "Inserted", such as lines) are removed. Attributes (styles that were "Set", such as line color) are left as they were.

Clear_Display() should not be confused with Reset_System() even though the net effect may look the same. Clear_Display() just removes geometry. Reset_System() is more drastic---it deletes everything and shuts down the whole system.

NOTES

Clear_Display() is intended for use in the "non-segmented" context. It's actually identical to a call to Flush_Geometry() ("?picture...").

RESTRICTIONS

See also:
Reset_System, Flush_Contents, Flush_Geometry, Delete_Segment.

Brief Index      Full Index      Events Index      I.M. Reference