PolygonFace.NeighborPolygons operator

Introduced

v3.0

Description

Returns a collection of PolygonFace neighbors within a given distance. If the distance is 1 all PolygonFace objects that share an Edge with the current PolygonFace are returned in counter-clockwise order.

Scripting Syntax

oReturn = PolygonFace.NeighborPolygons( [Distance] );

Return Value

PolygonFaceCollection

Parameters

Parameter Type Description
Distance Integer Distance is an integer value representing the degree of neighborhood (eg: degree=2 for a polygon means its adjacent polygons plus the adjacent polygons of the adjacent polygons)

Default Value: 1

Examples

VBScript Example

set oCube = ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface" )
set oGeometry = oCube.ActivePrimitive.Geometry
for each Polygon in oGeometry.Polygons
        set oNeighbors = Polygon.NeighborPolygons( 1 )
        str = "PolygonFaces neighbors of face( " & Polygon.index & ") are :"
        for each neighborPolygon in oNeighbors
                str = str & " " & neighborPolygon.index
        next
        logmessage str
next

See Also

PolygonFaceCollection.NeighborPolygons PolygonFace.NeighborVertices PolygonFace.NeighborEdges PolygonFace.GrowNeighborPolygons