## AddPointInteriorToPolygon

### Introduced

v4.0

### Description

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

#### 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

### See Also

ApplyOp ConnectNewPolygonToEdge ConnectNewPolygonToPoint AddPointToNewPolygon RemovePointFromPolygon RemoveLastPointInteriorToPolygon TerminateAddEdgeWithInteriorPoints SnapOffsetToPointForSlicePolygons