The class is a General Fuse algorithm - base algorithm for the algorithms in the Boolean Component. Its main purpose is to build the split parts of the argument shapes from which the result of the operations is combined.
The result of the General Fuse algorithm itself is a compound containing all split parts of the arguments.
More...

#include <BOPAlgo_Builder.hxx>

Inheritance diagram for BOPAlgo_Builder:

[legend]

Data Structures
class	NbShapes
	Auxiliary structure to get information about number of shapes of each type participated in operation. More...

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

virtual	~BOPAlgo_Builder ()

	BOPAlgo_Builder (const Handle< NCollection_BaseAllocator > &theAllocator)

virtual void	Clear () override
	Clears the content of the algorithm. More...

BOPAlgo_PPaveFiller	PPaveFiller ()
	Returns the PaveFiller, algorithm for sub-shapes intersection. More...

BOPDS_PDS	PDS ()
	Returns the Data Structure, holder of intersection information. More...

Handle< IntTools_Context >	Context () const
	Returns the Context, tool for cashing heavy algorithms. More...

Arguments
virtual void	AddArgument (const TopoDS_Shape &theShape)
	Adds the argument to the operation. More...

virtual void	SetArguments (const TopTools_ListOfShape &theLS)
	Sets the list of arguments for the operation. More...

const TopTools_ListOfShape &	Arguments () const
	Returns the list of arguments. More...

Options
void	SetNonDestructive (const Standard_Boolean theFlag)
	Sets the flag that defines the mode of treatment. In non-destructive mode the argument shapes are not modified. Instead a copy of a sub-shape is created in the result if it is needed to be updated. This flag is taken into account if internal PaveFiller is used only. In the case of calling PerformWithFiller the corresponding flag of that PaveFiller is in force. More...

Standard_Boolean	NonDestructive () const
	Returns the flag that defines the mode of treatment. In non-destructive mode the argument shapes are not modified. Instead a copy of a sub-shape is created in the result if it is needed to be updated. More...

void	SetGlue (const BOPAlgo_GlueEnum theGlue)
	Sets the glue option for the algorithm. More...

BOPAlgo_GlueEnum	Glue () const
	Returns the glue option of the algorithm. More...

void	SetCheckInverted (const Standard_Boolean theCheck)
	Enables/Disables the check of the input solids for inverted status. More...

Standard_Boolean	CheckInverted () const
	Returns the flag defining whether the check for input solids on inverted status should be performed or not. More...

Performing the operation
virtual void	Perform (const Message_ProgressRange &theRange=Message_ProgressRange()) override
	Performs the operation. The intersection will be performed also. More...

virtual void	PerformWithFiller (const BOPAlgo_PaveFiller &theFiller, const Message_ProgressRange &theRange=Message_ProgressRange())
	Performs the operation with the prepared filler. The intersection will not be performed in this case. More...

BOPs on open solids
virtual void	BuildBOP (const TopTools_ListOfShape &theObjects, const TopAbs_State theObjState, const TopTools_ListOfShape &theTools, const TopAbs_State theToolsState, const Message_ProgressRange &theRange, Handle< Message_Report > theReport=NULL)
	Builds the result shape according to the given states for the objects and tools. These states can be unambiguously converted into the Boolean operation type. Thus, it performs the Boolean operation on the given groups of shapes. More...

void	BuildBOP (const TopTools_ListOfShape &theObjects, const TopTools_ListOfShape &theTools, const BOPAlgo_Operation theOperation, const Message_ProgressRange &theRange, Handle< Message_Report > theReport=NULL)
	Builds the result of Boolean operation of given type basing on the result of Builder operation (GF or any other). More...

Images/Origins
const TopTools_DataMapOfShapeListOfShape &	Images () const
	Returns the map of images. More...

const TopTools_DataMapOfShapeListOfShape &	Origins () const
	Returns the map of origins. More...

const TopTools_DataMapOfShapeShape &	ShapesSD () const
	Returns the map of Same Domain (SD) shapes - coinciding shapes from different arguments. More...

Public Member Functions inherited from BOPAlgo_BuilderShape
const TopoDS_Shape &	Shape () const
	Returns the result of algorithm. More...

const TopTools_ListOfShape &	Modified (const TopoDS_Shape &theS)
	Returns the list of shapes Modified from the shape theS. More...

const TopTools_ListOfShape &	Generated (const TopoDS_Shape &theS)
	Returns the list of shapes Generated from the shape theS. More...

Standard_Boolean	IsDeleted (const TopoDS_Shape &theS)
	Returns true if the shape theS has been deleted. In this case the shape will have no Modified elements, but can have Generated elements. More...

Standard_Boolean	HasModified () const
	Returns true if any of the input shapes has been modified during operation. More...

