BRepLib_PointCloudShape Class Reference

This tool is intended to get points from shape with specified distance from shape along normal. Can be used to simulation of points obtained in result of laser scan of shape. There are 2 ways for generation points by shape: More...

#include <BRepLib_PointCloudShape.hxx>

Public Member Functions
	BRepLib_PointCloudShape (const TopoDS_Shape &theShape=TopoDS_Shape(), const Standard_Real theTol=Precision::Confusion())
	Constructor initialized by shape.
virtual	~BRepLib_PointCloudShape ()
	Virtual destructor.
const TopoDS_Shape &	Shape () const
	Return loaded shape.
void	SetShape (const TopoDS_Shape &theShape)
	Set shape.
Standard_Real	Tolerance () const
	Return tolerance.
void	SetTolerance (Standard_Real theTol)
	Set tolerance.
Standard_Real	GetDistance () const
	Returns value of the distance to define deflection of points from shape along normal to shape; 0.0 by default.
void	SetDistance (const Standard_Real theDist)
	Sets value of the distance to define deflection of points from shape along normal to shape. Negative values of theDist parameter are ignored.
Standard_Integer	NbPointsByDensity (const Standard_Real theDensity=0.0)
	Returns size of the point cloud for specified density.
Standard_Integer	NbPointsByTriangulation () const
	Returns size of the point cloud for using triangulation.
Standard_Boolean	GeneratePointsByDensity (const Standard_Real theDensity=0.0)
	Computes points with specified density for initial shape. If parameter Density is equal to 0 then density will be computed automatically by criterion:
Standard_Boolean	GeneratePointsByTriangulation ()
	Get points from triangulation existing in the shape.

Protected Member Functions
Standard_Real	faceArea (const TopoDS_Shape &theShape)
	Compute area of the specified face.
Standard_Real	computeDensity ()
	Computes default density points per face.
Standard_Boolean	addDensityPoints (const TopoDS_Shape &theFace)
	Adds points to face in accordance with the specified density randomly in the specified range [0, Dist].
Standard_Boolean	addTriangulationPoints (const TopoDS_Shape &theFace)
	Adds points to face by nodes of the existing triangulation randomly in the specified range [0, Dist].
virtual void	clear ()
	Method to clear maps.
virtual void	addPoint (const gp_Pnt &thePoint, const gp_Vec &theNorm, const gp_Pnt2d &theUV, const TopoDS_Shape &theFace)=0
	Method to add point, normal to surface in this point and face for which point computed.

Protected Attributes
TopoDS_Shape	myShape
Standard_Real	myDist
Standard_Real	myTol
TopTools_DataMapOfShapeReal	myFaceArea
TopTools_DataMapOfShapeInteger	myFacePoints
Standard_Integer	myNbPoints

Detailed Description

This tool is intended to get points from shape with specified distance from shape along normal. Can be used to simulation of points obtained in result of laser scan of shape. There are 2 ways for generation points by shape:

1. Generation points with specified density
2. Generation points using triangulation Nodes Generation of points by density using the GeneratePointsByDensity() function is not thread safe.

Constructor & Destructor Documentation

BRepLib_PointCloudShape()

BRepLib_PointCloudShape::BRepLib_PointCloudShape	(	const TopoDS_Shape &	theShape = TopoDS_Shape(),
		const Standard_Real	theTol = Precision::Confusion()
	)

Constructor initialized by shape.

~BRepLib_PointCloudShape()

virtual BRepLib_PointCloudShape::~BRepLib_PointCloudShape ( )

virtual

Virtual destructor.

Member Function Documentation

addDensityPoints()

Standard_Boolean BRepLib_PointCloudShape::addDensityPoints ( const TopoDS_Shape &  theFace )

protected

Adds points to face in accordance with the specified density randomly in the specified range [0, Dist].

addPoint()

virtual void BRepLib_PointCloudShape::addPoint ( const gp_Pnt &  thePoint, const gp_Vec &  theNorm, const gp_Pnt2d &  theUV, const TopoDS_Shape &  theFace  )

protectedpure virtual

Method to add point, normal to surface in this point and face for which point computed.

Parameters

[in]	thePoint	3D point on the surface
[in]	theNorm	surface normal at this point
[in]	theUV	surface UV parameters
[in]	theFace	surface (face) definition

addTriangulationPoints()

Standard_Boolean BRepLib_PointCloudShape::addTriangulationPoints ( const TopoDS_Shape &  theFace )

protected

Adds points to face by nodes of the existing triangulation randomly in the specified range [0, Dist].

clear()

virtual void BRepLib_PointCloudShape::clear ( )

protectedvirtual

Method to clear maps.

computeDensity()

Standard_Real BRepLib_PointCloudShape::computeDensity ( )

protected

Computes default density points per face.

faceArea()

Standard_Real BRepLib_PointCloudShape::faceArea ( const TopoDS_Shape &  theShape )

protected

Compute area of the specified face.

GeneratePointsByDensity()

Standard_Boolean BRepLib_PointCloudShape::GeneratePointsByDensity

(

const Standard_Real

theDensity = 0.0

)

Computes points with specified density for initial shape. If parameter Density is equal to 0 then density will be computed automatically by criterion:

• 10 points per minimal unreduced face area.

Note: this function should not be called from concurrent threads without external lock.

GeneratePointsByTriangulation()

Standard_Boolean BRepLib_PointCloudShape::GeneratePointsByTriangulation

(

)

Get points from triangulation existing in the shape.

GetDistance()

Standard_Real BRepLib_PointCloudShape::GetDistance ( ) const

inline

Returns value of the distance to define deflection of points from shape along normal to shape; 0.0 by default.

NbPointsByDensity()

Standard_Integer BRepLib_PointCloudShape::NbPointsByDensity

(

const Standard_Real

theDensity = 0.0

)

Returns size of the point cloud for specified density.

NbPointsByTriangulation()

Standard_Integer BRepLib_PointCloudShape::NbPointsByTriangulation

(

)

const

Returns size of the point cloud for using triangulation.

SetDistance()

void BRepLib_PointCloudShape::SetDistance ( const Standard_Real  theDist )

inline

Sets value of the distance to define deflection of points from shape along normal to shape. Negative values of theDist parameter are ignored.

SetShape()

void BRepLib_PointCloudShape::SetShape ( const TopoDS_Shape &  theShape )

inline

Set shape.

SetTolerance()

void BRepLib_PointCloudShape::SetTolerance ( Standard_Real  theTol )

inline

Set tolerance.

Shape()

const TopoDS_Shape & BRepLib_PointCloudShape::Shape ( ) const

inline

Return loaded shape.

Tolerance()

Standard_Real BRepLib_PointCloudShape::Tolerance ( ) const

inline

Return tolerance.

Field Documentation

myDist

Standard_Real BRepLib_PointCloudShape::myDist

protected

myFaceArea

TopTools_DataMapOfShapeReal BRepLib_PointCloudShape::myFaceArea

protected

myFacePoints

TopTools_DataMapOfShapeInteger BRepLib_PointCloudShape::myFacePoints

protected

myNbPoints

Standard_Integer BRepLib_PointCloudShape::myNbPoints

protected

myShape

TopoDS_Shape BRepLib_PointCloudShape::myShape

protected

myTol

Standard_Real BRepLib_PointCloudShape::myTol

protected

---

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

• BRepLib_PointCloudShape.hxx