mirror of
https://github.com/Open-Cascade-SAS/OCCT.git
synced 2026-08-29 14:28:23 +08:00
luzpaz
79289339d8
- Fixed excessive whitespace in multi-line comments - Corrected spelling errors (e.g., "selectionnable" → "selectable", "begenning" → "beginning") - Improved comment formatting and readability
377 lines
17 KiB
C++
377 lines
17 KiB
C++
// Created on: 1991-07-01
|
|
// Created by: Remi LEQUETTE
|
|
// Copyright (c) 1991-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 _BRep_Builder_HeaderFile
|
|
#define _BRep_Builder_HeaderFile
|
|
|
|
#include <GeomAbs_Shape.hxx>
|
|
#include <Poly_ListOfTriangulation.hxx>
|
|
#include <Standard.hxx>
|
|
#include <Standard_DefineAlloc.hxx>
|
|
#include <Standard_Handle.hxx>
|
|
#include <TopoDS_Builder.hxx>
|
|
|
|
class TopoDS_Face;
|
|
class Geom_Surface;
|
|
class TopLoc_Location;
|
|
class Poly_Triangulation;
|
|
class TopoDS_Edge;
|
|
class Geom_Curve;
|
|
class Poly_Polygon3D;
|
|
class Poly_PolygonOnTriangulation;
|
|
class Geom2d_Curve;
|
|
class gp_Pnt2d;
|
|
class Poly_Polygon2D;
|
|
class TopoDS_Vertex;
|
|
class gp_Pnt;
|
|
|
|
//! A framework providing advanced tolerance control.
|
|
//! It is used to build Shapes.
|
|
//! If tolerance control is required, you are advised to:
|
|
//! 1. build a default precision for topology, using the
|
|
//! classes provided in the BRepAPI package
|
|
//! 2. update the tolerance of the resulting shape.
|
|
//! Note that only vertices, edges and faces have
|
|
//! meaningful tolerance control. The tolerance value
|
|
//! must always comply with the condition that face
|
|
//! tolerances are more restrictive than edge tolerances
|
|
//! which are more restrictive than vertex tolerances. In
|
|
//! other words: Tol(Vertex) >= Tol(Edge) >= Tol(Face).
|
|
//! Other rules in setting tolerance include:
|
|
//! - you can open up tolerance but should never restrict it
|
|
//! - an edge cannot be included within the fusion of the
|
|
//! tolerance spheres of two vertices
|
|
class BRep_Builder : public TopoDS_Builder
|
|
{
|
|
public:
|
|
DEFINE_STANDARD_ALLOC
|
|
|
|
//! Makes an undefined Face.
|
|
void MakeFace(TopoDS_Face& F) const;
|
|
|
|
//! Makes a Face with a surface.
|
|
Standard_EXPORT void MakeFace(TopoDS_Face& F,
|
|
const Handle(Geom_Surface)& S,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Makes a Face with a surface and a location.
|
|
Standard_EXPORT void MakeFace(TopoDS_Face& F,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Makes a theFace with a single triangulation. The triangulation
|
|
//! is in the same reference system than the TFace.
|
|
Standard_EXPORT void MakeFace(TopoDS_Face& theFace,
|
|
const Handle(Poly_Triangulation)& theTriangulation) const;
|
|
|
|
//! Makes a Face with a list of triangulations and active one.
|
|
//! Use NULL active triangulation to set the first triangulation in list as active.
|
|
//! The triangulations is in the same reference system than the TFace.
|
|
Standard_EXPORT void MakeFace(
|
|
TopoDS_Face& theFace,
|
|
const Poly_ListOfTriangulation& theTriangulations,
|
|
const Handle(Poly_Triangulation)& theActiveTriangulation = Handle(Poly_Triangulation)()) const;
|
|
|
|
//! Updates the face F using the tolerance value Tol,
|
|
//! surface S and location Location.
|
|
Standard_EXPORT void UpdateFace(const TopoDS_Face& F,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Changes a face triangulation.
|
|
//! A NULL theTriangulation removes face triangulations.
|
|
//! If theToReset is TRUE face triangulations will be reset to new list with only one input
|
|
//! triangulation that will be active. Else if theTriangulation is contained in internal
|
|
//! triangulations list it will be made active,
|
|
//! else the active triangulation will be replaced to theTriangulation one.
|
|
Standard_EXPORT void UpdateFace(const TopoDS_Face& theFace,
|
|
const Handle(Poly_Triangulation)& theTriangulation,
|
|
const Standard_Boolean theToReset = true) const;
|
|
|
|
//! Updates the face Tolerance.
|
|
Standard_EXPORT void UpdateFace(const TopoDS_Face& F, const Standard_Real Tol) const;
|
|
|
|
//! Sets the NaturalRestriction flag of the face.
|
|
Standard_EXPORT void NaturalRestriction(const TopoDS_Face& F, const Standard_Boolean N) const;
|
|
|
|
//! Makes an undefined Edge (no geometry).
|
|
Standard_EXPORT void MakeEdge(TopoDS_Edge& E) const;
|
|
|
|
//! Makes an Edge with a curve.
|
|
void MakeEdge(TopoDS_Edge& E, const Handle(Geom_Curve)& C, const Standard_Real Tol) const;
|
|
|
|
//! Makes an Edge with a curve and a location.
|
|
void MakeEdge(TopoDS_Edge& E,
|
|
const Handle(Geom_Curve)& C,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Makes an Edge with a polygon 3d.
|
|
void MakeEdge(TopoDS_Edge& E, const Handle(Poly_Polygon3D)& P) const;
|
|
|
|
//! makes an Edge polygon on Triangulation.
|
|
void MakeEdge(TopoDS_Edge& E,
|
|
const Handle(Poly_PolygonOnTriangulation)& N,
|
|
const Handle(Poly_Triangulation)& T) const;
|
|
|
|
//! makes an Edge polygon on Triangulation.
|
|
void MakeEdge(TopoDS_Edge& E,
|
|
const Handle(Poly_PolygonOnTriangulation)& N,
|
|
const Handle(Poly_Triangulation)& T,
|
|
const TopLoc_Location& L) const;
|
|
|
|
//! Sets a 3D curve for the edge.
|
|
//! If <C> is a null handle, remove any existing 3d curve.
|
|
void UpdateEdge(const TopoDS_Edge& E, const Handle(Geom_Curve)& C, const Standard_Real Tol) const;
|
|
|
|
//! Sets a 3D curve for the edge.
|
|
//! If <C> is a null handle, remove any existing 3d curve.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Geom_Curve)& C,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets a pcurve for the edge on the face.
|
|
//! If <C> is a null handle, remove any existing pcurve.
|
|
void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Geom2d_Curve)& C,
|
|
const TopoDS_Face& F,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets pcurves for the edge on the closed face. If
|
|
//! <C1> or <C2> is a null handle, remove any existing
|
|
//! pcurve.
|
|
void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Geom2d_Curve)& C1,
|
|
const Handle(Geom2d_Curve)& C2,
|
|
const TopoDS_Face& F,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets a pcurve for the edge on the face.
|
|
//! If <C> is a null handle, remove any existing pcurve.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Geom2d_Curve)& C,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets a pcurve for the edge on the face.
|
|
//! If <C> is a null handle, remove any existing pcurve.
|
|
//! Sets UV bounds for curve repsentation
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Geom2d_Curve)& C,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol,
|
|
const gp_Pnt2d& Pf,
|
|
const gp_Pnt2d& Pl) const;
|
|
|
|
//! Sets pcurves for the edge on the closed surface.
|
|
//! <C1> or <C2> is a null handle, remove any existing
|
|
//! pcurve.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Geom2d_Curve)& C1,
|
|
const Handle(Geom2d_Curve)& C2,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets pcurves for the edge on the closed surface.
|
|
//! <C1> or <C2> is a null handle, remove any existing
|
|
//! pcurve.
|
|
//! Sets UV bounds for curve repsentation
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Geom2d_Curve)& C1,
|
|
const Handle(Geom2d_Curve)& C2,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol,
|
|
const gp_Pnt2d& Pf,
|
|
const gp_Pnt2d& Pl) const;
|
|
|
|
//! Changes an Edge 3D polygon.
|
|
//! A null Polygon removes the 3d Polygon.
|
|
void UpdateEdge(const TopoDS_Edge& E, const Handle(Poly_Polygon3D)& P) const;
|
|
|
|
//! Changes an Edge 3D polygon.
|
|
//! A null Polygon removes the 3d Polygon.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_Polygon3D)& P,
|
|
const TopLoc_Location& L) const;
|
|
|
|
//! Changes an Edge polygon on Triangulation.
|
|
void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_PolygonOnTriangulation)& N,
|
|
const Handle(Poly_Triangulation)& T) const;
|
|
|
|
//! Changes an Edge polygon on Triangulation.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_PolygonOnTriangulation)& N,
|
|
const Handle(Poly_Triangulation)& T,
|
|
const TopLoc_Location& L) const;
|
|
|
|
//! Changes an Edge polygon on Triangulation.
|
|
void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_PolygonOnTriangulation)& N1,
|
|
const Handle(Poly_PolygonOnTriangulation)& N2,
|
|
const Handle(Poly_Triangulation)& T) const;
|
|
|
|
//! Changes an Edge polygon on Triangulation.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_PolygonOnTriangulation)& N1,
|
|
const Handle(Poly_PolygonOnTriangulation)& N2,
|
|
const Handle(Poly_Triangulation)& T,
|
|
const TopLoc_Location& L) const;
|
|
|
|
//! Changes Edge polygon on a face.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_Polygon2D)& P,
|
|
const TopoDS_Face& S) const;
|
|
|
|
//! Changes Edge polygon on a face.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_Polygon2D)& P,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& T) const;
|
|
|
|
//! Changes Edge polygons on a face.
|
|
//!
|
|
//! A null Polygon removes the 2d Polygon.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_Polygon2D)& P1,
|
|
const Handle(Poly_Polygon2D)& P2,
|
|
const TopoDS_Face& S) const;
|
|
|
|
//! Changes Edge polygons on a face.
|
|
//!
|
|
//! A null Polygon removes the 2d Polygon.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E,
|
|
const Handle(Poly_Polygon2D)& P1,
|
|
const Handle(Poly_Polygon2D)& P2,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L) const;
|
|
|
|
//! Updates the edge tolerance.
|
|
Standard_EXPORT void UpdateEdge(const TopoDS_Edge& E, const Standard_Real Tol) const;
|
|
|
|
//! Sets the geometric continuity on the edge.
|
|
Standard_EXPORT void Continuity(const TopoDS_Edge& E,
|
|
const TopoDS_Face& F1,
|
|
const TopoDS_Face& F2,
|
|
const GeomAbs_Shape C) const;
|
|
|
|
//! Sets the geometric continuity on the edge.
|
|
Standard_EXPORT void Continuity(const TopoDS_Edge& E,
|
|
const Handle(Geom_Surface)& S1,
|
|
const Handle(Geom_Surface)& S2,
|
|
const TopLoc_Location& L1,
|
|
const TopLoc_Location& L2,
|
|
const GeomAbs_Shape C) const;
|
|
|
|
//! Sets the same parameter flag for the edge <E>.
|
|
Standard_EXPORT void SameParameter(const TopoDS_Edge& E, const Standard_Boolean S) const;
|
|
|
|
//! Sets the same range flag for the edge <E>.
|
|
Standard_EXPORT void SameRange(const TopoDS_Edge& E, const Standard_Boolean S) const;
|
|
|
|
//! Sets the degenerated flag for the edge <E>.
|
|
Standard_EXPORT void Degenerated(const TopoDS_Edge& E, const Standard_Boolean D) const;
|
|
|
|
//! Sets the range of the 3d curve if Only3d=TRUE,
|
|
//! otherwise sets the range to all the representations
|
|
Standard_EXPORT void Range(const TopoDS_Edge& E,
|
|
const Standard_Real First,
|
|
const Standard_Real Last,
|
|
const Standard_Boolean Only3d = Standard_False) const;
|
|
|
|
//! Sets the range of the edge on the pcurve on the
|
|
//! surface.
|
|
Standard_EXPORT void Range(const TopoDS_Edge& E,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real First,
|
|
const Standard_Real Last) const;
|
|
|
|
//! Sets the range of the edge on the pcurve on the face.
|
|
void Range(const TopoDS_Edge& E,
|
|
const TopoDS_Face& F,
|
|
const Standard_Real First,
|
|
const Standard_Real Last) const;
|
|
|
|
//! Add to <Eout> the geometric representations of <Ein>.
|
|
Standard_EXPORT void Transfert(const TopoDS_Edge& Ein, const TopoDS_Edge& Eout) const;
|
|
|
|
//! Makes an udefined vertex without geometry.
|
|
void MakeVertex(TopoDS_Vertex& V) const;
|
|
|
|
//! Makes a vertex from a 3D point.
|
|
void MakeVertex(TopoDS_Vertex& V, const gp_Pnt& P, const Standard_Real Tol) const;
|
|
|
|
//! Sets a 3D point on the vertex.
|
|
Standard_EXPORT void UpdateVertex(const TopoDS_Vertex& V,
|
|
const gp_Pnt& P,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets the parameter for the vertex on the edge curves.
|
|
Standard_EXPORT void UpdateVertex(const TopoDS_Vertex& V,
|
|
const Standard_Real P,
|
|
const TopoDS_Edge& E,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets the parameter for the vertex on the edge
|
|
//! pcurve on the face.
|
|
void UpdateVertex(const TopoDS_Vertex& V,
|
|
const Standard_Real P,
|
|
const TopoDS_Edge& E,
|
|
const TopoDS_Face& F,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets the parameter for the vertex on the edge
|
|
//! pcurve on the surface.
|
|
Standard_EXPORT void UpdateVertex(const TopoDS_Vertex& V,
|
|
const Standard_Real P,
|
|
const TopoDS_Edge& E,
|
|
const Handle(Geom_Surface)& S,
|
|
const TopLoc_Location& L,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Sets the parameters for the vertex on the face.
|
|
Standard_EXPORT void UpdateVertex(const TopoDS_Vertex& Ve,
|
|
const Standard_Real U,
|
|
const Standard_Real V,
|
|
const TopoDS_Face& F,
|
|
const Standard_Real Tol) const;
|
|
|
|
//! Updates the vertex tolerance.
|
|
Standard_EXPORT void UpdateVertex(const TopoDS_Vertex& V, const Standard_Real Tol) const;
|
|
|
|
//! Transfert the parameters of Vin on Ein as the
|
|
//! parameter of Vout on Eout.
|
|
Standard_EXPORT void Transfert(const TopoDS_Edge& Ein,
|
|
const TopoDS_Edge& Eout,
|
|
const TopoDS_Vertex& Vin,
|
|
const TopoDS_Vertex& Vout) const;
|
|
|
|
protected:
|
|
private:
|
|
};
|
|
|
|
#include <BRep_Builder.lxx>
|
|
|
|
#endif // _BRep_Builder_HeaderFile
|