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
0036   DEFINE_STANDARD_ALLOC
0037
0038   //! Constructs an empty copy framework. Use the function
0039   //! Perform to copy shapes.
0040   Standard_EXPORT BRepBuilderAPI_Copy();
0041
0042   //! Constructs a copy framework and copies the shape S.
0043   //! Use the function Shape to access the result.
0044   //! If copyMesh is True, triangulation contained in original shape will be
0045   //! copied along with geometry (by default, triangulation gets lost).
0046   //! If copyGeom is False, only topological objects will be copied, while
0047   //! geometry and triangulation will be shared with original shape.
0048   //! Note: the constructed framework can be reused to copy
0049   //! other shapes: just specify them with the function Perform.
0050   Standard_EXPORT BRepBuilderAPI_Copy(const TopoDS_Shape& S, const Standard_Boolean copyGeom = Standard_True, const Standard_Boolean copyMesh = Standard_False);
0051
0052   //! Copies the shape S.
0053   //! Use the function Shape to access the result.
0054   //! If copyMesh is True, triangulation contained in original shape will be
0055   //! copied along with geometry (by default, triangulation gets lost).
0056   //! If copyGeom is False, only topological objects will be copied, while
0057   //! geometry and triangulation will be shared with original shape.
0058   Standard_EXPORT void Perform (const TopoDS_Shape& S, const Standard_Boolean copyGeom = Standard_True, const Standard_Boolean copyMesh = Standard_False);
0059
0060 };
0061
0062 #endif // _BRepBuilderAPI_Copy_HeaderFile