Scripting: AddPointInteriorToPolygon

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