Documentation - Fix whitespaces and typos (#821)

- Removed excessive whitespace between words in comments
- Removed <br> syntax
- Fixed spelling errors ("hilight" → "highlights", "texte" → "text")
- Improved comment formatting and structure
This commit is contained in:
luzpaz
2025-11-13 04:30:53 -05:00
committed by GitHub
parent 396b677095
commit df59c53e79
159 changed files with 1017 additions and 1012 deletions
@@ -50,7 +50,7 @@ public:
TopoDS_Vertex& V1,
TopoDS_Vertex& V2);
//! <E> is a section between <F1> and <F2>. Computes
//! <E> is a section between <F1> and <F2>. Computes
//! <O1> the orientation of <E> in <F1> influenced by <F2>.
//! idem for <O2>.
Standard_EXPORT static void OrientSection(const TopoDS_Edge& E,
@@ -59,25 +59,25 @@ public:
TopAbs_Orientation& O1,
TopAbs_Orientation& O2);
//! Looks for the common Vertices and Edges between faces <theF1> and <theF2>.<br>
//! Returns TRUE if common shapes have been found.<br>
//! <theLE> will contain the found common edges;<br>
//! Looks for the common Vertices and Edges between faces <theF1> and <theF2>.
//! Returns TRUE if common shapes have been found.
//! <theLE> will contain the found common edges;
//! <theLV> will contain the found common vertices.
Standard_EXPORT static Standard_Boolean FindCommonShapes(const TopoDS_Face& theF1,
const TopoDS_Face& theF2,
TopTools_ListOfShape& theLE,
TopTools_ListOfShape& theLV);
//! Looks for the common shapes of type <theType> between shapes <theS1> and <theS2>.<br>
//! Returns TRUE if common shapes have been found.<br>
//! Looks for the common shapes of type <theType> between shapes <theS1> and <theS2>.
//! Returns TRUE if common shapes have been found.
//! <theLSC> will contain the found common shapes.
Standard_EXPORT static Standard_Boolean FindCommonShapes(const TopoDS_Shape& theS1,
const TopoDS_Shape& theS2,
const TopAbs_ShapeEnum theType,
TopTools_ListOfShape& theLSC);
//! Computes the Section between <F1> and <F2> the
//! edges solution are stored in <LInt1> with the
//! Computes the Section between <F1> and <F2> the
//! edges solution are stored in <LInt1> with the
//! orientation on <F1>, the sames edges are stored in
//! <Lint2> with the orientation on <F2>.
Standard_EXPORT static void Inter3D(const TopoDS_Face& F1,
@@ -125,11 +125,11 @@ public:
Standard_Boolean& enlargeVfirst,
Standard_Boolean& enlargeVlast);
//! Returns True if The Surface of <NF> has changed.
//! if <ChangeGeom> is TRUE , the surface can be
//! Returns True if The Surface of <NF> has changed.
//! if <ChangeGeom> is TRUE the surface can be
//! changed .
//! if <UpdatePCurve> is TRUE, update the pcurves of the
//! edges of <F> on the new surface if the surface has been changed.
//! if <UpdatePCurve> is TRUE, update the pcurves of the
//! edges of <F> on the new surface if the surface has been changed.
//! <enlargeU>, <enlargeVfirst>, <enlargeVlast> allow or forbid
//! enlargement in U and V directions correspondingly.
//! <theExtensionMode> is a mode of extension of the surface of the face:
@@ -172,16 +172,16 @@ public:
TopTools_DataMapOfShapeShape& NOnV1,
TopTools_DataMapOfShapeShape& NOnV2);
//! Store in MVE for a vertex <V> in <S> the incident
//! Store in MVE for a vertex <V> in <S> the incident
//! edges <E> in <S>.
//! An Edge is Store only one Time for a vertex.
Standard_EXPORT static void MapVertexEdges(const TopoDS_Shape& S,
TopTools_DataMapOfShapeListOfShape& MVE);
//! Remove the non valid part of an offsetshape
//! 1 - Remove all the free boundary and the faces
//! Remove the non valid part of an offsetshape
//! 1 - Remove all the free boundary and the faces
//! connex to such edges.
//! 2 - Remove all the shapes not valid in the result
//! 2 - Remove all the shapes not valid in the result
//! (according to the side of offsetting)
//! in this version only the first point is implemented.
Standard_EXPORT static TopoDS_Shape Deboucle3D(const TopoDS_Shape& S,
@@ -196,7 +196,7 @@ public:
Standard_EXPORT static Standard_Real Gabarit(const Handle(Geom_Curve)& aCurve);
//! Compares the normal directions of the planar faces and returns
//! TRUE if the directions are the same with the given precision.<br>
//! TRUE if the directions are the same with the given precision.
Standard_EXPORT static Standard_Boolean CheckPlanesNormals(const TopoDS_Face& theFace1,
const TopoDS_Face& theFace2,
const Standard_Real theTolAng = 1.e-8);
@@ -34,10 +34,10 @@ class TopoDS_Shape;
//! remaining faces of the solid become the walls of the
//! hollowed solid, their thickness defined at the time of construction.
//! the solid is built from an initial
//! solid <S> and a set of faces {Fi} from <S>,
//! builds a solid composed by two shells closed by
//! the {Fi}. First shell <SS> is composed by all
//! the faces of <S> expected {Fi}. Second shell is
//! solid <S> and a set of faces {Fi} from <S>,
//! builds a solid composed by two shells closed by
//! the {Fi}. First shell <SS> is composed by all
//! the faces of <S> expected {Fi}. Second shell is
//! the offset shell of <SS>.
//! A MakeThickSolid object provides a framework for:
//! - defining the cross-section of a hollowed solid,
@@ -115,7 +115,7 @@ public:
Standard_EXPORT virtual void Build(
const Message_ProgressRange& theRange = Message_ProgressRange()) Standard_OVERRIDE;
//! Returns the list of shapes modified from the shape
//! Returns the list of shapes modified from the shape
//! <S>.
Standard_EXPORT virtual const TopTools_ListOfShape& Modified(const TopoDS_Shape& S)
Standard_OVERRIDE;
@@ -58,11 +58,11 @@ public:
//! Standard_ConstructionError if ToProj is not added.
Standard_EXPORT void Add(const TopoDS_Shape& ToProj);
//! Sets the parameters used for computation
//! Tol3 is the required tolerance between the 3d projected
//! curve and its 2d representation
//! InternalContinuity is the order of constraints
//! used for approximation
//! Sets the parameters used for computation
//! Tol3 is the required tolerance between the 3d projected
//! curve and its 2d representation
//! InternalContinuity is the order of constraints
//! used for approximation
//! MaxDeg and MaxSeg are the maximum degree and the maximum
//! number of segment for BSpline resulting of an approximation.
Standard_EXPORT void SetParams(const Standard_Real Tol3D,
@@ -77,7 +77,7 @@ public:
//! if MaxDist < 0 then this method does not affect the algorithm
Standard_EXPORT void SetMaxDistance(const Standard_Real MaxDist);
//! Manage limitation of projected edges.
//! Manage limitation of projected edges.
Standard_EXPORT void SetLimit(const Standard_Boolean FaceBoundaries = Standard_True);
//! Returns true if a 3D curve is computed. If not, false is
@@ -111,7 +111,7 @@ public:
//! E has already been found.
Standard_EXPORT const TopoDS_Shape& Couple(const TopoDS_Edge& E) const;
//! Returns the list of shapes generated from the
//! Returns the list of shapes generated from the
//! shape <S>.
Standard_EXPORT virtual const TopTools_ListOfShape& Generated(const TopoDS_Shape& S)
Standard_OVERRIDE;
@@ -101,14 +101,14 @@ public:
//! Define the approximation algorithm
Standard_EXPORT void SetSmoothing(const Standard_Boolean UseSmoothing);
//! Define the type of parametrization used in the approximation
//! Define the type of parametrization used in the approximation
Standard_EXPORT void SetParType(const Approx_ParametrizationType ParType);
//! Define the Continuity used in the approximation
Standard_EXPORT void SetContinuity(const GeomAbs_Shape C);
//! define the Weights associed to the criterium used in
//! the optimization.
//! define the Weights associed to the criterium used in
//! the optimization.
//!
//! if Wi <= 0
Standard_EXPORT void SetCriteriumWeight(const Standard_Real W1,
@@ -130,8 +130,8 @@ public:
//! Define the approximation algorithm
Standard_EXPORT Standard_Boolean UseSmoothing() const;
//! returns the Weights associed to the criterium used in
//! the optimization.
//! returns the Weights associed to the criterium used in
//! the optimization.
Standard_EXPORT void CriteriumWeight(Standard_Real& W1,
Standard_Real& W2,
Standard_Real& W3) const;