// Created on: 1998-08-26 // Created by: Julia GERASIMOVA // Copyright (c) 1998-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 _BRepFill_Filling_HeaderFile #define _BRepFill_Filling_HeaderFile #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include class StdFail_NotDone; class Standard_OutOfRange; class Standard_ConstructionError; class TopoDS_Face; class TopoDS_Edge; class gp_Pnt; class TopoDS_Shape; //! N-Side Filling //! This algorithm avoids to build a face from: //! * a set of edges defining the bounds of the face and some //! constraints the surface support has to satisfy //! * a set of edges and points defining some constraints //! the support surface has to satisfy //! * an initial surface to deform for satisfying the constraints //! * a set of parameters to control the constraints. //! //! The support surface of the face is computed by deformation //! of the initial surface in order to satisfy the given constraints. //! The set of bounding edges defines the wire of the face. //! //! If no initial surface is given, the algorithm computes it //! automatically. //! If the set of edges is not connected (Free constraint) //! missing edges are automatically computed. //! //! Limitations: //! * If some constraints are not compatible //! The algorithm does not take them into account. //! So the constraints will not be satisfyed in an area containing //! the incompatibilitries. //! * The constraints defining the bound of the face have to be //! entered in order to have a continuous wire. //! //! Other Applications: //! * Deformation of a face to satisfy internal constraints //! * Deformation of a face to improve Gi continuity with //! connected faces class BRepFill_Filling { public: DEFINE_STANDARD_ALLOC //! Constructor Standard_EXPORT BRepFill_Filling(const Standard_Integer Degree = 3, const Standard_Integer NbPtsOnCur = 15, const Standard_Integer NbIter = 2, const Standard_Boolean Anisotropie = Standard_False, const Standard_Real Tol2d = 0.00001, const Standard_Real Tol3d = 0.0001, const Standard_Real TolAng = 0.01, const Standard_Real TolCurv = 0.1, const Standard_Integer MaxDeg = 8, const Standard_Integer MaxSegments = 9); //! Sets the values of Tolerances used to control the constraint. //! Tol2d: //! Tol3d: it is the maximum distance allowed between the support surface //! and the constraints //! TolAng: it is the maximum angle allowed between the normal of the surface //! and the constraints //! TolCurv: it is the maximum difference of curvature allowed between //! the surface and the constraint Standard_EXPORT void SetConstrParam (const Standard_Real Tol2d = 0.00001, const Standard_Real Tol3d = 0.0001, const Standard_Real TolAng = 0.01, const Standard_Real TolCurv = 0.1); //! Sets the parameters used for resolution. //! The default values of these parameters have been chosen for a good //! ratio quality/performance. //! Degree: it is the order of energy criterion to minimize for computing //! the deformation of the surface. //! The default value is 3 //! The recommanded value is i+2 where i is the maximum order of the //! constraints. //! NbPtsOnCur: it is the average number of points for discretisation //! of the edges. //! NbIter: it is the maximum number of iterations of the process. //! For each iteration the number of discretisation points is //! increased. //! Anisotropie: Standard_EXPORT void SetResolParam (const Standard_Integer Degree = 3, const Standard_Integer NbPtsOnCur = 15, const Standard_Integer NbIter = 2, const Standard_Boolean Anisotropie = Standard_False); //! Sets the parameters used for approximation of the surface Standard_EXPORT void SetApproxParam (const Standard_Integer MaxDeg = 8, const Standard_Integer MaxSegments = 9); //! Loads the initial Surface //! The initial surface must have orthogonal local coordinates, //! i.e. partial derivatives dS/du and dS/dv must be orthogonal //! at each point of surface. //! If this condition breaks, distortions of resulting surface //! are possible. Standard_EXPORT void LoadInitSurface (const TopoDS_Face& aFace); //! Adds a new constraint which also defines an edge of the wire //! of the face //! Order: Order of the constraint: //! GeomAbs_C0 : the surface has to pass by 3D representation //! of the edge //! GeomAbs_G1 : the surface has to pass by 3D representation //! of the edge and to respect tangency with the first //! face of the edge //! GeomAbs_G2 : the surface has to pass by 3D representation //! of the edge and to respect tangency and curvature //! with the first face of the edge. Standard_EXPORT Standard_Integer Add (const TopoDS_Edge& anEdge, const GeomAbs_Shape Order, const Standard_Boolean IsBound = Standard_True); //! Adds a new constraint which also defines an edge of the wire //! of the face //! Order: Order of the constraint: //! GeomAbs_C0 : the surface has to pass by 3D representation //! of the edge //! GeomAbs_G1 : the surface has to pass by 3D representation //! of the edge and to respect tangency with the //! given face //! GeomAbs_G2 : the surface has to pass by 3D representation //! of the edge and to respect tangency and curvature //! with the given face. Standard_EXPORT Standard_Integer Add (const TopoDS_Edge& anEdge, const TopoDS_Face& Support, const GeomAbs_Shape Order, const Standard_Boolean IsBound = Standard_True); //! Adds a free constraint on a face. The corresponding edge has to //! be automatically recomputed. //! It is always a bound. Standard_EXPORT Standard_Integer Add (const TopoDS_Face& Support, const GeomAbs_Shape Order); //! Adds a punctual constraint Standard_EXPORT Standard_Integer Add (const gp_Pnt& Point); //! Adds a punctual constraint. Standard_EXPORT Standard_Integer Add (const Standard_Real U, const Standard_Real V, const TopoDS_Face& Support, const GeomAbs_Shape Order); //! Builds the resulting faces Standard_EXPORT void Build(); Standard_EXPORT Standard_Boolean IsDone() const; Standard_EXPORT TopoDS_Face Face() const; //! Returns the list of shapes generated from the //! shape . Standard_EXPORT const TopTools_ListOfShape& Generated (const TopoDS_Shape& S); Standard_EXPORT Standard_Real G0Error() const; Standard_EXPORT Standard_Real G1Error() const; Standard_EXPORT Standard_Real G2Error() const; Standard_EXPORT Standard_Real G0Error (const Standard_Integer Index); Standard_EXPORT Standard_Real G1Error (const Standard_Integer Index); Standard_EXPORT Standard_Real G2Error (const Standard_Integer Index); protected: private: //! Adds constraints to builder Standard_EXPORT void AddConstraints (const BRepFill_SequenceOfEdgeFaceAndOrder& SeqOfConstraints); //! Builds wires of maximum length Standard_EXPORT void BuildWires (TopTools_ListOfShape& EdgeList, TopTools_ListOfShape& WireList); //! Finds extremities of future edges to fix the holes between wires. //! Can properly operate only with convex contour Standard_EXPORT void FindExtremitiesOfHoles (const TopTools_ListOfShape& WireList, TopTools_SequenceOfShape& VerSeq) const; GeomPlate_BuildPlateSurface myBuilder; BRepFill_SequenceOfEdgeFaceAndOrder myBoundary; BRepFill_SequenceOfEdgeFaceAndOrder myConstraints; BRepFill_SequenceOfFaceAndOrder myFreeConstraints; GeomPlate_SequenceOfPointConstraint myPoints; TopTools_DataMapOfShapeListOfShape myOldNewMap; TopTools_ListOfShape myGenerated; TopoDS_Face myFace; TopoDS_Face myInitFace; Standard_Real myTol2d; Standard_Real myTol3d; Standard_Real myTolAng; Standard_Real myTolCurv; Standard_Integer myMaxDeg; Standard_Integer myMaxSegments; Standard_Integer myDegree; Standard_Integer myNbPtsOnCur; Standard_Integer myNbIter; Standard_Boolean myAnisotropie; Standard_Boolean myIsInitFaceGiven; Standard_Boolean myIsDone; }; #endif // _BRepFill_Filling_HeaderFile