1
0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-08-14 13:30:48 +03:00

0026595: Lost some comments in OCCT-code after cdl elimination

Recovered comments for instance classes from CDL generic classes.
This commit is contained in:
rkv
2015-10-14 17:48:41 +03:00
committed by bugmaster
parent 10dbdf3496
commit 36b9ff756a
251 changed files with 8209 additions and 0 deletions

View File

@@ -56,16 +56,33 @@ public:
DEFINE_STANDARD_ALLOC
//! Empty Constructor
Standard_EXPORT IntCurveSurface_HInter();
//! Compute the Intersection between the curve and the
//! surface
Standard_EXPORT void Perform (const Handle(Adaptor3d_HCurve)& Curve, const Handle(Adaptor3d_HSurface)& Surface);
//! Compute the Intersection between the curve and
//! the surface. The Curve is already sampled and
//! its polygon : <Polygon> is given.
Standard_EXPORT void Perform (const Handle(Adaptor3d_HCurve)& Curve, const IntCurveSurface_ThePolygonOfHInter& Polygon, const Handle(Adaptor3d_HSurface)& Surface);
//! Compute the Intersection between the curve and
//! the surface. The Curve is already sampled and
//! its polygon : <Polygon> is given. The Surface is
//! also sampled and <Polyhedron> is given.
Standard_EXPORT void Perform (const Handle(Adaptor3d_HCurve)& Curve, const IntCurveSurface_ThePolygonOfHInter& ThePolygon, const Handle(Adaptor3d_HSurface)& Surface, const IntCurveSurface_ThePolyhedronOfHInter& Polyhedron);
//! Compute the Intersection between the curve and
//! the surface. The Curve is already sampled and
//! its polygon : <Polygon> is given. The Surface is
//! also sampled and <Polyhedron> is given.
Standard_EXPORT void Perform (const Handle(Adaptor3d_HCurve)& Curve, const IntCurveSurface_ThePolygonOfHInter& ThePolygon, const Handle(Adaptor3d_HSurface)& Surface, const IntCurveSurface_ThePolyhedronOfHInter& Polyhedron, Bnd_BoundSortBox& BndBSB);
//! Compute the Intersection between the curve and
//! the surface. The Surface is already sampled and
//! its polyhedron : <Polyhedron> is given.
Standard_EXPORT void Perform (const Handle(Adaptor3d_HCurve)& Curve, const Handle(Adaptor3d_HSurface)& Surface, const IntCurveSurface_ThePolyhedronOfHInter& Polyhedron);
@@ -74,6 +91,8 @@ public:
protected:
//! Compute the Intersection between the curve and the
//! surface
Standard_EXPORT void Perform (const Handle(Adaptor3d_HCurve)& Curve, const Handle(Adaptor3d_HSurface)& Surface, const Standard_Real U0, const Standard_Real V0, const Standard_Real U1, const Standard_Real V1);
Standard_EXPORT void InternalPerformCurveQuadric (const Handle(Adaptor3d_HCurve)& Curve, const Handle(Adaptor3d_HSurface)& Surface);

View File

@@ -43,22 +43,54 @@ public:
DEFINE_STANDARD_ALLOC
//! compute the solution point with the close point
//! MarginCoef is the coefficient for extension of UV bounds.
//! Ex., UFirst -= MarginCoef*(ULast-UFirst)
Standard_EXPORT IntCurveSurface_TheExactHInter(const Standard_Real U, const Standard_Real V, const Standard_Real W, const IntCurveSurface_TheCSFunctionOfHInter& F, const Standard_Real TolTangency, const Standard_Real MarginCoef = 0.0);
//! initialize the parameters to compute the solution
Standard_EXPORT IntCurveSurface_TheExactHInter(const IntCurveSurface_TheCSFunctionOfHInter& F, const Standard_Real TolTangency);
//! compute the solution
//! it's possible to write to optimize:
//! IntImp_IntCS inter(S1,C1,Toltangency)
//! math_FunctionSetRoot rsnld(Inter.function())
//! while ...{
//! u=...
//! v=...
//! w=...
//! inter.Perform(u,v,w,rsnld)
//! }
//! or
//! IntImp_IntCS inter(Toltangency)
//! inter.SetSurface(S);
//! math_FunctionSetRoot rsnld(Inter.function())
//! while ...{
//! C=...
//! inter.SetCurve(C);
//! u=...
//! v=...
//! w=...
//! inter.Perform(u,v,w,rsnld)
//! }
Standard_EXPORT void Perform (const Standard_Real U, const Standard_Real V, const Standard_Real W, math_FunctionSetRoot& Rsnld, const Standard_Real u0, const Standard_Real v0, const Standard_Real u1, const Standard_Real v1, const Standard_Real w0, const Standard_Real w1);
//! Returns TRUE if the creation completed without failure.
Standard_EXPORT Standard_Boolean IsDone() const;
Standard_EXPORT Standard_Boolean IsEmpty() const;
//! returns the intersection point
//! The exception NotDone is raised if IsDone is false.
//! The exception DomainError is raised if IsEmpty is true.
Standard_EXPORT const gp_Pnt& Point() const;
Standard_EXPORT Standard_Real ParameterOnCurve() const;
Standard_EXPORT void ParameterOnSurface (Standard_Real& U, Standard_Real& V) const;
//! return the math function which
//! is used to compute the intersection
Standard_EXPORT IntCurveSurface_TheCSFunctionOfHInter& Function();

