Open CASCADE Technology 7.8.2.dev
|
The algorithm is to build solids from set of shapes. It uses the BOPAlgo_Builder algorithm to intersect the given shapes and build the images of faces (if needed) and BOPAlgo_BuilderSolid algorithm to build the solids. More...
#include <BOPAlgo_MakerVolume.hxx>
Public Member Functions | |
BOPAlgo_MakerVolume () | |
Empty constructor. | |
virtual | ~BOPAlgo_MakerVolume () |
BOPAlgo_MakerVolume (const Handle< NCollection_BaseAllocator > &theAllocator) | |
Empty constructor. | |
virtual void | Clear () override |
Clears the data. | |
void | SetIntersect (const Standard_Boolean bIntersect) |
Sets the flag myIntersect: if <bIntersect> is TRUE the shapes from <myArguments> will be intersected. if <bIntersect> is FALSE no intersection will be done. | |
Standard_Boolean | IsIntersect () const |
Returns the flag <myIntersect>. | |
const TopoDS_Solid & | Box () const |
Returns the solid box <mySBox>. | |
const TopTools_ListOfShape & | Faces () const |
Returns the processed faces <myFaces>. | |
void | SetAvoidInternalShapes (const Standard_Boolean theAvoidInternal) |
Defines the preventing of addition of internal for solid parts into the result. By default the internal parts are added into result. | |
Standard_Boolean | IsAvoidInternalShapes () const |
Returns the AvoidInternalShapes flag. | |
virtual void | Perform (const Message_ProgressRange &theRange=Message_ProgressRange()) override |
Performs 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 Types | |
enum | BOPAlgo_PIOperation { PIOperation_BuildSolids = BOPAlgo_Builder::PIOperation_Last , PIOperation_Last } |
List of operations to be supported by the Progress Indicator. Enumeration is going to contain some extra operations from base class, which are not going to be used here. So, the array of steps will also contain some extra zero values. This is the only extra resource that is going to be used, but it allows us not to override the methods that use the values of the enumeration of base class. Starting the enumeration from the middle of enumeration of base class is not a good idea as the values in enumeration may be swapped. More... | |
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 Member Functions | |
virtual void | CheckData () override |
Checks the data. | |
virtual void | PerformInternal1 (const BOPAlgo_PaveFiller &thePF, const Message_ProgressRange &theRange=Message_ProgressRange()) override |
Performs the operation. | |
void | CollectFaces () |
Collects all faces. | |
void | MakeBox (TopTools_MapOfShape &theBoxFaces) |
Makes solid box. | |
void | BuildSolids (TopTools_ListOfShape &theLSR, const Message_ProgressRange &theRange) |
Builds solids. | |
void | RemoveBox (TopTools_ListOfShape &theLSR, const TopTools_MapOfShape &theBoxFaces) |
Removes the covering box. | |
void | FillInternalShapes (const TopTools_ListOfShape &theLSR) |
Fills the solids with internal shapes. | |
void | BuildShape (const TopTools_ListOfShape &theLSR) |
Builds the result. | |
void | fillPISteps (BOPAlgo_PISteps &theSteps) const override |
Analyze progress steps. | |
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 | 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. | |
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. | |
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. | |
Protected Attributes | |
Standard_Boolean | myIntersect |
Bnd_Box | myBBox |
TopoDS_Solid | mySBox |
TopTools_ListOfShape | myFaces |
Standard_Boolean | myAvoidInternalShapes |
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. | |
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. | |
The algorithm is to build solids from set of shapes. It uses the BOPAlgo_Builder algorithm to intersect the given shapes and build the images of faces (if needed) and BOPAlgo_BuilderSolid algorithm to build the solids.
Steps of the algorithm:
Fields: <myIntersect> - boolean flag. It defines whether intersect shapes from <myArguments> (if set to TRUE) or not (FALSE). The default value is TRUE. By setting it to FALSE the user should guarantee that shapes in <myArguments> do not interfere with each other, otherwise the result is unpredictable.
<myBBox> - bounding box, covering all faces from <myFaces>.
<mySBox> - Solid box created from the corner points of <myBBox>.
<myFaces> - the list is to keep the "final" faces, that will be given to the BOPAlgo_BuilderSolid algorithm. If the shapes have been interfered it should contain the images of the source shapes, otherwise its just the original faces. It also contains the faces from <mySBox>.
Fields inherited from BOPAlgo_Builder:
<myArguments> - list of the source shapes. The source shapes can have any type, but each shape must not be self-interfered.
<myShape> - Result shape:
Fields inherited from BOPAlgo_Algo:
<myRunParallel> - Defines whether the parallel processing is switched on or not. <myReport> - Error status of the operation. Additionally to the errors of the parent algorithm it can have the following values:
Example:
BOPAlgo_MakerVolume aMV; // aMV.SetArguments(aLS); //source shapes aMV.SetRunParallel(bRunParallel); //parallel or single mode aMV.SetIntersect(bIntersect); //intersect or not the shapes from <aLS> // aMV.Perform(); //perform the operation if (aMV.HasErrors()) { //check error status return; } // const TopoDS_Shape& aResult = aMV.Shape(); //result of the operation
|
protected |
List of operations to be supported by the Progress Indicator. Enumeration is going to contain some extra operations from base class, which are not going to be used here. So, the array of steps will also contain some extra zero values. This is the only extra resource that is going to be used, but it allows us not to override the methods that use the values of the enumeration of base class. Starting the enumeration from the middle of enumeration of base class is not a good idea as the values in enumeration may be swapped.
Enumerator | |
---|---|
PIOperation_BuildSolids | |
PIOperation_Last |
BOPAlgo_MakerVolume::BOPAlgo_MakerVolume | ( | ) |
Empty constructor.
|
virtual |
BOPAlgo_MakerVolume::BOPAlgo_MakerVolume | ( | const Handle< NCollection_BaseAllocator > & | theAllocator | ) |
Empty constructor.
const TopoDS_Solid & BOPAlgo_MakerVolume::Box | ( | ) | const |
Returns the solid box <mySBox>.
|
protected |
Builds the result.
|
protected |
Builds solids.
|
overrideprotectedvirtual |
Checks the data.
Reimplemented from BOPAlgo_Builder.
|
overridevirtual |
Clears the data.
Reimplemented from BOPAlgo_Builder.
|
protected |
Collects all faces.
const TopTools_ListOfShape & BOPAlgo_MakerVolume::Faces | ( | ) | const |
Returns the processed faces <myFaces>.
|
protected |
Fills the solids with internal shapes.
|
overrideprotectedvirtual |
Analyze progress steps.
Reimplemented from BOPAlgo_Builder.
|
inline |
Returns the AvoidInternalShapes flag.
Standard_Boolean BOPAlgo_MakerVolume::IsIntersect | ( | ) | const |
Returns the flag <myIntersect>.
|
protected |
Makes solid box.
|
overridevirtual |
Performs the operation.
Reimplemented from BOPAlgo_Builder.
|
overrideprotectedvirtual |
Performs the operation.
Reimplemented from BOPAlgo_Builder.
|
protected |
Removes the covering box.
|
inline |
Defines the preventing of addition of internal for solid parts into the result. By default the internal parts are added into result.
void BOPAlgo_MakerVolume::SetIntersect | ( | const Standard_Boolean | bIntersect | ) |
Sets the flag myIntersect: if <bIntersect> is TRUE the shapes from <myArguments> will be intersected. if <bIntersect> is FALSE no intersection will be done.
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |