Skip to content

Poly Points3D

Class full path: NemAll_Python_Geometry.PolyPoints3D

The PolyPoints class is the base template class for all objects which store geometry as a vector of points (or another objects), specially for polyline, polygon and spline.

Attributes

EndPoint: Point3D property writable

Get the end point in world coordinate system.

EndRelPoint: Point3D property

Get the end point

Points: list[Point3D] property writable

Get the point list

RefPoint: Point3D property writable

Get reference point.

StartPoint: Point3D property writable

Get the start point in world coordinate system.

StartRelPoint: Point3D property

Get the start point

Functions

Clear()

Remove all points from vector.

Count()

Get count of points.

Returns:

Type Description
int

bool.

Empty()

Return true if no points, otherwise false.

Returns:

Type Description
bool

bool.

EqualRef(polyPoints)

Test if reference points are equal.

Parameters:

Name Type Description Default
polyPoints PolyPoints3D

constant the PolyPoints.

required

Returns:

Type Description
bool

Reference points are equal: true/false

GetEndPoint()

Get the end point in world coordinate system.

Returns:

Type Description
Point3D

end point in world coordinate system

GetEndRelPoint()

Get the end point

Returns:

Type Description
Point3D

end point

GetLastPoint()

Get the last point in world coordinate system, data.

Returns:

Type Description
Point3D

last point in world coordinate system

GetPoint(index)

Get point in world coordinate system, data.

This method is checked and throwing Geometry::Exception when index is out of range.

Parameters:

Name Type Description Default
index int

point index.

required

Returns:

Type Description
Point3D

point point in world coordinate system.

GetPointIndex(point)

Get index of the given point

Parameters:

Name Type Description Default
point Point3D

Searched point

required

Returns:

Type Description
bool

tuple(True if a point was found,

int

Found index)

GetPointIndexes(point)

Get indexes of the given point, in case that several points in the spline will have the same coordinates

Parameters:

Name Type Description Default
point Point3D

Searched point

required

Returns:

Type Description
bool

tuple(True if at least one point was found,

list[int]

Found indexes)

GetRefPoint()

Get reference point.

Returns:

Type Description
Point3D

constant the reference point in the world coordinate system.

GetRelPoint(index)

Get point in Local coordinate system, no data.

This method is checked and throwing Geometry::Exception when index is out of range.

Parameters:

Name Type Description Default
index int

point index.

required

Returns:

Type Description
Point3D

point constant the point at position index.

GetStartPoint()

Get the start point in world coordinate system.

Returns:

Type Description
Point3D

start point in world coordinate system

GetStartRelPoint()

Get the start point

Returns:

Type Description
Point3D

start point

Insert overload

Insert(polyPoints, position=18446744073709551615)

Insert vector of points at specific position.

If return false then points weren't inserted.

Parameters:

Name Type Description Default
polyPoints PolyPoints3D

constant the PolyPoints.

required
position int

position where points will be inserted.

18446744073709551615

Returns:

Type Description
bool

bool true if successful.

Insert(point, position=18446744073709551615)

Insert point at specific position. Used world coordinates.

If return false then points weren't Inserted.

Parameters:

Name Type Description Default
point Point3D

constant the Point.

required
position int

position where points will be inserted.

18446744073709551615

Returns:

Type Description
bool

bool true if successful.

InsertRel(point, position=18446744073709551615)

Insert relative point at specific position. Used local coordinates.

If return false then points weren't Inserted.

Parameters:

Name Type Description Default
point Point3D

constant the Point.

required
position int

position where points will be inserted.

18446744073709551615

Returns:

Type Description
bool

bool true if successful.

Remove(position)

Remove point from specific position.

If return false then points weren't removed.

Parameters:

Name Type Description Default
position int

position of point which will be removed.

required

Returns:

Type Description
bool

Point removed: true/false

RemoveLastPoint()

Remove the last point

Returns:

Type Description
bool

Point removed: true/false

Reserve(newCount)

Reserve container capacity

Parameters:

Name Type Description Default
newCount int

Expected size of container [count of points]

required

Resize(newSize)

Specifies a new size for the points vector.

Parameters:

Name Type Description Default
newSize int

The new size of the points vector.

required

Reverse()

Reverse the point order

SetEndPoint(endpoint)

Set the end point in world coordinates

Parameters:

Name Type Description Default
endpoint Point3D

new end point

required

SetPoint(point, index)

Set point at given position in world coordinate system.

Parameters:

Name Type Description Default
point Point3D

point in the world coordinate system.

required
index int

index of point which will be set

required

SetRefPoint(refPoint)

Set reference point in world coordinate system.

Parameters:

Name Type Description Default
refPoint Point3D

reference point in the world coordinate system.

required

SetRelPoint(point, index)

Set point at given position in relative coordinate system.

Parameters:

Name Type Description Default
point Point3D

point in the relative coordinate system.

required
index int

index of point which will be set

required

SetStartPoint(startpoint)

Set the start point in world coordinates

Parameters:

Name Type Description Default
startpoint Point3D

new start point

required

ToLineChain()

Get polyline as a chain of lines composed from 2 points.

Returns:

Type Description
Point3DList

vector of lines composed from 2 points (start and end point of a line)

__getitem__(index)

Get point at position from index. Used world coordinates.

This method is checked and throwing Geometry::Exception when index is out of range.

Parameters:

Name Type Description Default
index int

point index.

required

Returns:

Type Description
Point3D

point.

__iadd__(point)

Add point in world coordinates.

Parameters:

Name Type Description Default
point Point3D

adding point.

required

Returns:

Type Description
PolyPoints3D

New point

__mul__(matrix)

2D matrix transformation

Parameters:

Name Type Description Default
matrix Matrix2D

2D transformation matrix

required

Returns:

Type Description
PolyPoints3D

Transformed polyline

__setitem__(arg2, value)

Set point at position from index. Used world coordinates.

This method is checked and throwing Geometry::Exception when index is out of range. Args: index: Specified position pnt: Point