mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-04-04 18:06:22 +03:00
0c2517292f
1. Correct unification of circular edges: avoid trying to make an axis with null magnitude. 2. New method UnionPCurves: unify existing pcurves of chain instead of projecting the curve of unified edge onto surfaces
222 lines
8.9 KiB
C++
222 lines
8.9 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>
|
|
#include <TopTools_SequenceOfShape.hxx>
|
|
#include <Geom_Plane.hxx>
|
|
#include <Precision.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.
|
|
|
|
struct SubSequenceOfEdges
|
|
{
|
|
TopTools_SequenceOfShape SeqsEdges;
|
|
TopoDS_Edge UnionEdges;
|
|
};
|
|
|
|
class ShapeUpgrade_UnifySameDomain : public Standard_Transient
|
|
{
|
|
|
|
public:
|
|
|
|
typedef NCollection_DataMap<TopoDS_Shape, Handle(Geom_Plane), TopTools_ShapeMapHasher> DataMapOfFacePlane;
|
|
|
|
//! 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 < Precision::Angular() ? Precision::Angular() : 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);
|
|
|
|
//! Splits the sequence of edges into the sequence of chains
|
|
Standard_Boolean MergeEdges(TopTools_SequenceOfShape& SeqEdges,
|
|
const TopTools_IndexedDataMapOfShapeListOfShape& theVFmap,
|
|
NCollection_Sequence<SubSequenceOfEdges>& SeqOfSubSeqOfEdges,
|
|
const TopTools_MapOfShape& NonMergVrt);
|
|
|
|
//! Tries to unify the sequence of edges with the set of
|
|
//! another edges which lies on the same geometry
|
|
Standard_Boolean MergeSeq(TopTools_SequenceOfShape& SeqEdges,
|
|
const TopTools_IndexedDataMapOfShapeListOfShape& theVFmap,
|
|
const TopTools_MapOfShape& nonMergVert);
|
|
|
|
//! Merges a sequence of edges into one edge if possible
|
|
Standard_Boolean MergeSubSeq(const TopTools_SequenceOfShape& theChain,
|
|
const TopTools_IndexedDataMapOfShapeListOfShape& theVFmap,
|
|
TopoDS_Edge& OutEdge);
|
|
|
|
//! Unifies the pcurve of the chain into one pcurve of the edge
|
|
void UnionPCurves(const TopTools_SequenceOfShape& theChain,
|
|
TopoDS_Edge& theEdge);
|
|
|
|
//! 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;
|
|
DataMapOfFacePlane myFacePlaneMap;
|
|
TopTools_IndexedDataMapOfShapeListOfShape myEFmap;
|
|
TopTools_DataMapOfShapeShape myFaceNewFace;
|
|
|
|
Handle(BRepTools_History) myHistory; //!< The history.
|
|
};
|
|
|
|
#endif // _ShapeUpgrade_UnifySameDomain_HeaderFile
|