mirror of
https://github.com/Open-Cascade-SAS/OCCT.git
synced 2026-06-14 11:37:02 +08:00
185 lines
7.2 KiB
C++
185 lines
7.2 KiB
C++
// Copyright: Open CASCADE 2014
|
|
// Created on: 2012-06-09
|
|
// Created by: jgv@ROLEX
|
|
// Copyright (c) 2012-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 _ShapeUpgrade_UnifySameDomain_HeaderFile
|
|
#define _ShapeUpgrade_UnifySameDomain_HeaderFile
|
|
|
|
#include <BRepTools_History.hxx>
|
|
#include <Standard.hxx>
|
|
#include <Standard_Type.hxx>
|
|
|
|
#include <TopoDS_Shape.hxx>
|
|
#include <Standard_Boolean.hxx>
|
|
#include <Standard_Transient.hxx>
|
|
#include <TopTools_DataMapOfShapeShape.hxx>
|
|
#include <TopTools_IndexedDataMapOfShapeListOfShape.hxx>
|
|
#include <TopTools_MapOfShape.hxx>
|
|
class ShapeBuild_ReShape;
|
|
class TopoDS_Shape;
|
|
|
|
|
|
class ShapeUpgrade_UnifySameDomain;
|
|
DEFINE_STANDARD_HANDLE(ShapeUpgrade_UnifySameDomain, Standard_Transient)
|
|
|
|
//! This tool tries to unify faces and edges of the shape which lie on the same geometry.
|
|
//! Faces/edges are considering as 'same-domain' if a group of neighbouring faces/edges
|
|
//! are lying on coincident surfaces/curves.
|
|
//! In this case these faces/edges can be unified into one face/edge.
|
|
//! ShapeUpgrade_UnifySameDomain is initialized by a shape and the next optional parameters:
|
|
//! UnifyFaces - tries to unify all possible faces
|
|
//! UnifyEdges - tries to unify all possible edges
|
|
//! ConcatBSplines - if this flag is set to true then all neighbouring edges, which lay
|
|
//! on BSpline or Bezier curves with C1 continuity on their common vertices,
|
|
//! will be merged into one common edge.
|
|
//!
|
|
//! The input shape can be of any type containing faces or edges - compsolid, solid, shell,
|
|
//! wire, compound of any kind of shapes. The algorithm preserves the structure of compsolids,
|
|
//! solids, shells and wires. E.g., if two shells have a common edge and the faces sharing
|
|
//! this edge lie on the same surface the algorithm will not unify these faces, otherwise
|
|
//! the structure of shells would be broken. However, if such faces belong to different
|
|
//! compounds of faces they will be unified.
|
|
//!
|
|
//! The output result of the tool is the unified shape.
|
|
//!
|
|
//! All the modifications of initial shape are recorded during unifying.
|
|
//! Methods History are intended to: <br>
|
|
//! - set a place holder for the history of modifications of sub-shapes of
|
|
//! the initial shape; <br>
|
|
//! - get the collected history. <br>
|
|
//! The algorithm provides a place holder for the history and collects the
|
|
//! history by default.
|
|
//! To avoid collecting of the history the place holder should be set to null handle.
|
|
class ShapeUpgrade_UnifySameDomain : public Standard_Transient
|
|
{
|
|
|
|
public:
|
|
//! Empty constructor
|
|
Standard_EXPORT ShapeUpgrade_UnifySameDomain();
|
|
|
|
//! Constructor defining input shape and necessary flags.
|
|
//! It does not perform unification.
|
|
Standard_EXPORT ShapeUpgrade_UnifySameDomain
|
|
(const TopoDS_Shape& aShape,
|
|
const Standard_Boolean UnifyEdges = Standard_True,
|
|
const Standard_Boolean UnifyFaces = Standard_True,
|
|
const Standard_Boolean ConcatBSplines = Standard_False);
|
|
|
|
//! Initializes with a shape and necessary flags.
|
|
//! It does not perform unification.
|
|
//! If you intend to nullify the History place holder do it after
|
|
//! initialization.
|
|
Standard_EXPORT void Initialize
|
|
(const TopoDS_Shape& aShape,
|
|
const Standard_Boolean UnifyEdges = Standard_True,
|
|
const Standard_Boolean UnifyFaces = Standard_True,
|
|
const Standard_Boolean ConcatBSplines = Standard_False);
|
|
|
|
//! Sets the flag defining whether it is allowed to create
|
|
//! internal edges inside merged faces in the case of non-manifold
|
|
//! topology. Without this flag merging through multi connected edge
|
|
//! is forbidden. Default value is false.
|
|
Standard_EXPORT void AllowInternalEdges (const Standard_Boolean theValue);
|
|
|
|
//! Sets the shape for avoid merging of the faces/edges.
|
|
//! This shape can be vertex or edge.
|
|
//! If the shape is a vertex it forbids merging of connected edges.
|
|
//! If the shape is a edge it forbids merging of connected faces.
|
|
//! This method can be called several times to keep several shapes.
|
|
Standard_EXPORT void KeepShape(const TopoDS_Shape& theShape);
|
|
|
|
//! Sets the map of shapes for avoid merging of the faces/edges.
|
|
//! It allows passing a ready to use map instead of calling many times
|
|
//! the method KeepShape.
|
|
Standard_EXPORT void KeepShapes(const TopTools_MapOfShape& theShapes);
|
|
|
|
//! Sets the flag defining the behavior of the algorithm regarding
|
|
//! modification of input shape.
|
|
//! If this flag is equal to True then the input (original) shape can't be
|
|
//! modified during modification process. Default value is true.
|
|
Standard_EXPORT void SetSafeInputMode(Standard_Boolean theValue);
|
|
|
|
//! Sets the linear tolerance. It plays the role of chord error when
|
|
//! taking decision about merging of shapes. Default value is Precision::Confusion().
|
|
void SetLinearTolerance(const Standard_Real theValue)
|
|
{
|
|
myLinTol = theValue;
|
|
}
|
|
|
|
//! Sets the angular tolerance. If two shapes form a connection angle greater than
|
|
//! this value they will not be merged. Default value is Precision::Angular().
|
|
void SetAngularTolerance(const Standard_Real theValue)
|
|
{
|
|
myAngTol = theValue;
|
|
}
|
|
|
|
//! Performs unification and builds the resulting shape.
|
|
Standard_EXPORT void Build();
|
|
|
|
//! Gives the resulting shape
|
|
const TopoDS_Shape& Shape() const
|
|
{
|
|
return myShape;
|
|
}
|
|
|
|
//! Returns the history of the processed shapes.
|
|
const Handle(BRepTools_History)& History() const
|
|
{
|
|
return myHistory;
|
|
}
|
|
|
|
//! Returns the history of the processed shapes.
|
|
Handle(BRepTools_History)& History()
|
|
{
|
|
return myHistory;
|
|
}
|
|
|
|
DEFINE_STANDARD_RTTIEXT(ShapeUpgrade_UnifySameDomain,Standard_Transient)
|
|
|
|
protected:
|
|
|
|
//! This method makes if possible a common face from each
|
|
//! group of faces lying on coincident surfaces
|
|
Standard_EXPORT void UnifyFaces();
|
|
|
|
//! This method makes if possible a common edge from each
|
|
//! group of smothly connected edges, which are common for the same couple of faces
|
|
Standard_EXPORT void UnifyEdges();
|
|
|
|
void IntUnifyFaces(const TopoDS_Shape& theInpShape,
|
|
TopTools_IndexedDataMapOfShapeListOfShape& theGMapEdgeFaces);
|
|
|
|
//! Fills the history of the modifications during the operation.
|
|
Standard_EXPORT void FillHistory();
|
|
|
|
private:
|
|
|
|
TopoDS_Shape myInitShape;
|
|
Standard_Real myLinTol;
|
|
Standard_Real myAngTol;
|
|
Standard_Boolean myUnifyFaces;
|
|
Standard_Boolean myUnifyEdges;
|
|
Standard_Boolean myConcatBSplines;
|
|
Standard_Boolean myAllowInternal;
|
|
Standard_Boolean mySafeInputMode;
|
|
TopoDS_Shape myShape;
|
|
Handle(ShapeBuild_ReShape) myContext;
|
|
TopTools_MapOfShape myKeepShapes;
|
|
|
|
Handle(BRepTools_History) myHistory; //!< The history.
|
|
};
|
|
|
|
#endif // _ShapeUpgrade_UnifySameDomain_HeaderFile
|