Command: polynode

Syntax

{<entity> = } polynode "{"
    <pcommand>
    ....
"}"

Description

Create a polynode graphic entity. A polynode is a set of nodes (markers) with identical symbology.

Parameters

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

• <pcommand>
  A command line containing either:

• a language command to be executed normally, which may or may not generate polynode points, or

• a series of point expressions separated by commas defining polynode positions.

Switches

• -alph=<num>
  An alpha transparency factor between 0 and 1. A value 1 implies fully opaque, 0 means fully transparent (therefore invisible). The default is 1.

• -ang=<angle>
  The angle of orientation of the markers. If omitted, zero is used.

• -br=<num>
  A brightness factor 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 of the nodes. If included, this will override any color defined in the markerstyle. If omitted, the value "no_change" is used.

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

• -g=<groups>
  The graphic groups of which the entity is to be a member. If this is an assignment of a compound child entity, the -g switch is ignored and the child assumes the group membership of its compound parent.

• -mh=<num>
  The height of the markers. If omitted, the default marker height def_marker_height is used.

• -ms=<markerstyle>
  The markerstyle of the markers. If omitted, the default markerstyle def_ms is used.

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

Notes

This command always creates a graphic entity. Duplicate consecutive points are ignored.

Examples

Create an unnamed three-point polynode entity with default marker symbology and height.

polynode { gc, e:1000, n:1000 }

Create a named polynode entity (the points are defined interactively).

entity my_nodes = polynode -col=red,-ms=mk_star,-mh=10 {
    pseries; # Command
}

Create a circle of nodes (with plus markerstyle).

numeric x = 1000
entity ring = polynode -ms=mk_plus,-mh=2 {
    circle -c=(50,0),-r=50,-ap=32; # 32 nodes will be created
}

See Also