include/opencascade/BRepBuilderAPI_Copy.hxx

0001 // Created on: 1994-12-12
0002 // Created by: Jacques GOUSSARD
0003 // Copyright (c) 1994-1999 Matra Datavision
0004 // Copyright (c) 1999-2014 OPEN CASCADE SAS
0005 //
0006 // This file is part of Open CASCADE Technology software library.
0007 //
0008 // This library is free software; you can redistribute it and/or modify it under
0009 // the terms of the GNU Lesser General Public License version 2.1 as published
0010 // by the Free Software Foundation, with special exception defined in the file
0011 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
0012 // distribution for complete text of the license and disclaimer of any warranty.
0013 //
0014 // Alternatively, this file may be used under the terms of Open CASCADE
0015 // commercial license or contractual agreement.
0016
0017 #ifndef _BRepBuilderAPI_Copy_HeaderFile
0018 #define _BRepBuilderAPI_Copy_HeaderFile
0019
0020 #include <Standard.hxx>
0021 #include <Standard_DefineAlloc.hxx>
0022
0023 #include <BRepBuilderAPI_ModifyShape.hxx>
0024
0025 class TopoDS_Shape;
0026
0027 //! Duplication of a shape.
0028 //! A Copy object provides a framework for:
0029 //! -   defining the construction of a duplicate shape,
0030 //! -   implementing the construction algorithm, and
0031 //! -   consulting the result.
0032 class BRepBuilderAPI_Copy : public BRepBuilderAPI_ModifyShape
0033 {
0034 public:
0035   DEFINE_STANDARD_ALLOC
0036
0037   //! Constructs an empty copy framework. Use the function
0038   //! Perform to copy shapes.
0039   Standard_EXPORT BRepBuilderAPI_Copy();
0040
0041   //! Constructs a copy framework and copies the shape S.
0042   //! Use the function Shape to access the result.
0043   //! If copyMesh is True, triangulation contained in original shape will be
0044   //! copied along with geometry (by default, triangulation gets lost).
0045   //! If copyGeom is False, only topological objects will be copied, while
0046   //! geometry and triangulation will be shared with original shape.
0047   //! Note: the constructed framework can be reused to copy
0048   //! other shapes: just specify them with the function Perform.
0049   Standard_EXPORT BRepBuilderAPI_Copy(const TopoDS_Shape& S,
0050                                       const bool          copyGeom = true,
0051                                       const bool          copyMesh = false);
0052
0053   //! Copies the shape S.
0054   //! Use the function Shape to access the result.
0055   //! If copyMesh is True, triangulation contained in original shape will be
0056   //! copied along with geometry (by default, triangulation gets lost).
0057   //! If copyGeom is False, only topological objects will be copied, while
0058   //! geometry and triangulation will be shared with original shape.
0059   Standard_EXPORT void Perform(const TopoDS_Shape& S,
0060                                const bool          copyGeom = true,
0061                                const bool          copyMesh = false);
0062 };
0063
0064 #endif // _BRepBuilderAPI_Copy_HeaderFile