View File

@@ -59,8 +59,15 @@ public:
static GeomAbs_Shape Continuity (const Handle(Adaptor3d_HCurve)& C);
//! Returns the number of intervals for continuity
//! <S>. May be one if Continuity(myclass) >= <S>
static Standard_Integer NbIntervals (const Handle(Adaptor3d_HCurve)& C, const GeomAbs_Shape S);
//! Stores in <T> the parameters bounding the intervals
//! of continuity <S>.
//!
//! The array must provide enough room to accomodate
//! for the parameters. i.e. T.Length() > NbIntervals()
static void Intervals (const Handle(Adaptor3d_HCurve)& C, TColStd_Array1OfReal& T, const GeomAbs_Shape S);
static Standard_Boolean IsClosed (const Handle(Adaptor3d_HCurve)& C);
@@ -69,20 +76,47 @@ public:
static Standard_Real Period (const Handle(Adaptor3d_HCurve)& C);
//! Computes the point of parameter U on the curve.
static gp_Pnt Value (const Handle(Adaptor3d_HCurve)& C, const Standard_Real U);
//! Computes the point of parameter U on the curve.
static void D0 (const Handle(Adaptor3d_HCurve)& C, const Standard_Real U, gp_Pnt& P);
//! Computes the point of parameter U on the curve with its
//! first derivative.
//! Raised if the continuity of the current interval
//! is not C1.
static void D1 (const Handle(Adaptor3d_HCurve)& C, const Standard_Real U, gp_Pnt& P, gp_Vec& V);
//! Returns the point P of parameter U, the first and second
//! derivatives V1 and V2.
//! Raised if the continuity of the current interval
//! is not C2.
static void D2 (const Handle(Adaptor3d_HCurve)& C, const Standard_Real U, gp_Pnt& P, gp_Vec& V1, gp_Vec& V2);
//! Returns the point P of parameter U, the first, the second
//! and the third derivative.
//! Raised if the continuity of the current interval
//! is not C3.
static void D3 (const Handle(Adaptor3d_HCurve)& C, const Standard_Real U, gp_Pnt& P, gp_Vec& V1, gp_Vec& V2, gp_Vec& V3);
//! The returned vector gives the value of the derivative for the
//! order of derivation N.
//! Raised if the continuity of the current interval
//! is not CN.
//! Raised if N < 1.
static gp_Vec DN (const Handle(Adaptor3d_HCurve)& C, const Standard_Real U, const Standard_Integer N);
//! Returns the parametric resolution corresponding
//! to the real space resolution <R3d>.
static Standard_Real Resolution (const Handle(Adaptor3d_HCurve)& C, const Standard_Real R3d);
//! Returns the type of the curve in the current
//! interval : Line, Circle, Ellipse, Hyperbola,
//! Parabola, BezierCurve, BSplineCurve, OtherCurve.
static GeomAbs_CurveType GetType (const Handle(Adaptor3d_HCurve)& C);
static gp_Lin Line (const Handle(Adaptor3d_HCurve)& C);

View File

