This package provides classes and services to handle : More...

#include <Poly.hxx>

Static Public Member Functions
static Handle< Poly_Triangulation >	Catenate (const Poly_ListOfTriangulation &lstTri)
	Computes and stores the link from nodes to triangles and from triangles to neighbouring triangles. This tool is obsolete, replaced by Poly_CoherentTriangulation Algorithm to make minimal loops in a graph Join several triangulations to one new triangulation object. The new triangulation is just a mechanical sum of input triangulations, without node sharing. UV coordinates are dropped in the result.

static void	Write (const Handle< Poly_Triangulation > &T, Standard_OStream &OS, const Standard_Boolean Compact=Standard_True)
	Writes the content of the triangulation <T> on the stream <OS>. If <Compact> is true this is a "save" format intended to be read back with the Read method. If compact is False it is a "Dump" format intended to be informative.

static void	Write (const Handle< Poly_Polygon3D > &P, Standard_OStream &OS, const Standard_Boolean Compact=Standard_True)
	Writes the content of the 3D polygon.

static void	Write (const Handle< Poly_Polygon2D > &P, Standard_OStream &OS, const Standard_Boolean Compact=Standard_True)
	Writes the content of the 2D polygon.

static void	Dump (const Handle< Poly_Triangulation > &T, Standard_OStream &OS)
	Dumps the triangulation. This is a call to the previous method with Comapct set to False.

static void	Dump (const Handle< Poly_Polygon3D > &P, Standard_OStream &OS)
	Dumps the 3D polygon. This is a call to the previous method with Comapct set to False.

static void	Dump (const Handle< Poly_Polygon2D > &P, Standard_OStream &OS)
	Dumps the 2D polygon. This is a call to the previous method with Comapct set to False.

static Handle< Poly_Triangulation >	ReadTriangulation (Standard_IStream &IS)
	Reads a triangulation from the stream <IS>.

static Handle< Poly_Polygon3D >	ReadPolygon3D (Standard_IStream &IS)
	Reads a 3d polygon from the stream <IS>.

static Handle< Poly_Polygon2D >	ReadPolygon2D (Standard_IStream &IS)
	Reads a 2D polygon from the stream <IS>.

static void	ComputeNormals (const Handle< Poly_Triangulation > &Tri)
	Compute node normals for face triangulation as mean normal of surrounding triangles.

static Standard_Real	PointOnTriangle (const gp_XY &P1, const gp_XY &P2, const gp_XY &P3, const gp_XY &P, gp_XY &UV)
	Computes parameters of the point P on triangle defined by points P1, P2, and P3, in 2d. The parameters U and V are defined so that P = P1 + U * (P2 - P1) + V * (P3 - P1), with U >= 0, V >= 0, U + V <= 1. If P is located outside of triangle, or triangle is degenerated, the returned parameters correspond to closest point, and returned value is square of the distance from original point to triangle (0 if point is inside).

static Standard_Boolean	Intersect (const Handle< Poly_Triangulation > &theTri, const gp_Ax1 &theAxis, const Standard_Boolean theIsClosest, Poly_Triangle &theTriangle, Standard_Real &theDistance)
	Computes the intersection between axis and triangulation.

static Standard_Integer	IntersectTriLine (const gp_XYZ &theStart, const gp_Dir &theDir, const gp_XYZ &theV0, const gp_XYZ &theV1, const gp_XYZ &theV2, Standard_Real &theParam)
	Computes the intersection between a triangle defined by three vertexes and a line.

template<class TypeSequencePnts >
static Standard_Boolean	PolygonProperties (const TypeSequencePnts &theSeqPnts, Standard_Real &theArea, Standard_Real &thePerimeter)
	Returns area and perimeter of 2D-polygon given by its vertices. theArea will be negative if the polygon is bypassed clockwise and will be positive, otherwise. thePerimeter will always be positive.

Detailed Description

This package provides classes and services to handle :

3D triangular polyhedrons.
3D polygons.
2D polygon.
Tools to dump, save and restore those objects.

Member Function Documentation

◆ Catenate()

static Handle< Poly_Triangulation > Poly::Catenate ( const Poly_ListOfTriangulation & lstTri )

static

Computes and stores the link from nodes to triangles and from triangles to neighbouring triangles. This tool is obsolete, replaced by Poly_CoherentTriangulation Algorithm to make minimal loops in a graph Join several triangulations to one new triangulation object. The new triangulation is just a mechanical sum of input triangulations, without node sharing. UV coordinates are dropped in the result.

◆ ComputeNormals()

static void Poly::ComputeNormals ( const Handle< Poly_Triangulation > & Tri )

static

Compute node normals for face triangulation as mean normal of surrounding triangles.

◆ Dump() [1/3]

static void Poly::Dump	(	const Handle< Poly_Polygon2D > &	P,
		Standard_OStream &	OS
	)

static

Dumps the 2D polygon. This is a call to the previous method with Comapct set to False.

◆ Dump() [2/3]

static void Poly::Dump	(	const Handle< Poly_Polygon3D > &	P,
		Standard_OStream &	OS
	)

static

Dumps the 3D polygon. This is a call to the previous method with Comapct set to False.

◆ Dump() [3/3]

