mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-04-16 10:08:36 +03:00
d03c08988c
Update BOP commands to use progress indicator Deleted wrong usage of progress indicator from bop operations Added UserBreak() method to break execution boolean operation if progress indicator is used Added method AnalyzeProgress() to calculate steps of progress indicator Introduce BOPAlgo_ParallelAlgo which has myRange as a field to be used in parallel vector. Provide suitable way of keeping the progress steps of operations. Give meaningful names to progress scopes. Propagate progress indicator into deeper methods of BOA. Add progress indicator to BOPAlgo_BuilderFace and BOPAlgo_WireSplitter, BOPAlgo_BuilderSolid and BOPAlgo_ShellSplitter
313 lines
13 KiB
C++
313 lines
13 KiB
C++
// Created on: 1995-08-31
|
|
// Created by: Remi LEQUETTE
|
|
// Copyright (c) 1995-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 _BRepFilletAPI_MakeFillet2d_HeaderFile
|
|
#define _BRepFilletAPI_MakeFillet2d_HeaderFile
|
|
|
|
#include <Standard.hxx>
|
|
#include <Standard_DefineAlloc.hxx>
|
|
#include <Standard_Handle.hxx>
|
|
|
|
#include <ChFi2d_Builder.hxx>
|
|
#include <BRepBuilderAPI_MakeShape.hxx>
|
|
#include <Standard_Real.hxx>
|
|
#include <Standard_Boolean.hxx>
|
|
#include <TopTools_SequenceOfShape.hxx>
|
|
#include <Standard_Integer.hxx>
|
|
#include <TopTools_ListOfShape.hxx>
|
|
#include <ChFi2d_ConstructionError.hxx>
|
|
class TopoDS_Face;
|
|
class TopoDS_Edge;
|
|
class TopoDS_Vertex;
|
|
class TopoDS_Shape;
|
|
|
|
// resolve name collisions with X11 headers
|
|
#ifdef Status
|
|
#undef Status
|
|
#endif
|
|
|
|
//! Describes functions to build fillets and chamfers on the
|
|
//! vertices of a planar face.
|
|
//! Fillets and Chamfers on the Vertices of a Planar Face
|
|
//! A MakeFillet2d object provides a framework for:
|
|
//! - initializing the construction algorithm with a given face,
|
|
//! - acquiring the data characterizing the fillets and chamfers,
|
|
//! - building the fillets and chamfers, and constructing the
|
|
//! resulting shape, and
|
|
//! - consulting the result.
|
|
//! Warning
|
|
//! Only segments of straight lines and arcs of circles are
|
|
//! treated. BSplines are not processed.
|
|
class BRepFilletAPI_MakeFillet2d : public BRepBuilderAPI_MakeShape
|
|
{
|
|
public:
|
|
|
|
DEFINE_STANDARD_ALLOC
|
|
|
|
|
|
//! Initializes an empty algorithm for computing fillets and
|
|
//! chamfers. The face on which the fillets and
|
|
//! chamfers are built is defined using the Init function.
|
|
//! The vertices on which fillets or chamfers are built are
|
|
//! defined using the AddFillet or AddChamfer function.
|
|
//! Warning
|
|
//! The status of the initialization, as given by the Status
|
|
//! function, can be one of the following:
|
|
//! - ChFi2d_Ready if the initialization is correct,
|
|
//! - ChFi2d_NotPlanar if F is not planar,
|
|
//! - ChFi2d_NoFace if F is a null face.
|
|
Standard_EXPORT BRepFilletAPI_MakeFillet2d();
|
|
|
|
//! Initializes an algorithm for computing fillets and chamfers on the face F.
|
|
//! The vertices on which fillets or chamfers are built are
|
|
//! defined using the AddFillet or AddChamfer function.
|
|
//! Warning
|
|
//! The status of the initialization, as given by the Status
|
|
//! function, can be one of the following:
|
|
//! - ChFi2d_Ready if the initialization is correct,
|
|
//! - ChFi2d_NotPlanar if F is not planar,
|
|
//! - ChFi2d_NoFace if F is a null face.
|
|
Standard_EXPORT BRepFilletAPI_MakeFillet2d(const TopoDS_Face& F);
|
|
|
|
//! Initializes this algorithm for constructing fillets or
|
|
//! chamfers with the face F.
|
|
//! Warning
|
|
//! The status of the initialization, as given by the Status
|
|
//! function, can be one of the following:
|
|
//! - ChFi2d_Ready if the initialization is correct,
|
|
//! - ChFi2d_NotPlanar if F is not planar,
|
|
//! - ChFi2d_NoFace if F is a null face.
|
|
Standard_EXPORT void Init (const TopoDS_Face& F);
|
|
|
|
//! This initialize method allow to init the builder
|
|
//! from a face RefFace and another face ModFace which derive from RefFace.
|
|
//! This is useful to modify a fillet or a chamfer already created on ModFace.
|
|
Standard_EXPORT void Init (const TopoDS_Face& RefFace, const TopoDS_Face& ModFace);
|
|
|
|
//! Adds a fillet of radius Radius between the two edges
|
|
//! adjacent to the vertex V on the face modified by this
|
|
//! algorithm. The two edges do not need to be rectilinear.
|
|
//! This function returns the fillet and builds the resulting face.
|
|
//! Warning
|
|
//! The status of the construction, as given by the Status
|
|
//! function, can be one of the following:
|
|
//! - ChFi2d_IsDone if the fillet is built,
|
|
//! - ChFi2d_ConnexionError if V does not belong to the initial face,
|
|
//! - ChFi2d_ComputationError if Radius is too large
|
|
//! to build a fillet between the two adjacent edges,
|
|
//! - ChFi2d_NotAuthorized
|
|
//! - if one of the two edges connected to V is a fillet or chamfer, or
|
|
//! - if a curve other than a straight line or an arc of a
|
|
//! circle is used as E, E1 or E2.
|
|
//! Do not use the returned fillet if the status of the construction is not ChFi2d_IsDone.
|
|
//! Exceptions
|
|
//! Standard_NegativeValue if Radius is less than or equal to zero.
|
|
Standard_EXPORT TopoDS_Edge AddFillet (const TopoDS_Vertex& V, const Standard_Real Radius);
|
|
|
|
//! Assigns the radius Radius to the fillet Fillet already
|
|
//! built on the face modified by this algorithm.
|
|
//! This function returns the new fillet and modifies the existing face.
|
|
//! Warning
|
|
//! The status of the construction, as given by the Status
|
|
//! function, can be one of the following:
|
|
//! - ChFi2d_IsDone if the new fillet is built,
|
|
//! - ChFi2d_ConnexionError if Fillet does not
|
|
//! belong to the existing face,
|
|
//! - ChFi2d_ComputationError if Radius is too
|
|
//! large to build a fillet between the two adjacent edges.
|
|
//! Do not use the returned fillet if the status of the
|
|
//! construction is not ChFi2d_IsDone.
|
|
//! Exceptions
|
|
//! Standard_NegativeValue if Radius is less than or equal to zero.
|
|
Standard_EXPORT TopoDS_Edge ModifyFillet (const TopoDS_Edge& Fillet, const Standard_Real Radius);
|
|
|
|
//! Removes the fillet Fillet already built on the face
|
|
//! modified by this algorithm.
|
|
//! This function returns the vertex connecting the two
|
|
//! adjacent edges of Fillet and modifies the existing face.
|
|
//! Warning
|
|
//! - The returned vertex is only valid if the Status
|
|
//! function returns ChFi2d_IsDone.
|
|
//! - A null vertex is returned if the edge Fillet does not
|
|
//! belong to the initial face.
|
|
Standard_EXPORT TopoDS_Vertex RemoveFillet (const TopoDS_Edge& Fillet);
|
|
|
|
//! Adds a chamfer on the face modified by this algorithm
|
|
//! between the two adjacent edges E1 and E2, where
|
|
//! the extremities of the chamfer are on E1 and E2 at
|
|
//! distances D1 and D2 respectively
|
|
//! In cases where the edges are not rectilinear, distances
|
|
//! are measured using the curvilinear abscissa of the
|
|
//! edges and the angle is measured with respect to the
|
|
//! tangent at the corresponding point.
|
|
//! The angle Ang is given in radians.
|
|
//! This function returns the chamfer and builds the resulting face.
|
|
Standard_EXPORT TopoDS_Edge AddChamfer (const TopoDS_Edge& E1, const TopoDS_Edge& E2, const Standard_Real D1, const Standard_Real D2);
|
|
|
|
//! Adds a chamfer on the face modified by this algorithm
|
|
//! between the two edges connected by the vertex V,
|
|
//! where E is one of the two edges. The chamfer makes
|
|
//! an angle Ang with E and one of its extremities is on
|
|
//! E at distance D from V.
|
|
//! In cases where the edges are not rectilinear, distances
|
|
//! are measured using the curvilinear abscissa of the
|
|
//! edges and the angle is measured with respect to the
|
|
//! tangent at the corresponding point.
|
|
//! The angle Ang is given in radians.
|
|
//! This function returns the chamfer and builds the resulting face.
|
|
//! Warning
|
|
//! The status of the construction, as given by the Status function, can
|
|
//! be one of the following:
|
|
//! - ChFi2d_IsDone if the chamfer is built,
|
|
//! - ChFi2d_ParametersError if D1, D2, D or Ang is less than or equal to zero,
|
|
//! - ChFi2d_ConnexionError if:
|
|
//! - the edge E, E1 or E2 does not belong to the initial face, or
|
|
//! - the edges E1 and E2 are not adjacent, or
|
|
//! - the vertex V is not one of the limit points of the edge E,
|
|
//! - ChFi2d_ComputationError if the parameters of the chamfer
|
|
//! are too large to build a chamfer between the two adjacent edges,
|
|
//! - ChFi2d_NotAuthorized if:
|
|
//! - the edge E1, E2 or one of the two edges connected to V is a fillet or chamfer, or
|
|
//! - a curve other than a straight line or an arc of a circle is used as E, E1 or E2.
|
|
//! Do not use the returned chamfer if
|
|
//! the status of the construction is not ChFi2d_IsDone.
|
|
Standard_EXPORT TopoDS_Edge AddChamfer (const TopoDS_Edge& E, const TopoDS_Vertex& V, const Standard_Real D, const Standard_Real Ang);
|
|
|
|
//! Modifies the chamfer Chamfer on the face modified
|
|
//! by this algorithm, where:
|
|
//! E1 and E2 are the two adjacent edges on which
|
|
//! Chamfer is already built; the extremities of the new
|
|
//! chamfer are on E1 and E2 at distances D1 and D2 respectively.
|
|
Standard_EXPORT TopoDS_Edge ModifyChamfer (const TopoDS_Edge& Chamfer, const TopoDS_Edge& E1, const TopoDS_Edge& E2, const Standard_Real D1, const Standard_Real D2);
|
|
|
|
//! Modifies the chamfer Chamfer on the face modified
|
|
//! by this algorithm, where:
|
|
//! E is one of the two adjacent edges on which
|
|
//! Chamfer is already built; the new chamfer makes
|
|
//! an angle Ang with E and one of its extremities is
|
|
//! on E at distance D from the vertex on which the chamfer is built.
|
|
//! In cases where the edges are not rectilinear, the
|
|
//! distances are measured using the curvilinear abscissa
|
|
//! of the edges and the angle is measured with respect
|
|
//! to the tangent at the corresponding point.
|
|
//! The angle Ang is given in radians.
|
|
//! This function returns the new chamfer and modifies the existing face.
|
|
//! Warning
|
|
//! The status of the construction, as given by the Status
|
|
//! function, can be one of the following:
|
|
//! - ChFi2d_IsDone if the chamfer is built,
|
|
//! - ChFi2d_ParametersError if D1, D2, D or Ang is less than or equal to zero,
|
|
//! - ChFi2d_ConnexionError if:
|
|
//! - the edge E, E1, E2 or Chamfer does not belong
|
|
//! to the existing face, or
|
|
//! - the edges E1 and E2 are not adjacent,
|
|
//! - ChFi2d_ComputationError if the parameters of
|
|
//! the chamfer are too large to build a chamfer
|
|
//! between the two adjacent edges,
|
|
//! - ChFi2d_NotAuthorized if E1 or E2 is a fillet or chamfer.
|
|
//! Do not use the returned chamfer if the status of the
|
|
//! construction is not ChFi2d_IsDone.
|
|
Standard_EXPORT TopoDS_Edge ModifyChamfer (const TopoDS_Edge& Chamfer, const TopoDS_Edge& E, const Standard_Real D, const Standard_Real Ang);
|
|
|
|
//! Removes the chamfer Chamfer already built on the face
|
|
//! modified by this algorithm.
|
|
//! This function returns the vertex connecting the two
|
|
//! adjacent edges of Chamfer and modifies the existing face.
|
|
//! Warning
|
|
//! - The returned vertex is only valid if the Status
|
|
//! function returns ChFi2d_IsDone.
|
|
//! - A null vertex is returned if the edge Chamfer does
|
|
//! not belong to the initial face.
|
|
Standard_EXPORT TopoDS_Vertex RemoveChamfer (const TopoDS_Edge& Chamfer);
|
|
|
|
//! Returns true if the edge E on the face modified by this
|
|
//! algorithm is chamfered or filleted.
|
|
//! Warning
|
|
//! Returns false if E does not belong to the face modified by this algorithm.
|
|
Standard_Boolean IsModified (const TopoDS_Edge& E) const;
|
|
|
|
//! Returns the table of fillets on the face modified by this algorithm.
|
|
const TopTools_SequenceOfShape& FilletEdges() const;
|
|
|
|
//! Returns the number of fillets on the face modified by this algorithm.
|
|
Standard_Integer NbFillet() const;
|
|
|
|
//! Returns the table of chamfers on the face modified by this algorithm.
|
|
const TopTools_SequenceOfShape& ChamferEdges() const;
|
|
|
|
//! Returns the number of chamfers on the face modified by this algorithm.
|
|
Standard_Integer NbChamfer() const;
|
|
|
|
//! Returns the list of shapes modified from the shape
|
|
//! <S>.
|
|
Standard_EXPORT virtual const TopTools_ListOfShape& Modified (const TopoDS_Shape& S) Standard_OVERRIDE;
|
|
|
|
//! returns the number of new curves
|
|
//! after the shape creation.
|
|
Standard_EXPORT Standard_Integer NbCurves() const;
|
|
|
|
//! Return the Edges created for curve I.
|
|
Standard_EXPORT const TopTools_ListOfShape& NewEdges (const Standard_Integer I);
|
|
|
|
Standard_Boolean HasDescendant (const TopoDS_Edge& E) const;
|
|
|
|
//! Returns the chamfered or filleted edge built from the
|
|
//! edge E on the face modified by this algorithm. If E has
|
|
//! not been modified, this function returns E.
|
|
//! Exceptions
|
|
//! Standard_NoSuchObject if the edge E does not
|
|
//! belong to the initial face.
|
|
const TopoDS_Edge& DescendantEdge (const TopoDS_Edge& E) const;
|
|
|
|
//! Returns the basis edge on the face modified by this
|
|
//! algorithm from which the chamfered or filleted edge E is
|
|
//! built. If E has not been modified, this function returns E.
|
|
//! Warning
|
|
//! E is returned if it does not belong to the initial face.
|
|
Standard_EXPORT const TopoDS_Edge& BasisEdge (const TopoDS_Edge& E) const;
|
|
|
|
ChFi2d_ConstructionError Status() const;
|
|
|
|
//! Update the result and set the Done flag
|
|
Standard_EXPORT virtual void Build(const Message_ProgressRange& theRange = Message_ProgressRange()) Standard_OVERRIDE;
|
|
|
|
|
|
|
|
|
|
protected:
|
|
|
|
|
|
|
|
|
|
|
|
private:
|
|
|
|
|
|
|
|
ChFi2d_Builder myMakeChFi2d;
|
|
|
|
|
|
};
|
|
|
|
|
|
#include <BRepFilletAPI_MakeFillet2d.lxx>
|
|
|
|
|
|
|
|
|
|
|
|
#endif // _BRepFilletAPI_MakeFillet2d_HeaderFile
|