@@ -44,34 +44,64 @@ public:
DEFINE_STANDARD_ALLOC
//! Constructs an empty interference between Polygon and
//! Polyhedron.
Standard_EXPORT IntCurveSurface_TheInterferenceOfHInter();
//! Constructs and computes an interference between the Polygon
//! and the Polyhedron.
Standard_EXPORT IntCurveSurface_TheInterferenceOfHInter(const IntCurveSurface_ThePolygonOfHInter& thePolyg, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Constructs and computes an interference between the
//! Straight Line and the Polyhedron.
Standard_EXPORT IntCurveSurface_TheInterferenceOfHInter(const gp_Lin& theLin, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Constructs and computes an interference between the
//! Straight Lines and the Polyhedron.
Standard_EXPORT IntCurveSurface_TheInterferenceOfHInter(const Intf_Array1OfLin& theLins, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Computes an interference between the Polygon and the
//! Polyhedron.
Standard_EXPORT void Perform (const IntCurveSurface_ThePolygonOfHInter& thePolyg, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Computes an interference between the Straight Line and the
//! Polyhedron.
Standard_EXPORT void Perform (const gp_Lin& theLin, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Computes an interference between the Straight Lines and
//! the Polyhedron.
Standard_EXPORT void Perform (const Intf_Array1OfLin& theLins, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Constructs and computes an interference between the Polygon
//! and the Polyhedron.
Standard_EXPORT IntCurveSurface_TheInterferenceOfHInter(const IntCurveSurface_ThePolygonOfHInter& thePolyg, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, Bnd_BoundSortBox& theBoundSB);
//! Constructs and computes an interference between the
//! Straight Line and the Polyhedron.
Standard_EXPORT IntCurveSurface_TheInterferenceOfHInter(const gp_Lin& theLin, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, Bnd_BoundSortBox& theBoundSB);
//! Constructs and computes an interference between the
//! Straight Lines and the Polyhedron.
Standard_EXPORT IntCurveSurface_TheInterferenceOfHInter(const Intf_Array1OfLin& theLins, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, Bnd_BoundSortBox& theBoundSB);
//! Computes an interference between the Polygon and the
//! Polyhedron.
Standard_EXPORT void Perform (const IntCurveSurface_ThePolygonOfHInter& thePolyg, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, Bnd_BoundSortBox& theBoundSB);
//! Computes an interference between the Straight Line and the
//! Polyhedron.
Standard_EXPORT void Perform (const gp_Lin& theLin, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, Bnd_BoundSortBox& theBoundSB);
//! Computes an interference between the Straight Lines and
//! the Polyhedron.
Standard_EXPORT void Perform (const Intf_Array1OfLin& theLins, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, Bnd_BoundSortBox& theBoundSB);
//! Compares the boundings between the segment of <thePolyg> and
//! the facets of <thePolyh>.
Standard_EXPORT void Interference (const IntCurveSurface_ThePolygonOfHInter& thePolyg, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, Bnd_BoundSortBox& theBoundSB);
//! Compares the boundings between the segment of <thePolyg> and
//! the facets of <thePolyh>.
Standard_EXPORT void Interference (const IntCurveSurface_ThePolygonOfHInter& thePolyg, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
@@ -86,8 +116,12 @@ protected:
private:
//! Computes the intersection between the segment <BegO><EndO>
//! and the triangle <TTri> of <thePolyh>.
Standard_EXPORT void Intersect (const gp_Pnt& BegO, const gp_Pnt& EndO, const Standard_Boolean Infinite, const Standard_Integer TTri, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Computes the intersection between the segment <BegO><EndO>
//! and the triangle <TTri> of <thePolyh>.
Standard_EXPORT void Intersect (const gp_Pnt& BegO, const gp_Pnt& EndO, const Standard_Boolean Infinite, const Standard_Integer TTri, const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, const gp_XYZ& TriNormal, const Standard_Real TriDp, const Standard_Real dBegTri, const Standard_Real dEndTri);

View File

@@ -49,6 +49,7 @@ public:
Standard_EXPORT IntCurveSurface_ThePolygonOfHInter(const Handle(Adaptor3d_HCurve)& Curve, const TColStd_Array1OfReal& Upars);
//! Give the bounding box of the polygon.
const Bnd_Box& Bounding() const;
Standard_Real DeflectionOverEstimation() const;
@@ -59,16 +60,25 @@ public:
Standard_Boolean Closed() const;
//! Give the number of Segments in the polyline.
Standard_Integer NbSegments() const;
//! Give the point of range Index in the Polygon.
const gp_Pnt& BeginOfSeg (const Standard_Integer Index) const;
//! Give the point of range Index in the Polygon.
const gp_Pnt& EndOfSeg (const Standard_Integer Index) const;
//! Returns the parameter (On the curve)
//! of the first point of the Polygon
Standard_Real InfParameter() const;
//! Returns the parameter (On the curve)
//! of the last point of the Polygon
Standard_Real SupParameter() const;
//! Give an approximation of the parameter on the curve
//! according to the discretization of the Curve.
Standard_EXPORT Standard_Real ApproxParamOnCurve (const Standard_Integer Index, const Standard_Real ParamOnLine) const;
Standard_EXPORT void Dump() const;

View File

@@ -38,6 +38,7 @@ public:
DEFINE_STANDARD_ALLOC
//! Give the bounding box of the polygon.
static const Bnd_Box& Bounding (const IntCurveSurface_ThePolygonOfHInter& thePolygon);
static Standard_Real DeflectionOverEstimation (const IntCurveSurface_ThePolygonOfHInter& thePolygon);
@@ -46,8 +47,10 @@ public:
static Standard_Integer NbSegments (const IntCurveSurface_ThePolygonOfHInter& thePolygon);
//! Give the point of range Index in the Polygon.
static const gp_Pnt& BeginOfSeg (const IntCurveSurface_ThePolygonOfHInter& thePolygon, const Standard_Integer Index);
//! Give the point of range Index in the Polygon.
static const gp_Pnt& EndOfSeg (const IntCurveSurface_ThePolygonOfHInter& thePolygon, const Standard_Integer Index);
Standard_EXPORT static void Dump (const IntCurveSurface_ThePolygonOfHInter& thePolygon);

View File

@@ -66,28 +66,50 @@ public:
Standard_EXPORT void VMaxSingularity (const Standard_Boolean Sing);
//! get the size of the discretization.
Standard_EXPORT void Size (Standard_Integer& nbdu, Standard_Integer& nbdv) const;
//! Give the number of triangles in this double array of
Standard_EXPORT Standard_Integer NbTriangles() const;
//! Give the 3 points of the triangle of addresse Index in
//! the double array of triangles.
Standard_EXPORT void Triangle (const Standard_Integer Index, Standard_Integer& P1, Standard_Integer& P2, Standard_Integer& P3) const;
//! Give the addresse Tricon of the triangle connexe to the
//! triangle of address Triang by the edge Pivot Pedge and
//! the third point of this connexe triangle. When we are
//! on a free edge TriCon==0 but the function return the
//! value of the triangle in the other side of Pivot on
//! the free edge. Used to turn around a vertex.
Standard_EXPORT Standard_Integer TriConnex (const Standard_Integer Triang, const Standard_Integer Pivot, const Standard_Integer Pedge, Standard_Integer& TriCon, Standard_Integer& OtherP) const;
//! Give the number of point in the double array of
//! triangles ((nbdu+1)*(nbdv+1)).
Standard_EXPORT Standard_Integer NbPoints() const;
//! Set the value of a field of the double array of
//! points.
Standard_EXPORT void Point (const gp_Pnt& thePnt, const Standard_Integer lig, const Standard_Integer col, const Standard_Real U, const Standard_Real V);
//! Give the point of index i in the MaTriangle.
Standard_EXPORT const gp_Pnt& Point (const Standard_Integer Index, Standard_Real& U, Standard_Real& V) const;
//! Give the point of index i in the MaTriangle.
Standard_EXPORT const gp_Pnt& Point (const Standard_Integer Index) const;
//! Give the point of index i in the MaTriangle.
Standard_EXPORT void Point (const Standard_Integer Index, gp_Pnt& P) const;
//! Give the bounding box of the MaTriangle.
Standard_EXPORT const Bnd_Box& Bounding() const;
//! Compute the array of boxes. The box <n> corresponding
//! to the triangle <n>.
Standard_EXPORT void FillBounding();
//! Give the array of boxes. The box <n> corresponding
//! to the triangle <n>.
Standard_EXPORT const Handle(Bnd_HArray1OfBox)& ComponentsBounding() const;
Standard_EXPORT Standard_Real DeflectionOverEstimation() const;
@@ -100,14 +122,21 @@ public:
Standard_EXPORT Standard_Boolean HasVMaxSingularity() const;
//! Give the plane equation of the triangle of addresse Triang.
Standard_EXPORT void PlaneEquation (const Standard_Integer Triang, gp_XYZ& NormalVector, Standard_Real& PolarDistance) const;
//! Give the plane equation of the triangle of addresse Triang.
Standard_EXPORT Standard_Boolean Contain (const Standard_Integer Triang, const gp_Pnt& ThePnt) const;
Standard_EXPORT void Parameters (const Standard_Integer Index, Standard_Real& U, Standard_Real& V) const;
//! This method returns true if the edge based on points with
//! indices Index1 and Index2 represents a boundary edge. It is
//! necessary to take into account the boundary deflection for
//! this edge.
Standard_EXPORT Standard_Boolean IsOnBound (const Standard_Integer Index1, const Standard_Integer Index2) const;
//! This method returns a border deflection.
Standard_Real GetBorderDeflection() const;
Standard_EXPORT void Dump() const;
@@ -128,6 +157,8 @@ protected:
private:
//! This method computes and returns a deflection of isoline
//! of given parameter on Surface.
Standard_EXPORT Standard_Real ComputeBorderDeflection (const Handle(Adaptor3d_HSurface)& Surface, const Standard_Real Parameter, const Standard_Real PMin, const Standard_Real PMax, const Standard_Boolean isUIso) const;

View File

@@ -39,22 +39,41 @@ public:
DEFINE_STANDARD_ALLOC
//! Give the bounding box of the PolyhedronTool.
static const Bnd_Box& Bounding (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Give the array of boxes. The box <n> corresponding
//! to the triangle <n>.
static const Handle(Bnd_HArray1OfBox)& ComponentsBounding (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Give the tolerance of the polygon.
static Standard_Real DeflectionOverEstimation (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Give the number of triangles in this polyedral surface.
static Standard_Integer NbTriangles (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
//! Give the indices of the 3 points of the triangle of
//! address Index in the PolyhedronTool.
static void Triangle (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, const Standard_Integer Index, Standard_Integer& P1, Standard_Integer& P2, Standard_Integer& P3);
//! Give the point of index i in the polyedral surface.
static const gp_Pnt& Point (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, const Standard_Integer Index);
//! Give the addresse Tricon of the triangle connexe to
//! the triangle of address Triang by the edge Pivot Pedge
//! and the third point of this connexe triangle. When we
//! are on a free edge TriCon==0 but the function return
//! the value of the triangle in the other side of Pivot
//! on the free edge. Used to turn around a vertex.
static Standard_Integer TriConnex (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, const Standard_Integer Triang, const Standard_Integer Pivot, const Standard_Integer Pedge, Standard_Integer& TriCon, Standard_Integer& OtherP);
//! This method returns true if the edge based on points with
//! indices Index1 and Index2 represents a boundary edge. It is
//! necessary to take into account the boundary deflection for
//! this edge.
static Standard_Boolean IsOnBound (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh, const Standard_Integer Index1, const Standard_Integer Index2);
//! This method returns a border deflection of the polyhedron.
static Standard_Real GetBorderDeflection (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);
Standard_EXPORT static void Dump (const IntCurveSurface_ThePolyhedronOfHInter& thePolyh);

View File

@@ -40,6 +40,8 @@ public:
DEFINE_STANDARD_ALLOC
//! Provides the signed distance function : Q(w)
//! and its first derivative dQ(w)/dw
Standard_EXPORT IntCurveSurface_TheQuadCurvExactHInter(const Handle(Adaptor3d_HSurface)& S, const Handle(Adaptor3d_HCurve)& C);
Standard_EXPORT Standard_Boolean IsDone() const;
@@ -50,6 +52,8 @@ public:
Standard_EXPORT Standard_Integer NbIntervals() const;
//! U1 and U2 are the parameters of
//! a segment on the curve.
Standard_EXPORT void Intervals (const Standard_Integer Index, Standard_Real& U1, Standard_Real& U2) const;

View File

@@ -38,12 +38,22 @@ public:
DEFINE_STANDARD_ALLOC
//! Create the function.
Standard_EXPORT IntCurveSurface_TheQuadCurvFuncOfTheQuadCurvExactHInter(const IntSurf_Quadric& Q, const Handle(Adaptor3d_HCurve)& C);
//! Computes the value of the signed distance between
//! the implicit surface and the point at parameter
//! Param on the parametrised curve.
//! Value always returns True.
Standard_EXPORT Standard_Boolean Value (const Standard_Real Param, Standard_Real& F) Standard_OVERRIDE;
//! Computes the derivative of the previous function at
//! parameter Param.
//! Derivative always returns True.
Standard_EXPORT Standard_Boolean Derivative (const Standard_Real Param, Standard_Real& D) Standard_OVERRIDE;
//! Computes the value and the derivative of the function.
//! returns True.
Standard_EXPORT Standard_Boolean Values (const Standard_Real Param, Standard_Real& F, Standard_Real& D) Standard_OVERRIDE;