AddPointInteriorToPolygon

Adds a point inside a given polygon. The point is defined with barycentric coordinates using three nodes (called offsets) of the polygon each one with a proper weight:

Pt = Weight1 * Polygon.Node(Offset1).Pos

+ Weight2 * Polygon.Node(Offset2).Pos

+ Weight3 * Polygon.Node(Offset3).Pos

The final point can be lifted above or below the polygon plane using the height parameter.

Note: It only makes sense to call this command after starting a new edge sequence using the AddEdge command and completing the final edge next by calling the command TerminateAddEdgeWithInteriorPoints (with possibly many interior points so created).

Scripting Syntax

AddPointInteriorToPolygon( Operator, PolygonID, FirstOffset, SecondOffset, ThirdOffset, FirstWeight, SecondWeight, ThirdWeight, [Height] );

Parameters

Parameter Type Description

Operator String Specifies the add-edge operator used to create the final edge sequence.

PolygonID Integer ID of the polygon

FirstOffset Integer Index where to find the barycentric first point in the polygon's list of points.

SecondOffset Integer Index where to find the barycentric second point in the polygon's list of points.

ThirdOffset Integer Index where to find the barycentric third point in the polygon's list of points.

FirstWeight Double Barycentric weight of the first point.

SecondWeight Double Barycentric weight of the second point.

ThirdWeight Double Barycentric weight of the third point.

Height Double Height above or below the polygon plane.
Default Value: 0.0

Examples

Parameter	Type	Description
Operator	String	Specifies the add-edge operator used to create the final edge sequence.
PolygonID	Integer	ID of the polygon
FirstOffset	Integer	Index where to find the barycentric first point in the polygon's list of points.
SecondOffset	Integer	Index where to find the barycentric second point in the polygon's list of points.
ThirdOffset	Integer	Index where to find the barycentric third point in the polygon's list of points.
FirstWeight	Double	Barycentric weight of the first point.
SecondWeight	Double	Barycentric weight of the second point.
ThirdWeight	Double	Barycentric weight of the third point.
Height	Double	Height above or below the polygon plane. Default Value: 0.0

VBScript Example

'

' The following example uses add-edge and at some point adds a 

' point in the interior of a quad. The edge is terminated using 

' TerminateAddEdgeWithInteriorPoints.

'

NewScene , false

CreatePrim "Grid", "MeshSurface"

SetValue "grid.polymsh.geom.subdivu", 1

SetValue "grid.polymsh.geom.subdivv", 1

SplitEdge "grid.edge[1]", 64.9271844660194, False, True, siPersistentOperation

ApplyOp "AddEdge", "grid.pnt[LAST];grid.edge[3];grid.poly[0]"

AddPointInteriorToPolygon "grid.polymsh.addedgeop", 0, 0, 1, 2, _

	0.394370594438662, 0.102825667243581, 0.502803738317757

TerminateAddEdgeWithInteriorPoints "grid.polymsh.addedgeop", 0, 3, 27.7912621359223