BOPAlgo_Splitter Class Reference

The Splitter algorithm is the algorithm for splitting a group of arbitrary shapes by the other group of arbitrary shapes.
The arguments of the operation are divided on two groups:
Objects - shapes that will be split;
Tools - shapes by which the Objects will be split.
The result of the operation contains only the split parts of the shapes from the group of Objects.
The split parts of the shapes from the group of Tools are excluded from the result.
The shapes can be split by the other shapes from the same group (in case these shapes are interfering). More...

#include <BOPAlgo_Splitter.hxx>

Inheritance diagram for BOPAlgo_Splitter:

Public Member Functions
	BOPAlgo_Splitter ()
	Empty constructor.
virtual	~BOPAlgo_Splitter ()
	BOPAlgo_Splitter (const Handle< NCollection_BaseAllocator > &theAllocator)
virtual void	Perform (const Message_ProgressRange &theRange=Message_ProgressRange()) override
	Performs the operation.
Public Member Functions inherited from BOPAlgo_ToolsProvider
	BOPAlgo_ToolsProvider ()
	Empty constructor.
	BOPAlgo_ToolsProvider (const Handle< NCollection_BaseAllocator > &theAllocator)
virtual void	Clear () override
	Clears internal fields and arguments.
virtual void	AddTool (const TopoDS_Shape &theShape)
	Adds Tool argument of the operation.
virtual void	SetTools (const TopTools_ListOfShape &theShapes)
	Adds the Tool arguments of the operation.
const TopTools_ListOfShape &	Tools () const
	Returns the Tool arguments of the operation.
Public Member Functions inherited from BOPAlgo_Builder
	BOPAlgo_Builder ()
	Empty constructor.
virtual	~BOPAlgo_Builder ()
	BOPAlgo_Builder (const Handle< NCollection_BaseAllocator > &theAllocator)
BOPAlgo_PPaveFiller	PPaveFiller ()
	Returns the PaveFiller, algorithm for sub-shapes intersection.
BOPDS_PDS	PDS ()
	Returns the Data Structure, holder of intersection information.
Handle< IntTools_Context >	Context () const
	Returns the Context, tool for cashing heavy algorithms.
virtual void	AddArgument (const TopoDS_Shape &theShape)
	Adds the argument to the operation.
virtual void	SetArguments (const TopTools_ListOfShape &theLS)
	Sets the list of arguments for the operation.
const TopTools_ListOfShape &	Arguments () const
	Returns the list of arguments.
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.
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.
void	SetGlue (const BOPAlgo_GlueEnum theGlue)
	Sets the glue option for the algorithm.
BOPAlgo_GlueEnum	Glue () const
	Returns the glue option of the algorithm.
void	SetCheckInverted (const Standard_Boolean theCheck)
	Enables/Disables the check of the input solids for inverted status.
Standard_Boolean	CheckInverted () const
	Returns the flag defining whether the check for input solids on inverted status should be performed or not.
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.
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.
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).
const TopTools_DataMapOfShapeListOfShape &	Images () const
	Returns the map of images.
const TopTools_DataMapOfShapeListOfShape &	Origins () const
	Returns the map of origins.
const TopTools_DataMapOfShapeShape &	ShapesSD () const
	Returns the map of Same Domain (SD) shapes - coinciding shapes from different arguments.
Public Member Functions inherited from BOPAlgo_BuilderShape
const TopoDS_Shape &	Shape () const
	Returns the result of algorithm.
const TopTools_ListOfShape &	Modified (const TopoDS_Shape &theS)
	Returns the list of shapes Modified from the shape theS.
const TopTools_ListOfShape &	Generated (const TopoDS_Shape &theS)
	Returns the list of shapes Generated from the shape theS.
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.
Standard_Boolean	HasModified () const
	Returns true if any of the input shapes has been modified during operation.
Standard_Boolean	HasGenerated () const
	Returns true if any of the input shapes has generated shapes during operation.
Standard_Boolean	HasDeleted () const
	Returns true if any of the input shapes has been deleted during operation.
Handle< BRepTools_History >	History ()
	History Tool.
void	SetToFillHistory (const Standard_Boolean theHistFlag)
	Allows disabling the history collection.
Standard_Boolean	HasHistory () const
	Returns flag of history availability.
Public Member Functions inherited from BOPAlgo_Algo
Public Member Functions inherited from BOPAlgo_Options
	BOPAlgo_Options ()
	Empty constructor.
	BOPAlgo_Options (const Handle< NCollection_BaseAllocator > &theAllocator)
	Constructor with allocator.
virtual	~BOPAlgo_Options ()
	Destructor.
const Handle< NCollection_BaseAllocator > &	Allocator () const
	Returns allocator.
void	AddError (const Handle< Message_Alert > &theAlert)
	Adds the alert as error (fail)
void	AddWarning (const Handle< Message_Alert > &theAlert)
	Adds the alert as warning.
Standard_Boolean	HasErrors () const
	Returns true if algorithm has failed.
Standard_Boolean	HasError (const Handle< Standard_Type > &theType) const
	Returns true if algorithm has generated error of specified type.
Standard_Boolean	HasWarnings () const
	Returns true if algorithm has generated some warning alerts.
Standard_Boolean	HasWarning (const Handle< Standard_Type > &theType) const
	Returns true if algorithm has generated warning of specified type.
const Handle< Message_Report > &	GetReport () const
	Returns report collecting all errors and warnings.
void	DumpErrors (Standard_OStream &theOS) const
	Dumps the error status into the given stream.
void	DumpWarnings (Standard_OStream &theOS) const
	Dumps the warning statuses into the given stream.
void	ClearWarnings ()
	Clears the warnings of the algorithm.
void	SetFuzzyValue (const Standard_Real theFuzz)
	Sets the additional tolerance.
Standard_Real	FuzzyValue () const
	Returns the additional tolerance.
void	SetUseOBB (const Standard_Boolean theUseOBB)
	Enables/Disables the usage of OBB.
Standard_Boolean	UseOBB () const
	Returns the flag defining usage of OBB.
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.
Standard_Boolean	RunParallel () const
	Returns the flag of parallel processing.

Protected Member Functions
virtual void	CheckData () override
	Checks the input data.
virtual void	BuildResult (const TopAbs_ShapeEnum theType) override
	Adds images of the argument shapes into result. When called the for the last time (for compound) it rebuilds the result shape to avoid multiple enclosure into compounds.
Protected Member Functions inherited from BOPAlgo_Builder
void	PrepareHistory (const Message_ProgressRange &theRange)
	Prepare information for history support.
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.
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.
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.
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.
void	CheckFiller ()
	Checks if the intersection algorithm has Errors/Warnings.
virtual void	Prepare ()
	Prepares the result shape by making it empty compound.
void	FillImagesVertices (const Message_ProgressRange &theRange)
	Fills the images of vertices.
void	FillImagesEdges (const Message_ProgressRange &theRange)
	Fills the images of edges.
void	FillImagesContainers (const TopAbs_ShapeEnum theType, const Message_ProgressRange &theRange)
	Fills the images of containers (WIRES/SHELLS/COMPSOLID).
void	FillImagesContainer (const TopoDS_Shape &theS, const TopAbs_ShapeEnum theType)
	Builds the image of the given container using the splits of its sub-shapes.
void	FillImagesFaces (const Message_ProgressRange &theRange)
	Fills the images of faces. The method consists of three steps:
virtual void	BuildSplitFaces (const Message_ProgressRange &theRange)
	Builds the splits of faces using the information from the intersection stage stored in Data Structure.
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.
void	FillInternalVertices (const Message_ProgressRange &theRange)
	Classifies the alone vertices on faces relatively its splits and adds them as INTERNAL into the splits.
void	FillImagesSolids (const Message_ProgressRange &theRange)
	Fills the images of solids. The method consists of four steps:
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.
virtual void	FillIn3DParts (TopTools_DataMapOfShapeShape &theDraftSolids, const Message_ProgressRange &theRange)
	Finds faces located inside each solid.
void	BuildSplitSolids (TopTools_DataMapOfShapeShape &theDraftSolids, const Message_ProgressRange &theRange)
	Builds the splits of the solids using their draft versions and faces located inside.
void	FillInternalShapes (const Message_ProgressRange &theRange)
	Classifies the vertices and edges from the arguments relatively splits of solids and makes them INTERNAL for solids.
void	FillImagesCompounds (const Message_ProgressRange &theRange)
	Fills the images of compounds.
void	FillImagesCompound (const TopoDS_Shape &theS, TopTools_MapOfShape &theMF)
	Builds the image of the given compound.
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.
NbShapes	getNbShapes () const
	Compute number of shapes of certain type participating in operation.
void	fillPIConstants (const Standard_Real theWhole, BOPAlgo_PISteps &theSteps) const override
	Filling steps for constant operations.
void	fillPISteps (BOPAlgo_PISteps &theSteps) const override
	Filling steps for all other operations.
Protected Member Functions inherited from BOPAlgo_BuilderShape
	BOPAlgo_BuilderShape ()
	Empty constructor.
	BOPAlgo_BuilderShape (const Handle< NCollection_BaseAllocator > &theAllocator)
	Constructor with allocator.
Protected Member Functions inherited from BOPAlgo_Algo
	BOPAlgo_Algo ()
	Default constructor.
virtual	~BOPAlgo_Algo ()
	BOPAlgo_Algo (const Handle< NCollection_BaseAllocator > &theAllocator)
virtual void	CheckResult ()
	Checks the obtained result.
void	analyzeProgress (const Standard_Real theWhole, BOPAlgo_PISteps &theSteps) const
	Analyze progress steps of the whole operation.
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.

Additional Inherited Members
Static Public Member Functions inherited from BOPAlgo_Options
static Standard_Boolean	GetParallelMode ()
	Gets the global parallel mode.
static void	SetParallelMode (const Standard_Boolean theNewMode)
	Sets the global parallel mode.
Protected Types inherited from BOPAlgo_Builder
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...
Protected Attributes inherited from BOPAlgo_ToolsProvider
TopTools_ListOfShape	myTools
TopTools_MapOfShape	myMapTools
Protected Attributes inherited from BOPAlgo_Builder
TopTools_ListOfShape	myArguments
	Arguments of the operation.
TopTools_MapOfShape	myMapFence
	Fence map providing the uniqueness of the shapes in the list of arguments.
BOPAlgo_PPaveFiller	myPaveFiller
	Pave Filler - algorithm for sub-shapes intersection.
BOPDS_PDS	myDS
	Data Structure - holder of intersection information.
Handle< IntTools_Context >	myContext
	Context - tool for cashing heavy algorithms such as Projectors and Classifiers.
Standard_Integer	myEntryPoint
	EntryPoint - controls the deletion of the PaveFiller, which could live longer than the Builder.
TopTools_DataMapOfShapeListOfShape	myImages
	Images - map of Images of the sub-shapes of arguments.
TopTools_DataMapOfShapeShape	myShapesSD
	ShapesSD - map of SD Shapes.
TopTools_DataMapOfShapeListOfShape	myOrigins
	Origins - map of Origins, back map of Images.
TopTools_DataMapOfShapeListOfShape	myInParts
	InParts - map of own and acquired IN faces of the arguments solids.
Standard_Boolean	myNonDestructive
	Safe processing option allows avoiding modification of the input shapes.
BOPAlgo_GlueEnum	myGlue
	Gluing option allows speeding up the intersection of the input shapes.
Standard_Boolean	myCheckInverted
	Check inverted option allows disabling the check of input solids on inverted status.
Protected Attributes inherited from BOPAlgo_BuilderShape
TopoDS_Shape	myShape
	Result of the operation.
TopTools_ListOfShape	myHistShapes
	Storer for the history shapes.
TopTools_MapOfShape	myMapShape
	cached map of all arguments shapes
Standard_Boolean	myFillHistory
	Controls the history filling.
Handle< BRepTools_History >	myHistory
	History tool.
Protected Attributes inherited from BOPAlgo_Options
Handle< NCollection_BaseAllocator >	myAllocator
	Enables/Disables the usage of OBB.
Handle< Message_Report >	myReport
	Enables/Disables the usage of OBB.
Standard_Boolean	myRunParallel
	Enables/Disables the usage of OBB.
Standard_Real	myFuzzyValue
	Enables/Disables the usage of OBB.
Standard_Boolean	myUseOBB
	Enables/Disables the usage of OBB.

Detailed Description

The Splitter algorithm is the algorithm for splitting a group of arbitrary shapes by the other group of arbitrary shapes.
The arguments of the operation are divided on two groups:
Objects - shapes that will be split;
Tools - shapes by which the Objects will be split.
The result of the operation contains only the split parts of the shapes from the group of Objects.
The split parts of the shapes from the group of Tools are excluded from the result.
The shapes can be split by the other shapes from the same group (in case these shapes are interfering).

The class is a General Fuse based algorithm. Thus, all options of the General Fuse algorithm such as Fuzzy mode, safe processing mode, parallel processing mode, gluing mode and history support are also available in this algorithm.
There is no requirement on the existence of the Tools shapes. And if there are no Tools shapes, the result of the splitting operation will be equivalent to the General Fuse result.

The implementation of the algorithm is minimal - only the methods CheckData() and Perform() have been overridden.
The method BOPAlgo_Builder::BuildResult(), which adds the split parts of the arguments into result, does not have to be overridden, because its native implementation performs the necessary actions for the Splitter algorithm - it adds the split parts of only Objects into result, avoiding the split parts of Tools.

Constructor & Destructor Documentation

BOPAlgo_Splitter() [1/2]

BOPAlgo_Splitter::BOPAlgo_Splitter

(

)

Empty constructor.

~BOPAlgo_Splitter()

virtual BOPAlgo_Splitter::~BOPAlgo_Splitter ( )

virtual

BOPAlgo_Splitter() [2/2]

BOPAlgo_Splitter::BOPAlgo_Splitter

(

const Handle< NCollection_BaseAllocator > &

theAllocator

)

Member Function Documentation

BuildResult()

virtual void BOPAlgo_Splitter::BuildResult ( const TopAbs_ShapeEnum theType )

overrideprotectedvirtual

Adds images of the argument shapes into result. When called the for the last time (for compound) it rebuilds the result shape to avoid multiple enclosure into compounds.

Reimplemented from BOPAlgo_Builder.

CheckData()

virtual void BOPAlgo_Splitter::CheckData ( )

overrideprotectedvirtual

Checks the input data.

Reimplemented from BOPAlgo_Builder.

Perform()

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

overridevirtual

Performs the operation.

Reimplemented from BOPAlgo_Builder.

---

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

• BOPAlgo_Splitter.hxx