Standard_Boolean	HasGenerated () const
	Returns true if any of the input shapes has generated shapes during operation. More...

Standard_Boolean	HasDeleted () const
	Returns true if any of the input shapes has been deleted during operation. More...

Handle< BRepTools_History >	History ()
	History Tool. More...

void	SetToFillHistory (const Standard_Boolean theHistFlag)
	Allows disabling the history collection. More...

Standard_Boolean	HasHistory () const
	Returns flag of history availability. More...

Public Member Functions inherited from BOPAlgo_Options
	BOPAlgo_Options ()
	Empty constructor. More...

	BOPAlgo_Options (const Handle< NCollection_BaseAllocator > &theAllocator)
	Constructor with allocator. More...

virtual	~BOPAlgo_Options ()
	Destructor. More...

const Handle< NCollection_BaseAllocator > &	Allocator () const
	Returns allocator. More...

void	AddError (const Handle< Message_Alert > &theAlert)
	Adds the alert as error (fail) More...

void	AddWarning (const Handle< Message_Alert > &theAlert)
	Adds the alert as warning. More...

Standard_Boolean	HasErrors () const
	Returns true if algorithm has failed. More...

Standard_Boolean	HasError (const Handle< Standard_Type > &theType) const
	Returns true if algorithm has generated error of specified type. More...

Standard_Boolean	HasWarnings () const
	Returns true if algorithm has generated some warning alerts. More...

Standard_Boolean	HasWarning (const Handle< Standard_Type > &theType) const
	Returns true if algorithm has generated warning of specified type. More...

const Handle< Message_Report > &	GetReport () const
	Returns report collecting all errors and warnings. More...

void	DumpErrors (Standard_OStream &theOS) const
	Dumps the error status into the given stream. More...

void	DumpWarnings (Standard_OStream &theOS) const
	Dumps the warning statuses into the given stream. More...

void	ClearWarnings ()
	Clears the warnings of the algorithm. More...

void	SetFuzzyValue (const Standard_Real theFuzz)
	Sets the additional tolerance. More...

Standard_Real	FuzzyValue () const
	Returns the additional tolerance. More...

void	SetUseOBB (const Standard_Boolean theUseOBB)
	Enables/Disables the usage of OBB. More...

Standard_Boolean	UseOBB () const
	Returns the flag defining usage of OBB. More...

void	SetRunParallel (const Standard_Boolean theFlag)
	Set the flag of parallel processing if <theFlag> is true the parallel processing is switched on if <theFlag> is false the parallel processing is switched off. More...

Standard_Boolean	RunParallel () const
	Returns the flag of parallel processing. More...

Protected Member Functions
History methods
void	PrepareHistory (const Message_ProgressRange &theRange)
	Prepare information for history support. More...

virtual const TopTools_ListOfShape *	LocModified (const TopoDS_Shape &theS)
	Prepare history information for the input shapes taking into account possible operation-specific modifications. For instance, in the CellsBuilder operation, additionally to splitting input shapes the splits of the shapes (or the shapes themselves) may be unified during removal of internal boundaries. In this case each split should be linked to the unified shape. More...

virtual const TopTools_ListOfShape &	LocGenerated (const TopoDS_Shape &theS)
	Returns the list of shapes generated from the shape theS. Similarly to LocModified must be redefined for specific operations, obtaining Generated elements differently. More...

Methods for building the result
virtual void	PerformInternal (const BOPAlgo_PaveFiller &thePF, const Message_ProgressRange &theRange)
	Performs the building of the result. The method calls the PerformInternal1() method surrounded by a try-catch block. More...

virtual void	PerformInternal1 (const BOPAlgo_PaveFiller &thePF, const Message_ProgressRange &theRange)
	Performs the building of the result. To build the result of any other operation it will be necessary to override this method. More...

virtual void	BuildResult (const TopAbs_ShapeEnum theType)
	Builds the result of operation. The method is called for each of the arguments type and adds into the result the splits of the arguments of that type. More...

Checking input arguments
virtual void	CheckData () override
	Checks the input data. More...

void	CheckFiller ()
	Checks if the intersection algorithm has Errors/Warnings. More...

virtual void	Prepare ()
	Prepares the result shape by making it empty compound. More...

Fill Images of VERTICES
void	FillImagesVertices (const Message_ProgressRange &theRange)
	Fills the images of vertices. More...

Fill Images of EDGES
void	FillImagesEdges (const Message_ProgressRange &theRange)
	Fills the images of edges. More...

Fill Images of CONTAINERS
void	FillImagesContainers (const TopAbs_ShapeEnum theType, const Message_ProgressRange &theRange)
	Fills the images of containers (WIRES/SHELLS/COMPSOLID). More...

void	FillImagesContainer (const TopoDS_Shape &theS, const TopAbs_ShapeEnum theType)
	Builds the image of the given container using the splits of its sub-shapes. More...

Fill Images of FACES
void	FillImagesFaces (const Message_ProgressRange &theRange)
	Fills the images of faces. The method consists of three steps: More...

virtual void	BuildSplitFaces (const Message_ProgressRange &theRange)
	Builds the splits of faces using the information from the intersection stage stored in Data Structure. More...

void	FillSameDomainFaces (const Message_ProgressRange &theRange)
	Looks for the same domain faces among the splits of the faces. Updates the map of images with SD faces. More...

void	FillInternalVertices (const Message_ProgressRange &theRange)
	Classifies the alone vertices on faces relatively its splits and adds them as INTERNAL into the splits. More...

Fill Images of SOLIDS
void	FillImagesSolids (const Message_ProgressRange &theRange)
	Fills the images of solids. The method consists of four steps: More...

void	BuildDraftSolid (const TopoDS_Shape &theSolid, TopoDS_Shape &theDraftSolid, TopTools_ListOfShape &theLIF)
	Builds the draft solid by rebuilding the shells of the solid with the splits of faces. More...

virtual void	FillIn3DParts (TopTools_DataMapOfShapeShape &theDraftSolids, const Message_ProgressRange &theRange)
	Finds faces located inside each solid. More...

void	BuildSplitSolids (TopTools_DataMapOfShapeShape &theDraftSolids, const Message_ProgressRange &theRange)
	Builds the splits of the solids using their draft versions and faces located inside. More...

void	FillInternalShapes (const Message_ProgressRange &theRange)
	Classifies the vertices and edges from the arguments relatively splits of solids and makes them INTERNAL for solids. More...

Fill Images of COMPOUNDS
void	FillImagesCompounds (const Message_ProgressRange &theRange)
	Fills the images of compounds. More...

void	FillImagesCompound (const TopoDS_Shape &theS, TopTools_MapOfShape &theMF)
	Builds the image of the given compound. More...

Post treatment
virtual void	PostTreat (const Message_ProgressRange &theRange)
	Post treatment of the result of the operation. The method checks validity of the sub-shapes of the result and updates the tolerances to make them valid. More...

Protected Member Functions inherited from BOPAlgo_BuilderShape
	BOPAlgo_BuilderShape ()
	Empty constructor. More...

	BOPAlgo_BuilderShape (const Handle< NCollection_BaseAllocator > &theAllocator)
	Constructor with allocator. More...

Protected Member Functions inherited from BOPAlgo_Algo
	BOPAlgo_Algo ()
	Default constructor. More...

virtual	~BOPAlgo_Algo ()

	BOPAlgo_Algo (const Handle< NCollection_BaseAllocator > &theAllocator)

virtual void	CheckResult ()
	Checks the obtained result. More...

void	analyzeProgress (const Standard_Real theWhole, BOPAlgo_PISteps &theSteps) const
	Analyze progress steps of the whole operation. More...

Protected Member Functions inherited from BOPAlgo_Options
Standard_Boolean	UserBreak (const Message_ProgressScope &thePS)
	Adds error to the report if the break signal was caught. Returns true in this case, false otherwise. More...

Protected Attributes
Fields
TopTools_ListOfShape	myArguments
	Arguments of the operation. More...

TopTools_MapOfShape	myMapFence
	Fence map providing the uniqueness of the shapes in the list of arguments. More...

BOPAlgo_PPaveFiller	myPaveFiller
	Pave Filler - algorithm for sub-shapes intersection. More...

BOPDS_PDS	myDS
	Data Structure - holder of intersection information. More...

Handle< IntTools_Context >	myContext
	Context - tool for cashing heavy algorithms such as Projectors and Classifiers. More...

Standard_Integer	myEntryPoint
	EntryPoint - controls the deletion of the PaveFiller, which could live longer than the Builder. More...

TopTools_DataMapOfShapeListOfShape	myImages
	Images - map of Images of the sub-shapes of arguments. More...

TopTools_DataMapOfShapeShape	myShapesSD
	ShapesSD - map of SD Shapes. More...

TopTools_DataMapOfShapeListOfShape	myOrigins
	Origins - map of Origins, back map of Images. More...

TopTools_DataMapOfShapeListOfShape	myInParts
	InParts - map of own and acquired IN faces of the arguments solids. More...

Standard_Boolean	myNonDestructive
	Safe processing option allows avoiding modification of the input shapes. More...

BOPAlgo_GlueEnum	myGlue
	Gluing option allows speeding up the intersection of the input shapes. More...

Standard_Boolean	myCheckInverted
	Check inverted option allows disabling the check of input solids on inverted status. More...

Protected Attributes inherited from BOPAlgo_BuilderShape
TopoDS_Shape	myShape
	Result of the operation. More...

TopTools_ListOfShape	myHistShapes
	Storer for the history shapes. More...

TopTools_MapOfShape	myMapShape
	cached map of all arguments shapes More...

Standard_Boolean	myFillHistory
	Controls the history filling. More...

Handle< BRepTools_History >	myHistory
	History tool. More...

Protected Attributes inherited from BOPAlgo_Options
Handle< NCollection_BaseAllocator >	myAllocator
	Enables/Disables the usage of OBB. More...

Handle< Message_Report >	myReport
	Enables/Disables the usage of OBB. More...

Standard_Boolean	myRunParallel
	Enables/Disables the usage of OBB. More...

Standard_Real	myFuzzyValue
	Enables/Disables the usage of OBB. More...

Standard_Boolean	myUseOBB
	Enables/Disables the usage of OBB. More...

Analyze progress of the operation
enum	BOPAlgo_PIOperation { PIOperation_TreatVertices = 0, PIOperation_TreatEdges, PIOperation_TreatWires, PIOperation_TreatFaces, PIOperation_TreatShells, PIOperation_TreatSolids, PIOperation_TreatCompsolids, PIOperation_TreatCompounds, PIOperation_FillHistory, PIOperation_PostTreat, PIOperation_Last }
	List of operations to be supported by the Progress Indicator. More...

NbShapes	getNbShapes () const
	Compute number of shapes of certain type participating in operation. More...

void	fillPIConstants (const Standard_Real theWhole, BOPAlgo_PISteps &theSteps) const override
	Filling steps for constant operations. More...

void	fillPISteps (BOPAlgo_PISteps &theSteps) const override
	Filling steps for all other operations. More...

Additional Inherited Members
Static Public Member Functions inherited from BOPAlgo_Options
static Standard_Boolean	GetParallelMode ()
	Gets the global parallel mode. More...

static void	SetParallelMode (const Standard_Boolean theNewMode)
	Sets the global parallel mode. More...

Detailed Description

The class is a General Fuse algorithm - base algorithm for the algorithms in the Boolean Component. Its main purpose is to build the split parts of the argument shapes from which the result of the operations is combined.
The result of the General Fuse algorithm itself is a compound containing all split parts of the arguments.

Additionally to the options of the base classes, the algorithm has the following options:

Safe processing mode - allows to avoid modification of the input shapes during the operation (by default it is off);
Gluing options - allows to speed up the calculation of the intersections on the special cases, in which some sub-shapes are coinciding.
Disabling the check for inverted solids - Disables/Enables the check of the input solids for inverted status (holes in the space). The default value is TRUE, i.e. the check is performed. Setting this flag to FALSE for inverted solids, most likely will lead to incorrect results.

The algorithm returns the following warnings:

BOPAlgo_AlertUnableToOrientTheShape - in case the check on the orientation of the split shape to match the orientation of the original shape has failed.

The algorithm returns the following Error statuses:

BOPAlgo_AlertTooFewArguments - in case there are no enough arguments to perform the operation;
BOPAlgo_AlertNoFiller - in case the intersection tool has not been created;
BOPAlgo_AlertIntersectionFailed - in case the intersection of the arguments has failed;
BOPAlgo_AlertBuilderFailed - in case building splits of arguments has failed with some unexpected error.

Member Enumeration Documentation

◆ BOPAlgo_PIOperation

enum BOPAlgo_Builder::BOPAlgo_PIOperation

protected

List of operations to be supported by the Progress Indicator.

Enumerator
PIOperation_TreatVertices
PIOperation_TreatEdges
PIOperation_TreatWires
PIOperation_TreatFaces
PIOperation_TreatShells
PIOperation_TreatSolids
PIOperation_TreatCompsolids
PIOperation_TreatCompounds
PIOperation_FillHistory
PIOperation_PostTreat
PIOperation_Last

Constructor & Destructor Documentation

◆ BOPAlgo_Builder() [1/2]

BOPAlgo_Builder::BOPAlgo_Builder ( )

Empty constructor.

◆ ~BOPAlgo_Builder()

virtual BOPAlgo_Builder::~BOPAlgo_Builder ( )

virtual

◆ BOPAlgo_Builder() [2/2]

BOPAlgo_Builder::BOPAlgo_Builder ( const Handle< NCollection_BaseAllocator > & theAllocator )

Member Function Documentation

◆ AddArgument()

virtual void BOPAlgo_Builder::AddArgument ( const TopoDS_Shape & theShape )

virtual

Adds the argument to the operation.

◆ Arguments()

const TopTools_ListOfShape& BOPAlgo_Builder::Arguments ( ) const

inline

Returns the list of arguments.

◆ BuildBOP() [1/2]

