1
0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-05-26 11:05:31 +03:00
occt/src/ShapeBuild/ShapeBuild_ReShape.hxx
2021-04-22 14:50:47 +03:00

131 lines
4.5 KiB
C++

// Created on: 1998-06-03
// Created by: data exchange team
// 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 _ShapeBuild_ReShape_HeaderFile
#define _ShapeBuild_ReShape_HeaderFile
#include <Standard.hxx>
#include <Standard_Type.hxx>
#include <BRepTools_ReShape.hxx>
#include <TopAbs_ShapeEnum.hxx>
#include <Standard_Integer.hxx>
#include <Standard_Boolean.hxx>
#include <ShapeExtend_Status.hxx>
class TopoDS_Shape;
// resolve name collisions with X11 headers
#ifdef Status
#undef Status
#endif
class ShapeBuild_ReShape;
DEFINE_STANDARD_HANDLE(ShapeBuild_ReShape, BRepTools_ReShape)
//! Rebuilds a Shape by making pre-defined substitutions on some
//! of its components
//!
//! In a first phase, it records requests to replace or remove
//! some individual shapes
//! For each shape, the last given request is recorded
//! Requests may be applied "Oriented" (i.e. only to an item with
//! the SAME orientation) or not (the orientation of replacing
//! shape is respectful of that of the original one)
//!
//! Then, these requests may be applied to any shape which may
//! contain one or more of these individual shapes
class ShapeBuild_ReShape : public BRepTools_ReShape
{
public:
//! Returns an empty Reshape
Standard_EXPORT ShapeBuild_ReShape();
//! Applies the substitutions requests to a shape
//!
//! <until> gives the level of type until which requests are taken
//! into account. For subshapes of the type <until> no rebuild
//! and further exploring are done.
//! ACTUALLY, NOT IMPLEMENTED BELOW TopAbs_FACE
//!
//! <buildmode> says how to do on a SOLID,SHELL ... if one of its
//! sub-shapes has been changed:
//! 0: at least one Replace or Remove -> COMPOUND, else as such
//! 1: at least one Remove (Replace are ignored) -> COMPOUND
//! 2: Replace and Remove are both ignored
//! If Replace/Remove are ignored or absent, the result as same
//! type as the starting shape
Standard_EXPORT virtual TopoDS_Shape Apply (const TopoDS_Shape& shape, const TopAbs_ShapeEnum until, const Standard_Integer buildmode);
//! Applies the substitutions requests to a shape.
//!
//! <until> gives the level of type until which requests are taken
//! into account. For subshapes of the type <until> no rebuild
//! and further exploring are done.
//!
//! NOTE: each subshape can be replaced by shape of the same type
//! or by shape containing only shapes of that type (for
//! example, TopoDS_Edge can be replaced by TopoDS_Edge,
//! TopoDS_Wire or TopoDS_Compound containing TopoDS_Edges).
//! If incompatible shape type is encountered, it is ignored
//! and flag FAIL1 is set in Status.
Standard_EXPORT virtual TopoDS_Shape Apply (const TopoDS_Shape& shape, const TopAbs_ShapeEnum until = TopAbs_SHAPE) Standard_OVERRIDE;
//! Returns a complete substitution status for a shape
//! 0 : not recorded, <newsh> = original <shape>
//! < 0: to be removed, <newsh> is NULL
//! > 0: to be replaced, <newsh> is a new item
//! If <last> is False, returns status and new shape recorded in
//! the map directly for the shape, if True and status > 0 then
//! recursively searches for the last status and new shape.
Standard_EXPORT virtual Standard_Integer Status (const TopoDS_Shape& shape, TopoDS_Shape& newsh, const Standard_Boolean last = Standard_False) Standard_OVERRIDE;
//! Queries the status of last call to Apply(shape,enum)
//! OK : no (sub)shapes replaced or removed
//! DONE1: source (starting) shape replaced
//! DONE2: source (starting) shape removed
//! DONE3: some subshapes replaced
//! DONE4: some subshapes removed
//! FAIL1: some replacements not done because of bad type of subshape
Standard_EXPORT virtual Standard_Boolean Status (const ShapeExtend_Status status) const;
DEFINE_STANDARD_RTTIEXT(ShapeBuild_ReShape,BRepTools_ReShape)
protected:
private:
};
#endif // _ShapeBuild_ReShape_HeaderFile