Command: draw

Syntax

draw <elist> ...

Description

Draw entities.

Parameters

• <elist>
  A group/entity list defining which entities are to be drawn.

Switches

• -all
  Draw the entities in all graphic windows.

• -ef=<filter>
  A filter to be applied to all entities within <elist>, further qualifying which entities are to be drawn. If omitted, the filter current_filter is used.

• -er
  Erase the entities rather than draw them (the default behavior). Erasing in fact draws using the window’s background color.

• -fg
  Draw into the foreground. This switch is only relevant when the draw command is invoked during a window redraw procedure. During such a procedure entities are by default drawn into the background. The presence of -fg forces the entities to be drawn into the foreground instead.

• -w=<window>
  A graphic window identifier indicating the window in which to draw the entities. If this is omitted, the current graphic window is used.

Notes

This command is rarely necessary since all entity drawing and erasing is performed automatically on entity creation, deletion and modification. However there are times when more control is required.

Sub-entities of compounds may be drawn in isolation from their parent entities.

Entities are drawn by this command irrespective of whether they are in a window’s display group list.

Examples

Draw two entities in a specific window.

draw fred, my.face, -w=win4

Erase them from the same window.

draw fred, my.face, -w=win4, -er

See Also