ShapeAnalysis_FreeBoundsProperties Class Reference

This class is intended to calculate shape free bounds
properties.
This class provides the following functionalities:
More...

#include <ShapeAnalysis_FreeBoundsProperties.hxx>

Public Member Functions
	ShapeAnalysis_FreeBoundsProperties ()
	Empty constructor More...
	ShapeAnalysis_FreeBoundsProperties (const TopoDS_Shape &shape, const Standard_Real tolerance, const Standard_Boolean splitclosed=Standard_False, const Standard_Boolean splitopen=Standard_False)
	Creates the object and calls corresponding Init. <shape> should be a compound of faces. More...
	ShapeAnalysis_FreeBoundsProperties (const TopoDS_Shape &shape, const Standard_Boolean splitclosed=Standard_False, const Standard_Boolean splitopen=Standard_False)
	Creates the object and calls corresponding Init. <shape> should be a compound of shells. More...
void	Init (const TopoDS_Shape &shape, const Standard_Real tolerance, const Standard_Boolean splitclosed=Standard_False, const Standard_Boolean splitopen=Standard_False)
	Initializes the object with given parameters. <shape> should be a compound of faces. More...
void	Init (const TopoDS_Shape &shape, const Standard_Boolean splitclosed=Standard_False, const Standard_Boolean splitopen=Standard_False)
	Initializes the object with given parameters. <shape> should be a compound of shells. More...
Standard_Boolean	Perform ()
	Builds and analyzes free bounds of the shape. First calls ShapeAnalysis_FreeBounds for building free bounds. Then on each free bound computes its properties: More...
Standard_Boolean	IsLoaded () const
	Returns True if shape is loaded More...
TopoDS_Shape	Shape () const
	Returns shape More...
Standard_Real	Tolerance () const
	Returns tolerance More...
Standard_Integer	NbFreeBounds () const
	Returns number of free bounds More...
Standard_Integer	NbClosedFreeBounds () const
	Returns number of closed free bounds More...
Standard_Integer	NbOpenFreeBounds () const
	Returns number of open free bounds More...
Handle_ShapeAnalysis_HSequenceOfFreeBounds	ClosedFreeBounds () const
	Returns all closed free bounds More...
Handle_ShapeAnalysis_HSequenceOfFreeBounds	OpenFreeBounds () const
	Returns all open free bounds More...
Handle_ShapeAnalysis_FreeBoundData	ClosedFreeBound (const Standard_Integer index) const
	Returns properties of closed free bound specified by its rank number More...
Handle_ShapeAnalysis_FreeBoundData	OpenFreeBound (const Standard_Integer index) const
	Returns properties of open free bound specified by its rank number More...
Standard_Boolean	DispatchBounds ()
Standard_Boolean	CheckContours (const Standard_Real prec=0.0)
Standard_Boolean	CheckNotches (const Standard_Real prec=0.0)
Standard_Boolean	CheckNotches (Handle< ShapeAnalysis_FreeBoundData > &fbData, const Standard_Real prec=0.0)
Standard_Boolean	CheckNotches (const TopoDS_Wire &freebound, const Standard_Integer num, TopoDS_Wire &notch, Standard_Real &distMax, const Standard_Real prec=0.0)
Standard_Boolean	FillProperties (Handle< ShapeAnalysis_FreeBoundData > &fbData, const Standard_Real prec=0.0)

Detailed Description

This class is intended to calculate shape free bounds
properties.
This class provides the following functionalities:

     - calculates area of the contour, <br>
     - calculates perimeter of the contour, <br>
     - calculates ratio of average length to average width of the <br>
       contour, <br>
     - estimates average width of contour, <br>
     - finds the notches (narrow 'V'-like sub-contour) on the <br>
       contour. <br>

For getting free bounds this class uses
ShapeAnalysis_FreeBounds class.

For description of parameters used for initializing this
class refer to CDL of ShapeAnalysis_FreeBounds.

Properties of each contour are stored in the data structure
ShapeAnalysis_FreeBoundData.

Constructor & Destructor Documentation

ShapeAnalysis_FreeBoundsProperties::ShapeAnalysis_FreeBoundsProperties

(

)

Empty constructor

