The class contains handy static functions dealing with the topology This is the copy of BOPTools_AlgoTools3D.cdl file. More...

#include <BOPTools_AlgoTools3D.hxx>

Static Public Member Functions
static bool	DoSplitSEAMOnFace (const TopoDS_Edge &theESplit, const TopoDS_Face &theFace)
	Makes the edge <theESplit> seam edge for the face <theFace> basing on the surface properties (U and V periods)

static bool	DoSplitSEAMOnFace (const TopoDS_Edge &theEOrigin, const TopoDS_Edge &theESplit, const TopoDS_Face &theFace)
	Makes the split edge <theESplit> seam edge for the face <theFace> basing on the positions of 2d curves of the original edge <theEOrigin>.

static void	GetNormalToFaceOnEdge (const TopoDS_Edge &aE, const TopoDS_Face &aF, const double aT, gp_Dir &aD, const occ::handle< IntTools_Context > &theContext=occ::handle< IntTools_Context >())
	Computes normal to the face <aF> for the point on the edge <aE> at parameter <aT>. <theContext> - storage for caching the geometrical tools.

static void	GetNormalToFaceOnEdge (const TopoDS_Edge &aE, const TopoDS_Face &aF, gp_Dir &aD, const occ::handle< IntTools_Context > &theContext=occ::handle< IntTools_Context >())
	Computes normal to the face <aF> for the point on the edge <aE> at arbitrary intermediate parameter. <theContext> - storage for caching the geometrical tools.

static int	SenseFlag (const gp_Dir &aNF1, const gp_Dir &aNF2)
	Returns 1 if scalar product aNF1* aNF2>0. Returns 0 if directions aNF1 aNF2 coincide Returns -1 if scalar product aNF1* aNF2<0.

static bool	GetNormalToSurface (const occ::handle< Geom_Surface > &aS, const double U, const double V, gp_Dir &aD)
	Compute normal <aD> to surface <aS> in point (U,V) Returns TRUE if directions aD1U, aD1V coincide.

