Command: pseries

Syntax

{<entity> = } pseries

Description

Create a polyline graphic entity via interactive point definition.

Parameters

• <entity>
  An entity or gstructure identifier. The lines entity will be given this name.

Switches

• -col=<color>
  The color of the lines. If included, this will override any color defined in the linestyle (-ls). If omitted, the value no_change is used.

• -cur=<cursor>
  The graphic input cursor to be used during interactive point definition. If omitted, a default graphic cursor is used.

• -fr=<num>
  Define a fragment number for the entity. If omitted the default fragment def_fragment is used.

• -g=<groups>
  The graphic groups of which the entity is to be a member.

• -ls=<linestyle | color>
  The linestyle of the lines. This can be a linestyle or a color. If omitted, the current modeling color (def_color) is used.

• -ms=<markerstyle>
  A markerstyle to be used if markers are to be shown (-show). If omitted, the default markerstyle (def_ms) will be used.

• -n=<num>
  The maximum number of interactive points to get. If this is omitted, the operator will be expected to continue defining points interactively until the abort signal (mouse button 2) is given.

• -op=<ident>
  A point identifier into which the interactive points are to be recorded. This option is not available when an entity is being created. If <ident> does not exist a new point array is created using current scope rules.

• -ra=<num>
  Define a rank for the entity. If omitted, the default rank def_rank is used.

• -rub
  During point definition display a rubber line between consecutive points.

• -show
  Draw markers at each interactive point. The default is not to draw them.

• -th=<num>
  The thickness of the lines. If included, this will override any thickness defined in the linestyle (-ls).

• -x
  Use a big crosshair cursor during interactive definition. If the -cur switch is omitted, this is the only cursor used.

Notes

If the command has the form <entity> = pseries, an entity is always created.

If the command has no entity assignment, then an entity will be created only if the -op option is not used, or the command is not within another entity creation block, e.g. lines, polygon.

Examples

Create an unnamed polyline entity.

pseries

Create a named polyline entity and draw markers.

entity my_lines = pseries -show

See Also