Command: highlight

Syntax

highlight { <elist> ... }

Description

Highlight graphic entities.

Parameters

• <elist>
  A group/entity list defining which entities are to be highlighted. If omitted, the current contents of the these group are highlighted.

Switches

• -alph=<num>
  An alpha transparency to be used in the highlight. This is a value between 0 and 1. A value 1 implies fully opaque, 0 means fully transparent (therefore invisible). The default is 1.

• -br=<num>
  A brightness factor to be used in the highlight. This is a value between -1 and +1. A value 0 means normal, -1 means very dark (black), +1 means very bright (white). The default is 1.

• -col=<color>
  The color to be used for the highlight.

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

• -th=<num>
  The thickness to be used for the highlight.

• -tim=<num>
  The length of the highlight in seconds.

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

Notes

Setting the color, thickness or time sets internal default highlighting values, which will apply to subsequent highlight commands unless redefined. At program startup the default values are: color black, thickness 2, time 1.

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

When polygon primitives are highlighted, their edges are drawn but not their fill properties.

Examples

Highlight all entities in the these group in the current window.

highlight

Highlight two entities in a specific window for 2 seconds.

highlight fred, ~my.face, -w=win4, -tim=2, -col=cyan

See Also