virtual void BOPAlgo_Builder::BuildBOP	(	const TopTools_ListOfShape &	theObjects,
		const TopAbs_State	theObjState,
		const TopTools_ListOfShape &	theTools,
		const TopAbs_State	theToolsState,
		const Message_ProgressRange &	theRange,
		Handle< Message_Report >	theReport = `NULL`
	)

virtual

Builds the result shape according to the given states for the objects and tools. These states can be unambiguously converted into the Boolean operation type. Thus, it performs the Boolean operation on the given groups of shapes.

The result is built basing on the result of Builder operation (GF or any other). The only condition for the Builder is that the splits of faces should be created and classified relatively solids.

The method uses classification approach for choosing the faces which will participate in building the result shape:

All faces from each group having the given state for the opposite group will be taken into result.

Such approach shows better results (in comparison with BOPAlgo_BuilderSolid approach) when working with open solids. However, the result may not be always correct on such data (at least, not as expected) as the correct classification of the faces relatively open solids is not always possible and may vary depending on the chosen classification point on the face.

History is not created for the solids in this method.

To avoid pollution of the report of Builder algorithm, there is a possibility to pass the different report to collect the alerts of the method only. But, if the new report is not given, the Builder report will be used. So, even if Builder passed without any errors, but some error has been stored into its report in this method, for the following calls the Builder report must be cleared.

The method may set the following errors:

BOPAlgo_AlertBuilderFailed - Building operation has not been performed yet or failed;
BOPAlgo_AlertBOPNotSet - invalid BOP type is given (COMMON/FUSE/CUT/CUT21 are supported);
BOPAlgo_AlertTooFewArguments - arguments are not given;
BOPAlgo_AlertUnknownShape - the shape is unknown for the operation.

Parameters:

Parameters

theObjects	- The group of Objects for BOP;
theObjState	- State for objects faces to pass into result;
theTools	- The group of Tools for BOP;
theToolsState	- State for tools faces to pass into result;
theReport	- The alternative report to avoid pollution of the main one.

◆ BuildBOP() [2/2]

void BOPAlgo_Builder::BuildBOP	(	const TopTools_ListOfShape &	theObjects,
		const TopTools_ListOfShape &	theTools,
		const BOPAlgo_Operation	theOperation,
		const Message_ProgressRange &	theRange,
		Handle< Message_Report >	theReport = `NULL`
	)

inline

Builds the result of Boolean operation of given type basing on the result of Builder operation (GF or any other).

The method converts the given type of operation into the states for the objects and tools required for their face to pass into result and performs the call to the same method, but with states instead of operation type.

The conversion looks as follows:

COMMON is built from the faces of objects located IN any of the tools and vice versa.
FUSE is built from the faces OUT of all given shapes;
CUT is built from the faces of the objects OUT of the tools and faces of the tools located IN solids of the objects.

Parameters

theObjects	- The group of Objects for BOP;
theTools	- The group of Tools for BOP;
theOperation	- The BOP type;
theRange	- The parameter to progressIndicator
theReport	- The alternative report to avoid pollution of the global one.

◆ BuildDraftSolid()

void BOPAlgo_Builder::BuildDraftSolid	(	const TopoDS_Shape &	theSolid,
		TopoDS_Shape &	theDraftSolid,
		TopTools_ListOfShape &	theLIF
	)

protected

Builds the draft solid by rebuilding the shells of the solid with the splits of faces.

◆ BuildResult()

virtual void BOPAlgo_Builder::BuildResult ( const TopAbs_ShapeEnum theType )

protectedvirtual

Builds the result of operation. The method is called for each of the arguments type and adds into the result the splits of the arguments of that type.

Reimplemented in BOPAlgo_BOP, and BOPAlgo_Splitter.

◆ BuildSplitFaces()

virtual void BOPAlgo_Builder::BuildSplitFaces ( const Message_ProgressRange & theRange )

protectedvirtual

Builds the splits of faces using the information from the intersection stage stored in Data Structure.

◆ BuildSplitSolids()

void BOPAlgo_Builder::BuildSplitSolids	(	TopTools_DataMapOfShapeShape &	theDraftSolids,
		const Message_ProgressRange &	theRange
	)

protected

Builds the splits of the solids using their draft versions and faces located inside.

◆ CheckData()

virtual void BOPAlgo_Builder::CheckData ( )

overrideprotectedvirtual

Checks the input data.

Reimplemented from BOPAlgo_Algo.

Reimplemented in BOPAlgo_MakerVolume, BOPAlgo_BOP, BOPAlgo_Splitter, and BOPAlgo_Section.

◆ CheckFiller()

void BOPAlgo_Builder::CheckFiller ( )

protected

Checks if the intersection algorithm has Errors/Warnings.

◆ CheckInverted()

Standard_Boolean BOPAlgo_Builder::CheckInverted ( ) const

inline

Returns the flag defining whether the check for input solids on inverted status should be performed or not.

◆ Clear()

virtual void BOPAlgo_Builder::Clear ( )

overridevirtual

Clears the content of the algorithm.

Reimplemented from BOPAlgo_BuilderShape.

Reimplemented in BOPAlgo_CellsBuilder, BOPAlgo_MakerVolume, BOPAlgo_BOP, BRepFeat_Builder, and BOPAlgo_ToolsProvider.

◆ Context()

Handle< IntTools_Context > BOPAlgo_Builder::Context ( ) const

inline

Returns the Context, tool for cashing heavy algorithms.

◆ FillImagesCompound()

void BOPAlgo_Builder::FillImagesCompound	(	const TopoDS_Shape &	theS,
		TopTools_MapOfShape &	theMF
	)

protected

Builds the image of the given compound.

◆ FillImagesCompounds()

void BOPAlgo_Builder::FillImagesCompounds ( const Message_ProgressRange & theRange )

protected

Fills the images of compounds.

◆ FillImagesContainer()

void BOPAlgo_Builder::FillImagesContainer	(	const TopoDS_Shape &	theS,
		const TopAbs_ShapeEnum	theType
	)

protected

Builds the image of the given container using the splits of its sub-shapes.

◆ FillImagesContainers()

void BOPAlgo_Builder::FillImagesContainers	(	const TopAbs_ShapeEnum	theType,
		const Message_ProgressRange &	theRange
	)

protected

Fills the images of containers (WIRES/SHELLS/COMPSOLID).

◆ FillImagesEdges()

void BOPAlgo_Builder::FillImagesEdges ( const Message_ProgressRange & theRange )

protected

Fills the images of edges.

◆ FillImagesFaces()

void BOPAlgo_Builder::FillImagesFaces ( const Message_ProgressRange & theRange )

protected

Fills the images of faces. The method consists of three steps:

Build the splits of faces;
Find SD faces;
Add internal vertices (if any) to faces.

◆ FillImagesSolids()

void BOPAlgo_Builder::FillImagesSolids ( const Message_ProgressRange & theRange )

protected

Fills the images of solids. The method consists of four steps:

Build the draft solid - just rebuild the solid using the splits of faces;
Find faces from other arguments located inside the solids;
Build splits of solid using the inside faces;
Fill internal shapes for the splits (Wires and vertices).

◆ FillImagesVertices()

void BOPAlgo_Builder::FillImagesVertices ( const Message_ProgressRange & theRange )

protected

Fills the images of vertices.

◆ FillIn3DParts()

virtual void BOPAlgo_Builder::FillIn3DParts	(	TopTools_DataMapOfShapeShape &	theDraftSolids,
		const Message_ProgressRange &	theRange
	)

protectedvirtual

Finds faces located inside each solid.

Reimplemented in BRepFeat_Builder.

◆ FillInternalShapes()

void BOPAlgo_Builder::FillInternalShapes ( const Message_ProgressRange & theRange )

protected

Classifies the vertices and edges from the arguments relatively splits of solids and makes them INTERNAL for solids.

◆ FillInternalVertices()

void BOPAlgo_Builder::FillInternalVertices ( const Message_ProgressRange & theRange )

protected

Classifies the alone vertices on faces relatively its splits and adds them as INTERNAL into the splits.

◆ fillPIConstants()

void BOPAlgo_Builder::fillPIConstants	(	const Standard_Real	theWhole,
		BOPAlgo_PISteps &	theSteps
	)		const

overrideprotectedvirtual

Filling steps for constant operations.

Reimplemented from BOPAlgo_Algo.

Reimplemented in BOPAlgo_Section.

◆ fillPISteps()

void BOPAlgo_Builder::fillPISteps ( BOPAlgo_PISteps & theSteps ) const

overrideprotectedvirtual

Filling steps for all other operations.

Reimplemented from BOPAlgo_Algo.

Reimplemented in BOPAlgo_MakerVolume, and BOPAlgo_Section.

◆ FillSameDomainFaces()

void BOPAlgo_Builder::FillSameDomainFaces ( const Message_ProgressRange & theRange )

protected

Looks for the same domain faces among the splits of the faces. Updates the map of images with SD faces.

◆ getNbShapes()

NbShapes BOPAlgo_Builder::getNbShapes ( ) const

protected

Compute number of shapes of certain type participating in operation.

◆ Glue()

BOPAlgo_GlueEnum BOPAlgo_Builder::Glue ( ) const

inline

Returns the glue option of the algorithm.

◆ Images()

const TopTools_DataMapOfShapeListOfShape& BOPAlgo_Builder::Images ( ) const

inline

Returns the map of images.

◆ LocGenerated()

virtual const TopTools_ListOfShape& BOPAlgo_Builder::LocGenerated ( const TopoDS_Shape & theS )

protectedvirtual

Returns the list of shapes generated from the shape theS. Similarly to LocModified must be redefined for specific operations, obtaining Generated elements differently.

◆ LocModified()

virtual const TopTools_ListOfShape* BOPAlgo_Builder::LocModified ( const TopoDS_Shape & theS )

protectedvirtual

Prepare history information for the input shapes taking into account possible operation-specific modifications. For instance, in the CellsBuilder operation, additionally to splitting input shapes the splits of the shapes (or the shapes themselves) may be unified during removal of internal boundaries. In this case each split should be linked to the unified shape.

To have correct history information, the method should be redefined in each operation where such additional modification is possible. The input shape <theS> should be the one from arguments, and the returning list should contain all final elements to which the input shape has evolved, including those not contained in the result shape.

The method returns pointer to the list of modified elements. NULL pointer means that the shape has not been modified at all.

The General Fuse operation does not perform any other modification than splitting the input shapes basing on their intersection information. This information is contained in myImages map. Thus, here the method returns only splits (if any) contained in this map.

Reimplemented in BOPAlgo_CellsBuilder.

◆ NonDestructive()

Standard_Boolean BOPAlgo_Builder::NonDestructive ( ) const

inline

Returns the flag that defines the mode of treatment. In non-destructive mode the argument shapes are not modified. Instead a copy of a sub-shape is created in the result if it is needed to be updated.

◆ Origins()

const TopTools_DataMapOfShapeListOfShape& BOPAlgo_Builder::Origins ( ) const

inline

Returns the map of origins.

◆ PDS()

BOPDS_PDS BOPAlgo_Builder::PDS ( )

inline

Returns the Data Structure, holder of intersection information.

◆ Perform()

virtual void BOPAlgo_Builder::Perform ( const Message_ProgressRange & theRange = Message_ProgressRange() )

overridevirtual

Performs the operation. The intersection will be performed also.

Implements BOPAlgo_Algo.

Reimplemented in BOPAlgo_MakerVolume, BOPAlgo_BOP, and BOPAlgo_Splitter.

◆ PerformInternal()

virtual void BOPAlgo_Builder::PerformInternal	(	const BOPAlgo_PaveFiller &	thePF,
		const Message_ProgressRange &	theRange
	)

protectedvirtual

Performs the building of the result. The method calls the PerformInternal1() method surrounded by a try-catch block.

◆ PerformInternal1()

virtual void BOPAlgo_Builder::PerformInternal1	(	const BOPAlgo_PaveFiller &	thePF,
		const Message_ProgressRange &	theRange
	)

protectedvirtual

Performs the building of the result. To build the result of any other operation it will be necessary to override this method.

Reimplemented in BOPAlgo_CellsBuilder, BOPAlgo_MakerVolume, BOPAlgo_BOP, and BOPAlgo_Section.

◆ PerformWithFiller()

virtual void BOPAlgo_Builder::PerformWithFiller	(	const BOPAlgo_PaveFiller &	theFiller,
		const Message_ProgressRange &	theRange = `Message_ProgressRange()`
	)

virtual

Performs the operation with the prepared filler. The intersection will not be performed in this case.

◆ PostTreat()

virtual void BOPAlgo_Builder::PostTreat ( const Message_ProgressRange & theRange )

protectedvirtual

Post treatment of the result of the operation. The method checks validity of the sub-shapes of the result and updates the tolerances to make them valid.

◆ PPaveFiller()

BOPAlgo_PPaveFiller BOPAlgo_Builder::PPaveFiller ( )

inline

Returns the PaveFiller, algorithm for sub-shapes intersection.

◆ Prepare()

virtual void BOPAlgo_Builder::Prepare ( )

protectedvirtual

Prepares the result shape by making it empty compound.

Reimplemented in BRepFeat_Builder.

◆ PrepareHistory()

void BOPAlgo_Builder::PrepareHistory ( const Message_ProgressRange & theRange )

protected

Prepare information for history support.

◆ SetArguments()

virtual void BOPAlgo_Builder::SetArguments ( const TopTools_ListOfShape & theLS )

virtual

Sets the list of arguments for the operation.

◆ SetCheckInverted()

void BOPAlgo_Builder::SetCheckInverted ( const Standard_Boolean theCheck )

inline

Enables/Disables the check of the input solids for inverted status.

◆ SetGlue()

void BOPAlgo_Builder::SetGlue ( const BOPAlgo_GlueEnum theGlue )

inline

Sets the glue option for the algorithm.

◆ SetNonDestructive()

void BOPAlgo_Builder::SetNonDestructive ( const Standard_Boolean theFlag )

inline

Sets the flag that defines the mode of treatment. In non-destructive mode the argument shapes are not modified. Instead a copy of a sub-shape is created in the result if it is needed to be updated. This flag is taken into account if internal PaveFiller is used only. In the case of calling PerformWithFiller the corresponding flag of that PaveFiller is in force.

◆ ShapesSD()

const TopTools_DataMapOfShapeShape& BOPAlgo_Builder::ShapesSD ( ) const

inline

Returns the map of Same Domain (SD) shapes - coinciding shapes from different arguments.

Field Documentation

◆ myArguments

TopTools_ListOfShape BOPAlgo_Builder::myArguments

protected

Arguments of the operation.

◆ myCheckInverted

Standard_Boolean BOPAlgo_Builder::myCheckInverted

protected

Check inverted option allows disabling the check of input solids on inverted status.

◆ myContext

Handle< IntTools_Context > BOPAlgo_Builder::myContext

protected

Context - tool for cashing heavy algorithms such as Projectors and Classifiers.

◆ myDS

BOPDS_PDS BOPAlgo_Builder::myDS

protected

Data Structure - holder of intersection information.

◆ myEntryPoint

Standard_Integer BOPAlgo_Builder::myEntryPoint

protected

EntryPoint - controls the deletion of the PaveFiller, which could live longer than the Builder.

◆ myGlue

BOPAlgo_GlueEnum BOPAlgo_Builder::myGlue

protected

Gluing option allows speeding up the intersection of the input shapes.

◆ myImages

TopTools_DataMapOfShapeListOfShape BOPAlgo_Builder::myImages

protected

Images - map of Images of the sub-shapes of arguments.

◆ myInParts

TopTools_DataMapOfShapeListOfShape BOPAlgo_Builder::myInParts

protected

InParts - map of own and acquired IN faces of the arguments solids.

◆ myMapFence

TopTools_MapOfShape BOPAlgo_Builder::myMapFence

protected

Fence map providing the uniqueness of the shapes in the list of arguments.

◆ myNonDestructive

Standard_Boolean BOPAlgo_Builder::myNonDestructive

protected

Safe processing option allows avoiding modification of the input shapes.

◆ myOrigins

TopTools_DataMapOfShapeListOfShape BOPAlgo_Builder::myOrigins

protected

Origins - map of Origins, back map of Images.

◆ myPaveFiller

BOPAlgo_PPaveFiller BOPAlgo_Builder::myPaveFiller

protected

Pave Filler - algorithm for sub-shapes intersection.

◆ myShapesSD

TopTools_DataMapOfShapeShape BOPAlgo_Builder::myShapesSD

protected

ShapesSD - map of SD Shapes.

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

BOPAlgo_Builder.hxx

Data Structures

Public Member Functions

Protected Member Functions

Protected Attributes

Analyze progress of the operation

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ BOPAlgo_PIOperation

Constructor & Destructor Documentation

◆ BOPAlgo_Builder() [1/2]

◆ ~BOPAlgo_Builder()

◆ BOPAlgo_Builder() [2/2]

Member Function Documentation

◆ AddArgument()

◆ Arguments()

◆ BuildBOP() [1/2]

◆ BuildBOP() [2/2]

◆ BuildDraftSolid()

◆ BuildResult()

◆ BuildSplitFaces()

◆ BuildSplitSolids()

◆ CheckData()

◆ CheckFiller()

◆ CheckInverted()

◆ Clear()

◆ Context()

◆ FillImagesCompound()

◆ FillImagesCompounds()

◆ FillImagesContainer()

◆ FillImagesContainers()

◆ FillImagesEdges()

◆ FillImagesFaces()

◆ FillImagesSolids()

◆ FillImagesVertices()

◆ FillIn3DParts()

◆ FillInternalShapes()

◆ FillInternalVertices()

◆ fillPIConstants()

◆ fillPISteps()

◆ FillSameDomainFaces()

◆ getNbShapes()

◆ Glue()

◆ Images()

◆ LocGenerated()

◆ LocModified()

◆ NonDestructive()

◆ Origins()

◆ PDS()

◆ Perform()

◆ PerformInternal()

◆ PerformInternal1()

◆ PerformWithFiller()

◆ PostTreat()

◆ PPaveFiller()

◆ Prepare()

◆ PrepareHistory()

◆ SetArguments()

◆ SetCheckInverted()

◆ SetGlue()

◆ SetNonDestructive()

◆ ShapesSD()

Field Documentation

◆ myArguments

◆ myCheckInverted

◆ myContext

◆ myDS

◆ myEntryPoint

◆ myGlue

◆ myImages

◆ myInParts

◆ myMapFence

◆ myNonDestructive

◆ myOrigins

◆ myPaveFiller

◆ myShapesSD