ShapeAnalysis_FreeBoundsProperties::ShapeAnalysis_FreeBoundsProperties	(	const TopoDS_Shape &	shape,
		const Standard_Real	tolerance,
		const Standard_Boolean	splitclosed = Standard_False,
		const Standard_Boolean	splitopen = Standard_False
	)

Creates the object and calls corresponding Init.
<shape> should be a compound of faces.

ShapeAnalysis_FreeBoundsProperties::ShapeAnalysis_FreeBoundsProperties	(	const TopoDS_Shape &	shape,
		const Standard_Boolean	splitclosed = Standard_False,
		const Standard_Boolean	splitopen = Standard_False
	)

Creates the object and calls corresponding Init.
<shape> should be a compound of shells.

Member Function Documentation

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::CheckContours

(

const Standard_Real

prec = 0.0

)

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::CheckNotches

(

const Standard_Real

prec = 0.0

)

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::CheckNotches	(	Handle< ShapeAnalysis_FreeBoundData > &	fbData,
		const Standard_Real	prec = 0.0
	)

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::CheckNotches	(	const TopoDS_Wire &	freebound,
		const Standard_Integer	num,
		TopoDS_Wire &	notch,
		Standard_Real &	distMax,
		const Standard_Real	prec = 0.0
	)

Handle_ShapeAnalysis_FreeBoundData ShapeAnalysis_FreeBoundsProperties::ClosedFreeBound

(

const Standard_Integer

index

)

const

Returns properties of closed free bound specified by its rank
number

Handle_ShapeAnalysis_HSequenceOfFreeBounds ShapeAnalysis_FreeBoundsProperties::ClosedFreeBounds

(

)

const

Returns all closed free bounds

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::DispatchBounds

(

)

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::FillProperties	(	Handle< ShapeAnalysis_FreeBoundData > &	fbData,
		const Standard_Real	prec = 0.0
	)

void ShapeAnalysis_FreeBoundsProperties::Init	(	const TopoDS_Shape &	shape,
		const Standard_Real	tolerance,
		const Standard_Boolean	splitclosed = Standard_False,
		const Standard_Boolean	splitopen = Standard_False
	)

Initializes the object with given parameters.
<shape> should be a compound of faces.

void ShapeAnalysis_FreeBoundsProperties::Init	(	const TopoDS_Shape &	shape,
		const Standard_Boolean	splitclosed = Standard_False,
		const Standard_Boolean	splitopen = Standard_False
	)

Initializes the object with given parameters.
<shape> should be a compound of shells.

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::IsLoaded

(

)

const

Returns True if shape is loaded

Standard_Integer ShapeAnalysis_FreeBoundsProperties::NbClosedFreeBounds

(

)

const

Returns number of closed free bounds

Standard_Integer ShapeAnalysis_FreeBoundsProperties::NbFreeBounds

(

)

const

Returns number of free bounds

Standard_Integer ShapeAnalysis_FreeBoundsProperties::NbOpenFreeBounds

(

)

const

Returns number of open free bounds

Handle_ShapeAnalysis_FreeBoundData ShapeAnalysis_FreeBoundsProperties::OpenFreeBound

(

const Standard_Integer

index

)

const

Returns properties of open free bound specified by its rank
number

Handle_ShapeAnalysis_HSequenceOfFreeBounds ShapeAnalysis_FreeBoundsProperties::OpenFreeBounds

(

)

const

Returns all open free bounds

Standard_Boolean ShapeAnalysis_FreeBoundsProperties::Perform

(

)

Builds and analyzes free bounds of the shape.
First calls ShapeAnalysis_FreeBounds for building free
bounds.
Then on each free bound computes its properties:

• area of the contour,
  
• perimeter of the contour,
  
• ratio of average length to average width of the contour,
  
• average width of contour,
  
• notches on the contour and for each notch
  
  • maximum width of the notch.
    

TopoDS_Shape ShapeAnalysis_FreeBoundsProperties::Shape

(

)

const

Returns shape

Standard_Real ShapeAnalysis_FreeBoundsProperties::Tolerance

(

)

const

Returns tolerance

---

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

• ShapeAnalysis_FreeBoundsProperties.hxx