One of the most significant aspects of BRepFeat functionality is the use of local
operations as opposed to global ones. In a global operation, you would first construct a
form of the type you wanted in your final feature, and then remove matter so that it could
fit into your initial basis object. In a local operation, however, you specify the domain of
the feature construction with aspects of the shape on which the feature is being created.
These semantics are expressed in terms of a member shape of the basis shape from which -
or up to which - matter will be added or removed. As a result, local operations make
calculations simpler and faster than global operations.
In BRepFeat, the semantics of local operations define features constructed from a contour or a
part of the basis shape referred to as the tool. In a SplitShape object, wires or edges of a
face in the basis shape to be used as a part of the feature are cut out and projected to a plane
outside or inside the basis shape. By rebuilding the initial shape incorporating the edges and
the faces of the tool, protrusion or depression features can be constructed.
More...

#include <BRepFeat_SplitShape.hxx>

Inheritance diagram for BRepFeat_SplitShape:

[legend]

Public Member Functions
	BRepFeat_SplitShape ()
	Empty constructor More...

	BRepFeat_SplitShape (const TopoDS_Shape &S)
	Creates the process with the shape <S>. More...

void	Init (const TopoDS_Shape &S)
	Initializes the process on the shape <S>. More...

void	SetCheckInterior (const Standard_Boolean ToCheckInterior)
	Set the flag of check internal intersections default value is True (to check) More...

void	Add (const TopoDS_Wire &W, const TopoDS_Face &F)
	Adds the wire <W> on the face <F>. <br> Raises NoSuchObject if <F> does not belong to the original shape. More...

void	Add (const TopoDS_Edge &E, const TopoDS_Face &F)
	Adds the edge <E> on the face <F>. More...

void	Add (const TopoDS_Compound &Comp, const TopoDS_Face &F)
	Adds the compound <Comp> on the face <F>. The <br> compound <Comp> must consist of edges lying on the <br> face <F>. If edges are geometrically connected, <br> they must be connected topologically, i.e. they <br> must share common vertices. <br> Raises NoSuchObject if <F> does not belong to the original shape. More...

void	Add (const TopoDS_Edge &E, const TopoDS_Edge &EOn)
	Adds the edge <E> on the existing edge <EOn>. More...

const TopTools_ListOfShape &	DirectLeft () const
	Returns the faces which are the left of the projected wires. More...

const TopTools_ListOfShape &	Left () const
	Returns the faces of the "left" part on the shape. <br> (It is build from DirectLeft, with the faces <br> connected to this set, and so on...). <br> Raises NotDone if IsDone returns <Standard_False>. More...

void	Build ()
	Builds the cut and the resulting faces and edges as well. More...

virtual Standard_Boolean	IsDeleted (const TopoDS_Shape &S)
	Returns true if the shape has been deleted. More...

const TopTools_ListOfShape &	Modified (const TopoDS_Shape &F)
	Returns the list of generated Faces. More...

Public Member Functions inherited from BRepBuilderAPI_MakeShape
virtual void	Delete ()

virtual	~BRepBuilderAPI_MakeShape ()

const TopoDS_Shape &	Shape () const
	Returns a shape built by the shape construction algorithm. <br> Raises exception StdFail_NotDone if the shape was not built. More...

	operator TopoDS_Shape () const

virtual const TopTools_ListOfShape &	Generated (const TopoDS_Shape &S)
	Returns the list of shapes generated from the shape <S>. More...

Public Member Functions inherited from BRepBuilderAPI_Command
virtual	~BRepBuilderAPI_Command ()

virtual Standard_Boolean	IsDone () const

void	Check () const
	Raises NotDone if done is false. More...

Additional Inherited Members
Protected Member Functions inherited from BRepBuilderAPI_MakeShape
	BRepBuilderAPI_MakeShape ()

Protected Member Functions inherited from BRepBuilderAPI_Command
	BRepBuilderAPI_Command ()
	Set done to False. More...

