include/opencascade/BRepTools_CopyModification.hxx

0001 // Copyright (c) 1999-2022 OPEN CASCADE SAS
0002 //
0003 // This file is part of Open CASCADE Technology software library.
0004 //
0005 // This library is free software; you can redistribute it and/or modify it under
0006 // the terms of the GNU Lesser General Public License version 2.1 as published
0007 // by the Free Software Foundation, with special exception defined in the file
0008 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
0009 // distribution for complete text of the license and disclaimer of any warranty.
0010 //
0011 // Alternatively, this file may be used under the terms of Open CASCADE
0012 // commercial license or contractual agreement.
0013
0014 #ifndef _BRepTools_CopyModification_HeaderFile
0015 #define _BRepTools_CopyModification_HeaderFile
0016
0017 #include <BRepTools_Modification.hxx>
0018
0019 class BRepTools_CopyModification;
0020 DEFINE_STANDARD_HANDLE(BRepTools_CopyModification, BRepTools_Modification)
0021
0022 //! Tool class implementing necessary functionality for copying geometry and triangulation.
0023 class BRepTools_CopyModification : public BRepTools_Modification
0024 {
0025 public:
0026   //! Constructor.
0027   //! \param[in] theCopyGeom  indicates that the geomtery (surfaces and curves) should be copied
0028   //! \param[in] theCopyMesh  indicates that the triangulation should be copied
0029   Standard_EXPORT explicit BRepTools_CopyModification(const Standard_Boolean theCopyGeom = Standard_True,
0030                                                       const Standard_Boolean theCopyMesh = Standard_True);
0031
0032   //! Returns true if theFace has been modified.
0033   //! If the face has been modified:
0034   //! - theSurf is the new geometry of the face,
0035   //! - theLoc is its new location, and
0036   //! - theTol is the new tolerance.
0037   //! theRevWires, theRevFace are always set to false, because the orientaion is not changed.
0038   Standard_EXPORT Standard_Boolean NewSurface(const TopoDS_Face&    theFace,
0039                                               Handle(Geom_Surface)& theSurf,
0040                                               TopLoc_Location&      theLoc,
0041                                               Standard_Real&        theTol,
0042                                               Standard_Boolean&     theRevWires,
0043                                               Standard_Boolean&     theRevFace) Standard_OVERRIDE;
0044
0045   //! Returns true if theEdge has been modified.
0046   //! If the edge has been modified:
0047   //! - theCurve is the new geometric support of the edge,
0048   //! - theLoc is the new location, and
0049   //! - theTol is the new tolerance.
0050   //! If the edge has not been modified, this function
0051   //! returns false, and the values of theCurve, theLoc and theTol are not significant.
0052   Standard_EXPORT Standard_Boolean NewCurve(const TopoDS_Edge&  theEdge,
0053                                             Handle(Geom_Curve)& theCurve,
0054                                             TopLoc_Location&    theLoc,
0055                                             Standard_Real&      theTol) Standard_OVERRIDE;
0056
0057   //! Returns true if theVertex has been modified.
0058   //! If the vertex has been modified:
0059   //! - thePnt is the new geometry of the vertex, and
0060   //! - theTol is the new tolerance.
0061   //! If the vertex has not been modified this function
0062   //! returns false, and the values of thePnt and theTol are not significant.
0063   Standard_EXPORT Standard_Boolean NewPoint(const TopoDS_Vertex& theVertex, gp_Pnt& thePnt, Standard_Real& theTol) Standard_OVERRIDE;
0064
0065   //! Returns true if theEdge has a new curve on surface on theFace.
0066   //! If a new curve exists:
0067   //! - theCurve is the new geometric support of the edge,
0068   //! - theTol the new tolerance.
0069   //! If no new curve exists, this function returns false, and
0070   //! the values of theCurve and theTol are not significant.
0071   Standard_EXPORT Standard_Boolean NewCurve2d(const TopoDS_Edge&    theEdge,
0072                                               const TopoDS_Face&    theFace,
0073                                               const TopoDS_Edge&    theNewEdge,
0074                                               const TopoDS_Face&    theNewFace,
0075                                               Handle(Geom2d_Curve)& theCurve,
0076                                               Standard_Real&        theTol) Standard_OVERRIDE;
0077
0078   //! Returns true if theVertex has a new parameter on theEdge.
0079   //! If a new parameter exists:
0080   //! - thePnt is the parameter, and
0081   //! - theTol is the new tolerance.
0082   //! If no new parameter exists, this function returns false,
0083   //! and the values of thePnt and theTol are not significant.
0084   Standard_EXPORT Standard_Boolean NewParameter(const TopoDS_Vertex& theVertex,
0085                                                 const TopoDS_Edge&   theEdge,
0086                                                 Standard_Real&       thePnt,
0087                                                 Standard_Real&       theTol) Standard_OVERRIDE;
0088
0089   //! Returns the continuity of theNewEdge between theNewFace1 and theNewFace2.
0090   //!
0091   //! theNewEdge is the new edge created from theEdge.  theNewFace1
0092   //! (resp. theNewFace2) is the new face created from theFace1 (resp. theFace2).
0093   Standard_EXPORT GeomAbs_Shape Continuity(const TopoDS_Edge& theEdge,
0094                                            const TopoDS_Face& theFace1,
0095                                            const TopoDS_Face& theFace2,
0096                                            const TopoDS_Edge& theNewEdge,
0097                                            const TopoDS_Face& theNewFace1,
0098                                            const TopoDS_Face& theNewFace2) Standard_OVERRIDE;
0099
0100   //! Returns true if the face has been modified according to changed triangulation.
0101   //! If the face has been modified:
0102   //! - theTri is a new triangulation on the face
0103   Standard_EXPORT Standard_Boolean NewTriangulation(const TopoDS_Face& theFace, Handle(Poly_Triangulation)& theTri) Standard_OVERRIDE;
0104
0105   //! Returns true if the edge has been modified according to changed polygon.
0106   //! If the edge has been modified:
0107   //! - thePoly is a new polygon
0108   Standard_EXPORT Standard_Boolean NewPolygon(const TopoDS_Edge& theEdge, Handle(Poly_Polygon3D)& thePoly) Standard_OVERRIDE;
0109
0110   //! Returns true if the edge has been modified according to changed polygon on triangulation.
0111   //! If the edge has been modified:
0112   //! - thePoly is a new polygon on triangulation
0113   Standard_EXPORT Standard_Boolean NewPolygonOnTriangulation(const TopoDS_Edge&                   theEdge,
0114                                                              const TopoDS_Face&                   theFace,
0115                                                              Handle(Poly_PolygonOnTriangulation)& thePoly) Standard_OVERRIDE;
0116
0117   DEFINE_STANDARD_RTTIEXT(BRepTools_CopyModification, BRepTools_Modification)
0118
0119 private:
0120   Standard_Boolean myCopyGeom;
0121   Standard_Boolean myCopyMesh;
0122 };
0123
0124 #endif // _BRepTools_CopyModification_HeaderFile