mirror of
https://github.com/Open-Cascade-SAS/OCCT.git
synced 2026-06-15 12:07:41 +08:00
948fe6ca88
Implementation of the method for simplification of the result of Boolean Operation on the API level. The method BRepAlgoAPI_BuilderAlgo::SimplifyResult has been added, so the derived classes such as BooleanOpeation and Splitter can also use this method. The result shape simplification should be called after the operation is done. The simplification is performed by the means of ShapeUpgrade_UnifySameDomain algorithm. Draw command "bsimplify" has been added to control the simplification options. Documentation for new functionality and draw commands controlling the options of Boolean operations. Test cases for the new functionality. Side-effect change: The algorithms in Boolean component have been changed to use the BRepTools_History as a History tool. Now it became possible to disable the collection of shapes modifications during Boolean Operations, which may be useful for performance sake (in draw the option is controlled by *setfillhistory* command). Draw command "unifysamedom" has been changed to accept the angular tolerance in degrees instead of radians.
141 lines
4.7 KiB
C++
141 lines
4.7 KiB
C++
// Created on: 1993-10-14
|
|
// Created by: Remi LEQUETTE
|
|
// Copyright (c) 1993-1999 Matra Datavision
|
|
// Copyright (c) 1999-2014 OPEN CASCADE SAS
|
|
//
|
|
// This file is part of Open CASCADE Technology software library.
|
|
//
|
|
// This library is free software; you can redistribute it and/or modify it under
|
|
// the terms of the GNU Lesser General Public License version 2.1 as published
|
|
// by the Free Software Foundation, with special exception defined in the file
|
|
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
|
|
// distribution for complete text of the license and disclaimer of any warranty.
|
|
//
|
|
// Alternatively, this file may be used under the terms of Open CASCADE
|
|
// commercial license or contractual agreement.
|
|
|
|
#ifndef _BRepAlgoAPI_BooleanOperation_HeaderFile
|
|
#define _BRepAlgoAPI_BooleanOperation_HeaderFile
|
|
|
|
#include <Standard.hxx>
|
|
#include <Standard_DefineAlloc.hxx>
|
|
#include <Standard_Handle.hxx>
|
|
|
|
#include <BOPAlgo_Operation.hxx>
|
|
#include <BRepAlgoAPI_BuilderAlgo.hxx>
|
|
class BOPAlgo_PaveFiller;
|
|
class TopoDS_Shape;
|
|
|
|
//! The root API class for performing Boolean Operations on arbitrary shapes.
|
|
//!
|
|
//! The arguments of the operation are divided in two groups - *Objects* and *Tools*.
|
|
//! Each group can contain any number of shapes, but each shape should be valid
|
|
//! in terms of *BRepCheck_Analyzer* and *BOPAlgo_ArgumentAnalyzer*.
|
|
//! The algorithm builds the splits of the given arguments using the intersection
|
|
//! results and combines the result of Boolean Operation of given type:
|
|
//! - *FUSE* - union of two groups of objects;
|
|
//! - *COMMON* - intersection of two groups of objects;
|
|
//! - *CUT* - subtraction of one group from the other;
|
|
//! - *SECTION* - section edges and vertices of all arguments;
|
|
//!
|
|
//! The rules for the arguments and type of the operation are the following:
|
|
//! - For Boolean operation *FUSE* all arguments should have equal dimensions;
|
|
//! - For Boolean operation *CUT* the minimal dimension of *Tools* should not be
|
|
//! less than the maximal dimension of *Objects*;
|
|
//! - For Boolean operation *COMMON* the arguments can have any dimension.
|
|
//! - For Boolean operation *SECTION* the arguments can be of any type.
|
|
//!
|
|
//! Additionally to the errors of the base class the algorithm returns
|
|
//! the following Errors:<br>
|
|
//! - *BOPAlgo_AlertBOPNotSet* - in case the type of Boolean Operation is not set.<br>
|
|
class BRepAlgoAPI_BooleanOperation : public BRepAlgoAPI_BuilderAlgo
|
|
{
|
|
public:
|
|
|
|
DEFINE_STANDARD_ALLOC
|
|
|
|
public: //! @name Constructors
|
|
|
|
//! Empty constructor
|
|
Standard_EXPORT BRepAlgoAPI_BooleanOperation();
|
|
|
|
//! Constructor with precomputed intersections of arguments.
|
|
Standard_EXPORT BRepAlgoAPI_BooleanOperation(const BOPAlgo_PaveFiller& thePF);
|
|
|
|
|
|
public: //! @name Setting/getting arguments
|
|
|
|
//! Returns the first argument involved in this Boolean operation.
|
|
//! Obsolete
|
|
const TopoDS_Shape& Shape1() const
|
|
{
|
|
return myArguments.First();
|
|
}
|
|
|
|
//! Returns the second argument involved in this Boolean operation.
|
|
//! Obsolete
|
|
const TopoDS_Shape& Shape2() const
|
|
{
|
|
return myTools.First();
|
|
}
|
|
|
|
//! Sets the Tool arguments
|
|
void SetTools(const TopTools_ListOfShape& theLS)
|
|
{
|
|
myTools = theLS;
|
|
}
|
|
|
|
//! Returns the Tools arguments
|
|
const TopTools_ListOfShape& Tools() const
|
|
{
|
|
return myTools;
|
|
}
|
|
|
|
|
|
public: //! @name Setting/Getting the type of Boolean operation
|
|
|
|
//! Sets the type of Boolean operation
|
|
void SetOperation(const BOPAlgo_Operation theBOP)
|
|
{
|
|
myOperation = theBOP;
|
|
}
|
|
|
|
//! Returns the type of Boolean Operation
|
|
BOPAlgo_Operation Operation() const
|
|
{
|
|
return myOperation;
|
|
}
|
|
|
|
|
|
public: //! @name Performing the operation
|
|
|
|
//! Performs the Boolean operation.
|
|
Standard_EXPORT virtual void Build() Standard_OVERRIDE;
|
|
|
|
|
|
protected: //! @name Constructors
|
|
|
|
//! Constructor to perform Boolean operation on only two arguments.
|
|
//! Obsolete
|
|
Standard_EXPORT BRepAlgoAPI_BooleanOperation(const TopoDS_Shape& theS1,
|
|
const TopoDS_Shape& theS2,
|
|
const BOPAlgo_Operation theOperation);
|
|
|
|
//! Constructor to perform Boolean operation on only two arguments
|
|
//! with precomputed intersection results.
|
|
//! Obsolete
|
|
Standard_EXPORT BRepAlgoAPI_BooleanOperation(const TopoDS_Shape& theS1,
|
|
const TopoDS_Shape& theS2,
|
|
const BOPAlgo_PaveFiller& thePF,
|
|
const BOPAlgo_Operation theOperation);
|
|
|
|
|
|
protected: //! @name Fields
|
|
|
|
TopTools_ListOfShape myTools; //!< Tool arguments of operation
|
|
BOPAlgo_Operation myOperation; //!< Type of Boolean Operation
|
|
|
|
};
|
|
|
|
#endif // _BRepAlgoAPI_BooleanOperation_HeaderFile
|