static bool	GetApproxNormalToFaceOnEdge (const TopoDS_Edge &aE, const TopoDS_Face &aF, const double aT, gp_Pnt &aPx, gp_Dir &aD, const occ::handle< IntTools_Context > &theContext)
	Computes normal to the face <aF> for the 3D-point that belongs to the edge <aE> at parameter <aT>. Output: aPx - the 3D-point where the normal computed aD - the normal; Warning: The normal is computed not exactly in the point on the edge, but in point that is near to the edge towards to the face material (so, we'll have approx. normal); The point is computed using PointNearEdge function, with the shifting value BOPTools_AlgoTools3D::MinStepIn2d(), from the edge, but if this value is too big, the point will be computed using Hatcher (PointInFace function). Returns TRUE in case of success.

static bool	GetApproxNormalToFaceOnEdge (const TopoDS_Edge &theE, const TopoDS_Face &theF, const double aT, gp_Pnt &aP, gp_Dir &aDNF, const double aDt2D)
	Computes normal to the face <aF> for the 3D-point that belongs to the edge <aE> at parameter <aT>. Output: aPx - the 3D-point where the normal computed aD - the normal; Warning: The normal is computed not exactly in the point on the edge, but in point that is near to the edge towards to the face material (so, we'll have approx. normal); The point is computed using PointNearEdge function with the shifting value <aDt2D> from the edge; No checks on this value will be done. Returns TRUE in case of success.

static bool	GetApproxNormalToFaceOnEdge (const TopoDS_Edge &theE, const TopoDS_Face &theF, const double aT, const double aDt2D, gp_Pnt &aP, gp_Dir &aDNF, const occ::handle< IntTools_Context > &theContext)
	Computes normal to the face <aF> for the 3D-point that belongs to the edge <aE> at parameter <aT>. Output: aPx - the 3D-point where the normal computed aD - the normal; Warning: The normal is computed not exactly in the point on the edge, but in point that is near to the edge towards to the face material (so, we'll have approx. normal); The point is computed using PointNearEdge function with the shifting value <aDt2D> from the edge, but if this value is too big the point will be computed using Hatcher (PointInFace function). Returns TRUE in case of success.

static int	PointNearEdge (const TopoDS_Edge &aE, const TopoDS_Face &aF, const double aT, const double aDt2D, gp_Pnt2d &aP2D, gp_Pnt &aPx, const occ::handle< IntTools_Context > &theContext)
	Compute the point <aPx>, (<aP2D>) that is near to the edge <aE> at parameter <aT> towards to the material of the face <aF>. The value of shifting in 2D is <aDt2D> If the value of shifting is too big the point will be computed using Hatcher (PointInFace function). Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>; 2 - the computed point is out of the face.

static int	PointNearEdge (const TopoDS_Edge &aE, const TopoDS_Face &aF, const double aT, const double aDt2D, gp_Pnt2d &aP2D, gp_Pnt &aPx)
	Compute the point <aPx>, (<aP2D>) that is near to the edge <aE> at parameter <aT> towards to the material of the face <aF>. The value of shifting in 2D is <aDt2D>. No checks on this value will be done. Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>.

static int	PointNearEdge (const TopoDS_Edge &aE, const TopoDS_Face &aF, const double aT, gp_Pnt2d &aP2D, gp_Pnt &aPx, const occ::handle< IntTools_Context > &theContext)
	Computes the point <aPx>, (<aP2D>) that is near to the edge <aE> at parameter <aT> towards to the material of the face <aF>. The value of shifting in 2D is dt2D=BOPTools_AlgoTools3D::MinStepIn2d() If the value of shifting is too big the point will be computed using Hatcher (PointInFace function). Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>; 2 - the computed point is out of the face.

static int	PointNearEdge (const TopoDS_Edge &aE, const TopoDS_Face &aF, gp_Pnt2d &aP2D, gp_Pnt &aPx, const occ::handle< IntTools_Context > &theContext)
	Compute the point <aPx>, (<aP2D>) that is near to the edge <aE> at arbitrary parameter towards to the material of the face <aF>. The value of shifting in 2D is dt2D=BOPTools_AlgoTools3D::MinStepIn2d(). If the value of shifting is too big the point will be computed using Hatcher (PointInFace function). Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>; 2 - the computed point is out of the face.

static double	MinStepIn2d ()
	Returns simple step value that is used in 2D-computations = 1.e-5.

static bool	IsEmptyShape (const TopoDS_Shape &aS)
	Returns TRUE if the shape <aS> does not contain geometry information (e.g. empty compound)

static void	OrientEdgeOnFace (const TopoDS_Edge &aE, const TopoDS_Face &aF, TopoDS_Edge &aER)
	Get the edge <aER> from the face <aF> that is the same as the edge <aE>

static int	PointInFace (const TopoDS_Face &theF, gp_Pnt &theP, gp_Pnt2d &theP2D, const occ::handle< IntTools_Context > &theContext)
	Computes arbitrary point <theP> inside the face <theF>. <theP2D> - 2D representation of <theP> on the surface of <theF> Returns 0 in case of success.

static int	PointInFace (const TopoDS_Face &theF, const TopoDS_Edge &theE, const double theT, const double theDt2D, gp_Pnt &theP, gp_Pnt2d &theP2D, const occ::handle< IntTools_Context > &theContext)
	Computes a point <theP> inside the face <theF> using starting point taken by the parameter <theT> from the 2d curve of the edge <theE> on the face <theF> in the direction perpendicular to the tangent vector of the 2d curve of the edge. The point will be distanced on <theDt2D> from the 2d curve. <theP2D> - 2D representation of <theP> on the surface of <theF> Returns 0 in case of success.

static int	PointInFace (const TopoDS_Face &theF, const occ::handle< Geom2d_Curve > &theL, gp_Pnt &theP, gp_Pnt2d &theP2D, const occ::handle< IntTools_Context > &theContext, const double theDt2D=0.0)
	Computes a point <theP> inside the face <theF> using the line <theL> so that 2D point <theP2D>, 2D representation of <theP> on the surface of <theF>, lies on that line. Returns 0 in case of success.

Detailed Description

The class contains handy static functions dealing with the topology This is the copy of BOPTools_AlgoTools3D.cdl file.

Member Function Documentation

◆ DoSplitSEAMOnFace() [1/2]

static bool BOPTools_AlgoTools3D::DoSplitSEAMOnFace	(	const TopoDS_Edge &	theEOrigin,
		const TopoDS_Edge &	theESplit,
		const TopoDS_Face &	theFace )

static

Makes the split edge <theESplit> seam edge for the face <theFace> basing on the positions of 2d curves of the original edge <theEOrigin>.

◆ DoSplitSEAMOnFace() [2/2]

static bool BOPTools_AlgoTools3D::DoSplitSEAMOnFace	(	const TopoDS_Edge &	theESplit,
		const TopoDS_Face &	theFace )

static

Makes the edge <theESplit> seam edge for the face <theFace> basing on the surface properties (U and V periods)

◆ GetApproxNormalToFaceOnEdge() [1/3]

static bool BOPTools_AlgoTools3D::GetApproxNormalToFaceOnEdge	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		const double	aT,
		gp_Pnt &	aPx,
		gp_Dir &	aD,
		const occ::handle< IntTools_Context > &	theContext )

static

Computes normal to the face <aF> for the 3D-point that belongs to the edge <aE> at parameter <aT>. Output: aPx - the 3D-point where the normal computed aD - the normal; Warning: The normal is computed not exactly in the point on the edge, but in point that is near to the edge towards to the face material (so, we'll have approx. normal); The point is computed using PointNearEdge function, with the shifting value BOPTools_AlgoTools3D::MinStepIn2d(), from the edge, but if this value is too big, the point will be computed using Hatcher (PointInFace function). Returns TRUE in case of success.

◆ GetApproxNormalToFaceOnEdge() [2/3]

static bool BOPTools_AlgoTools3D::GetApproxNormalToFaceOnEdge	(	const TopoDS_Edge &	theE,
		const TopoDS_Face &	theF,
		const double	aT,
		const double	aDt2D,
		gp_Pnt &	aP,
		gp_Dir &	aDNF,
		const occ::handle< IntTools_Context > &	theContext )

static

Computes normal to the face <aF> for the 3D-point that belongs to the edge <aE> at parameter <aT>. Output: aPx - the 3D-point where the normal computed aD - the normal; Warning: The normal is computed not exactly in the point on the edge, but in point that is near to the edge towards to the face material (so, we'll have approx. normal); The point is computed using PointNearEdge function with the shifting value <aDt2D> from the edge, but if this value is too big the point will be computed using Hatcher (PointInFace function). Returns TRUE in case of success.

◆ GetApproxNormalToFaceOnEdge() [3/3]

static bool BOPTools_AlgoTools3D::GetApproxNormalToFaceOnEdge	(	const TopoDS_Edge &	theE,
		const TopoDS_Face &	theF,
		const double	aT,
		gp_Pnt &	aP,
		gp_Dir &	aDNF,
		const double	aDt2D )

static

Computes normal to the face <aF> for the 3D-point that belongs to the edge <aE> at parameter <aT>. Output: aPx - the 3D-point where the normal computed aD - the normal; Warning: The normal is computed not exactly in the point on the edge, but in point that is near to the edge towards to the face material (so, we'll have approx. normal); The point is computed using PointNearEdge function with the shifting value <aDt2D> from the edge; No checks on this value will be done. Returns TRUE in case of success.

◆ GetNormalToFaceOnEdge() [1/2]

static void BOPTools_AlgoTools3D::GetNormalToFaceOnEdge	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		const double	aT,
		gp_Dir &	aD,
		const occ::handle< IntTools_Context > &	theContext = occ::handle< IntTools_Context >() )

static

Computes normal to the face <aF> for the point on the edge <aE> at parameter <aT>. <theContext> - storage for caching the geometrical tools.

◆ GetNormalToFaceOnEdge() [2/2]

static void BOPTools_AlgoTools3D::GetNormalToFaceOnEdge	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		gp_Dir &	aD,
		const occ::handle< IntTools_Context > &	theContext = occ::handle< IntTools_Context >() )

static

Computes normal to the face <aF> for the point on the edge <aE> at arbitrary intermediate parameter. <theContext> - storage for caching the geometrical tools.

◆ GetNormalToSurface()

static bool BOPTools_AlgoTools3D::GetNormalToSurface	(	const occ::handle< Geom_Surface > &	aS,
		const double	U,
		const double	V,
		gp_Dir &	aD )

static

Compute normal <aD> to surface <aS> in point (U,V) Returns TRUE if directions aD1U, aD1V coincide.

◆ IsEmptyShape()

static bool BOPTools_AlgoTools3D::IsEmptyShape ( const TopoDS_Shape & aS )

static

Returns TRUE if the shape <aS> does not contain geometry information (e.g. empty compound)

◆ MinStepIn2d()

static double BOPTools_AlgoTools3D::MinStepIn2d ( )

static

Returns simple step value that is used in 2D-computations = 1.e-5.

◆ OrientEdgeOnFace()

static void BOPTools_AlgoTools3D::OrientEdgeOnFace	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		TopoDS_Edge &	aER )

static

Get the edge <aER> from the face <aF> that is the same as the edge <aE>

◆ PointInFace() [1/3]

static int BOPTools_AlgoTools3D::PointInFace	(	const TopoDS_Face &	theF,
		const occ::handle< Geom2d_Curve > &	theL,
		gp_Pnt &	theP,
		gp_Pnt2d &	theP2D,
		const occ::handle< IntTools_Context > &	theContext,
		const double	theDt2D = 0.0 )

static

Computes a point <theP> inside the face <theF> using the line <theL> so that 2D point <theP2D>, 2D representation of <theP> on the surface of <theF>, lies on that line. Returns 0 in case of success.

◆ PointInFace() [2/3]

static int BOPTools_AlgoTools3D::PointInFace	(	const TopoDS_Face &	theF,
		const TopoDS_Edge &	theE,
		const double	theT,
		const double	theDt2D,
		gp_Pnt &	theP,
		gp_Pnt2d &	theP2D,
		const occ::handle< IntTools_Context > &	theContext )

static

Computes a point <theP> inside the face <theF> using starting point taken by the parameter <theT> from the 2d curve of the edge <theE> on the face <theF> in the direction perpendicular to the tangent vector of the 2d curve of the edge. The point will be distanced on <theDt2D> from the 2d curve. <theP2D> - 2D representation of <theP> on the surface of <theF> Returns 0 in case of success.

◆ PointInFace() [3/3]

static int BOPTools_AlgoTools3D::PointInFace	(	const TopoDS_Face &	theF,
		gp_Pnt &	theP,
		gp_Pnt2d &	theP2D,
		const occ::handle< IntTools_Context > &	theContext )

static

Computes arbitrary point <theP> inside the face <theF>. <theP2D> - 2D representation of <theP> on the surface of <theF> Returns 0 in case of success.

◆ PointNearEdge() [1/4]

static int BOPTools_AlgoTools3D::PointNearEdge	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		const double	aT,
		const double	aDt2D,
		gp_Pnt2d &	aP2D,
		gp_Pnt &	aPx )

static

Compute the point <aPx>, (<aP2D>) that is near to the edge <aE> at parameter <aT> towards to the material of the face <aF>. The value of shifting in 2D is <aDt2D>. No checks on this value will be done. Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>.

◆ PointNearEdge() [2/4]

static int BOPTools_AlgoTools3D::PointNearEdge	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		const double	aT,
		const double	aDt2D,
		gp_Pnt2d &	aP2D,
		gp_Pnt &	aPx,
		const occ::handle< IntTools_Context > &	theContext )

static

Compute the point <aPx>, (<aP2D>) that is near to the edge <aE> at parameter <aT> towards to the material of the face <aF>. The value of shifting in 2D is <aDt2D> If the value of shifting is too big the point will be computed using Hatcher (PointInFace function). Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>; 2 - the computed point is out of the face.

◆ PointNearEdge() [3/4]

static int BOPTools_AlgoTools3D::PointNearEdge	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		const double	aT,
		gp_Pnt2d &	aP2D,
		gp_Pnt &	aPx,
		const occ::handle< IntTools_Context > &	theContext )

static

Computes the point <aPx>, (<aP2D>) that is near to the edge <aE> at parameter <aT> towards to the material of the face <aF>. The value of shifting in 2D is dt2D=BOPTools_AlgoTools3D::MinStepIn2d() If the value of shifting is too big the point will be computed using Hatcher (PointInFace function). Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>; 2 - the computed point is out of the face.

◆ PointNearEdge() [4/4]

static int BOPTools_AlgoTools3D::PointNearEdge	(	const TopoDS_Edge &	aE,
		const TopoDS_Face &	aF,
		gp_Pnt2d &	aP2D,
		gp_Pnt &	aPx,
		const occ::handle< IntTools_Context > &	theContext )

static

Compute the point <aPx>, (<aP2D>) that is near to the edge <aE> at arbitrary parameter towards to the material of the face <aF>. The value of shifting in 2D is dt2D=BOPTools_AlgoTools3D::MinStepIn2d(). If the value of shifting is too big the point will be computed using Hatcher (PointInFace function). Returns error status: 0 - in case of success; 1 - <aE> does not have 2d curve on the face <aF>; 2 - the computed point is out of the face.