void	Done ()
	Set done to true. More...

void	NotDone ()
	Set done to false. More...

Protected Attributes inherited from BRepBuilderAPI_MakeShape
TopoDS_Shape	myShape

TopTools_ListOfShape	myGenerated

Detailed Description

One of the most significant aspects of BRepFeat functionality is the use of local
operations as opposed to global ones. In a global operation, you would first construct a
form of the type you wanted in your final feature, and then remove matter so that it could
fit into your initial basis object. In a local operation, however, you specify the domain of
the feature construction with aspects of the shape on which the feature is being created.
These semantics are expressed in terms of a member shape of the basis shape from which -
or up to which - matter will be added or removed. As a result, local operations make
calculations simpler and faster than global operations.
In BRepFeat, the semantics of local operations define features constructed from a contour or a
part of the basis shape referred to as the tool. In a SplitShape object, wires or edges of a
face in the basis shape to be used as a part of the feature are cut out and projected to a plane
outside or inside the basis shape. By rebuilding the initial shape incorporating the edges and
the faces of the tool, protrusion or depression features can be constructed.

Constructor & Destructor Documentation

BRepFeat_SplitShape::BRepFeat_SplitShape ( )

Empty constructor

BRepFeat_SplitShape::BRepFeat_SplitShape ( const TopoDS_Shape & S )

Creates the process with the shape <S>.

Member Function Documentation

void BRepFeat_SplitShape::Add	(	const TopoDS_Wire &	W,
		const TopoDS_Face &	F
	)

 Adds the wire <W> on the face <F>. <br>

Raises NoSuchObject if <F> does not belong to the original shape.

void BRepFeat_SplitShape::Add	(	const TopoDS_Edge &	E,
		const TopoDS_Face &	F
	)

Adds the edge <E> on the face <F>.

void BRepFeat_SplitShape::Add	(	const TopoDS_Compound &	Comp,
		const TopoDS_Face &	F
	)

 Adds the compound <Comp> on the face <F>. The <br>
     compound <Comp> must consist of edges lying on the <br>
     face <F>. If edges are geometrically connected, <br>
     they must be connected topologically, i.e. they <br>
     must share common vertices. <br>

Raises NoSuchObject if <F> does not belong to the original shape.

void BRepFeat_SplitShape::Add	(	const TopoDS_Edge &	E,
		const TopoDS_Edge &	EOn
	)

Adds the edge <E> on the existing edge <EOn>.

void BRepFeat_SplitShape::Build ( )

virtual

Builds the cut and the resulting faces and edges as well.

Reimplemented from BRepBuilderAPI_MakeShape.

const TopTools_ListOfShape& BRepFeat_SplitShape::DirectLeft ( ) const

Returns the faces which are the left of the
projected wires.

void BRepFeat_SplitShape::Init ( const TopoDS_Shape & S )

Initializes the process on the shape <S>.

virtual Standard_Boolean BRepFeat_SplitShape::IsDeleted ( const TopoDS_Shape & S )

virtual

Returns true if the shape has been deleted.

Reimplemented from BRepBuilderAPI_MakeShape.

const TopTools_ListOfShape& BRepFeat_SplitShape::Left ( ) const

 Returns the faces of the "left" part on the shape. <br>
     (It  is build   from  DirectLeft,  with  the faces <br>
     connected to this set, and so on...). <br>

Raises NotDone if IsDone returns <Standard_False>.

const TopTools_ListOfShape& BRepFeat_SplitShape::Modified ( const TopoDS_Shape & F )

virtual

Returns the list of generated Faces.

Reimplemented from BRepBuilderAPI_MakeShape.

void BRepFeat_SplitShape::SetCheckInterior ( const Standard_Boolean ToCheckInterior )

Set the flag of check internal intersections
default value is True (to check)

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

BRepFeat_SplitShape.hxx

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation