geom.poly.add.node

Syntax

e = geom.poly.add.node(g,p<,n><,v><,i>)

Add an edge via a node addition. The first node in the created edge is whichever unconnected node remains from the last edge added to the polygon. A node pointer or a vector or an integer must be specified as the third argument to identify the second node to complete the edge. If a vector is specified, then that position is queried for a node. If an integer is specified, then the nodes in this geometry set are queried to find the node with that ID. If a node is not found, then a new node is created and is used to complete the edge.

If no edge has been created, the node is stored pending another geom.poly.add.node call so that the first edge may be created from those two points. In this case, e is a null pointer.

Note

If an edge already exists between any two nodes, a new edge will not be created and the preexisting one will be used by the polygon and returned.

Returns:

e - edge pointer

Arguments:

g - geometry set pointer

p - polygon pointer

n - optional node pointer of the second node

v - optional vector position of the second node

i - optional ID of the second node