static void Poly::Dump	(	const Handle< Poly_Triangulation > &	T,
		Standard_OStream &	OS
	)

static

Dumps the triangulation. This is a call to the previous method with Comapct set to False.

◆ Intersect()

static Standard_Boolean Poly::Intersect	(	const Handle< Poly_Triangulation > &	theTri,
		const gp_Ax1 &	theAxis,
		const Standard_Boolean	theIsClosest,
		Poly_Triangle &	theTriangle,
		Standard_Real &	theDistance
	)

static

Computes the intersection between axis and triangulation.

Parameters

theTri	[in] input triangulation
theAxis	[in] intersecting ray
theIsClosest	[in] finds the closest intersection when TRUE, finds the farthest otherwise
theTriangle	[out] intersected triangle
theDistance	[out] distance along ray to intersection point

Returns: TRUE if intersection takes place, FALSE otherwise.

◆ IntersectTriLine()

static Standard_Integer Poly::IntersectTriLine	(	const gp_XYZ &	theStart,
		const gp_Dir &	theDir,
		const gp_XYZ &	theV0,
		const gp_XYZ &	theV1,
		const gp_XYZ &	theV2,
		Standard_Real &	theParam
	)

static

Computes the intersection between a triangle defined by three vertexes and a line.

Parameters

theStart	[in] picking ray origin
theDir	[in] picking ray direction
theV0	[in] first triangle node
theV1	[in] second triangle node
theV2	[in] third triangle node
theParam	[out] param on line of the intersection point

Returns: 1 if intersection was found, 0 otherwise.

◆ PointOnTriangle()

static Standard_Real Poly::PointOnTriangle	(	const gp_XY &	P1,
		const gp_XY &	P2,
		const gp_XY &	P3,
		const gp_XY &	P,
		gp_XY &	UV
	)

static

Computes parameters of the point P on triangle defined by points P1, P2, and P3, in 2d. The parameters U and V are defined so that P = P1 + U * (P2 - P1) + V * (P3 - P1), with U >= 0, V >= 0, U + V <= 1. If P is located outside of triangle, or triangle is degenerated, the returned parameters correspond to closest point, and returned value is square of the distance from original point to triangle (0 if point is inside).

◆ PolygonProperties()

template<class TypeSequencePnts >

static Standard_Boolean Poly::PolygonProperties	(	const TypeSequencePnts &	theSeqPnts,
		Standard_Real &	theArea,
		Standard_Real &	thePerimeter
	)

inlinestatic

Returns area and perimeter of 2D-polygon given by its vertices. theArea will be negative if the polygon is bypassed clockwise and will be positive, otherwise. thePerimeter will always be positive.

ATTENTION!!! The container theSeqPnts of 2D-points gp_Pnt2d must have definition for following methods: Length(), Lower(), Upper() and Value(Standard_Integer) (e.g. it can be either NCollection_Sequence<gp_Pnt2d> or NCollection_Array1<gp_Pnt2d>).

◆ ReadPolygon2D()

static Handle< Poly_Polygon2D > Poly::ReadPolygon2D ( Standard_IStream & IS )

static

Reads a 2D polygon from the stream <IS>.

◆ ReadPolygon3D()

static Handle< Poly_Polygon3D > Poly::ReadPolygon3D ( Standard_IStream & IS )

static

Reads a 3d polygon from the stream <IS>.

◆ ReadTriangulation()

static Handle< Poly_Triangulation > Poly::ReadTriangulation ( Standard_IStream & IS )

static

Reads a triangulation from the stream <IS>.

◆ Write() [1/3]

static void Poly::Write	(	const Handle< Poly_Polygon2D > &	P,
		Standard_OStream &	OS,
		const Standard_Boolean	Compact = `Standard_True`
	)

static

Writes the content of the 2D polygon.

on the stream <OS>. If <Compact> is true this is a "save" format intended to be read back with the Read method. If compact is False it is a "Dump" format intended to be informative.

◆ Write() [2/3]

static void Poly::Write	(	const Handle< Poly_Polygon3D > &	P,
		Standard_OStream &	OS,
		const Standard_Boolean	Compact = `Standard_True`
	)

static

Writes the content of the 3D polygon.

on the stream <OS>. If <Compact> is true this is a "save" format intended to be read back with the Read method. If compact is False it is a "Dump" format intended to be informative.

◆ Write() [3/3]

static void Poly::Write	(	const Handle< Poly_Triangulation > &	T,
		Standard_OStream &	OS,
		const Standard_Boolean	Compact = `Standard_True`
	)

static

Writes the content of the triangulation <T> on the stream <OS>. If <Compact> is true this is a "save" format intended to be read back with the Read method. If compact is False it is a "Dump" format intended to be informative.

The documentation for this class was generated from the following file:

Poly.hxx

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ Catenate()

◆ ComputeNormals()

◆ Dump() [1/3]

◆ Dump() [2/3]

◆ Dump() [3/3]

◆ Intersect()

◆ IntersectTriLine()

◆ PointOnTriangle()

◆ PolygonProperties()

◆ ReadPolygon2D()

◆ ReadPolygon3D()

◆ ReadTriangulation()

◆ Write() [1/3]

◆ Write() [2/3]

◆ Write() [3/3]