◆ SenseFlag()

static int BOPTools_AlgoTools3D::SenseFlag	(	const gp_Dir &	aNF1,
		const gp_Dir &	aNF2 )

static

Returns 1 if scalar product aNF1* aNF2>0. Returns 0 if directions aNF1 aNF2 coincide Returns -1 if scalar product aNF1* aNF2<0.

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

BOPTools_AlgoTools3D.hxx

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ DoSplitSEAMOnFace() [1/2]

◆ DoSplitSEAMOnFace() [2/2]

◆ GetApproxNormalToFaceOnEdge() [1/3]

◆ GetApproxNormalToFaceOnEdge() [2/3]

◆ GetApproxNormalToFaceOnEdge() [3/3]

◆ GetNormalToFaceOnEdge() [1/2]

◆ GetNormalToFaceOnEdge() [2/2]

◆ GetNormalToSurface()

◆ IsEmptyShape()

◆ MinStepIn2d()

◆ OrientEdgeOnFace()

◆ PointInFace() [1/3]

◆ PointInFace() [2/3]

◆ PointInFace() [3/3]

◆ PointNearEdge() [1/4]

◆ PointNearEdge() [2/4]

◆ PointNearEdge() [3/4]

◆ PointNearEdge() [4/4]

◆ SenseFlag()