OpenCascade/occt
1
0
Fork 0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-04-03 17:56:21 +03:00
Code Packages Releases Activity

0030448: Coding - add typo detection to derivation creation methods using Standard_NODISCARD attribute

Browse Source 
Added macro Standard_NODISCARD equivalent to C++17 attribute [[nodiscard]] for compilers that support this.
Using Standard_NODISCARD macro for methods that create new object in gp, math, Geom, Bnd packages.
Marked equivalent operators with Standard_NODISCARD, if they are defined close to relevant methods.

Corrected code where warnings on unused result of calls to methods creating new objects are generated.
In most cases it looks like spelling errors (e.g. Normalised() instead of Normalise())
This commit is contained in:
Benjamin Bihler 2019-02-25 12:52:01 +03:00 committed by apn
parent 1c8fc6bee2
commit 0be7dbe183
70 changed files with 454 additions and 431 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
dox/resources/occt_rm.doxyfile
View File

@ -23,7 +23,7 @@ WARNINGS = NO
ENABLE_PREPROCESSING = YES ENABLE_PREPROCESSING = YES
MACRO_EXPANSION = YES MACRO_EXPANSION = YES
EXPAND_ONLY_PREDEF = YES EXPAND_ONLY_PREDEF = YES
PREDEFINED = Standard_EXPORT Standard_OVERRIDE:=override __Standard_API __Draw_API Handle(a):=Handle<a> DEFINE_STANDARD_ALLOC DEFINE_NCOLLECTION_ALLOC PREDEFINED = Standard_EXPORT Standard_NODISCARD Standard_OVERRIDE:=override __Standard_API __Draw_API Handle(a):=Handle<a> DEFINE_STANDARD_ALLOC DEFINE_NCOLLECTION_ALLOC
GENERATE_HTML = YES GENERATE_HTML = YES
GENERATE_LATEX = NO GENERATE_LATEX = NO
SEARCH_INCLUDES = YES SEARCH_INCLUDES = YES

2
src/Bnd/Bnd_B2d.hxx
View File

@ -83,7 +83,7 @@ public:
//! Transform the bounding box with the given transformation. //! Transform the bounding box with the given transformation.
//! The resulting box will be larger if theTrsf contains rotation. //! The resulting box will be larger if theTrsf contains rotation.
Standard_EXPORT Bnd_B2d Transformed (const gp_Trsf2d& theTrsf) const; Standard_EXPORT Standard_NODISCARD Bnd_B2d Transformed (const gp_Trsf2d& theTrsf) const;
//! Check the given point for the inclusion in the Box. //! Check the given point for the inclusion in the Box.
//! Returns True if the point is outside. //! Returns True if the point is outside.

2
src/Bnd/Bnd_B2f.hxx
View File

@ -84,7 +84,7 @@ public:
//! Transform the bounding box with the given transformation. //! Transform the bounding box with the given transformation.
//! The resulting box will be larger if theTrsf contains rotation. //! The resulting box will be larger if theTrsf contains rotation.
Standard_EXPORT Bnd_B2f Transformed (const gp_Trsf2d& theTrsf) const; Standard_EXPORT Standard_NODISCARD Bnd_B2f Transformed (const gp_Trsf2d& theTrsf) const;
//! Check the given point for the inclusion in the Box. //! Check the given point for the inclusion in the Box.
//! Returns True if the point is outside. //! Returns True if the point is outside.

2
src/Bnd/Bnd_B3d.hxx
View File

@ -84,7 +84,7 @@ public:
//! Transform the bounding box with the given transformation. //! Transform the bounding box with the given transformation.
//! The resulting box will be larger if theTrsf contains rotation. //! The resulting box will be larger if theTrsf contains rotation.
Standard_EXPORT Bnd_B3d Transformed (const gp_Trsf& theTrsf) const; Standard_EXPORT Standard_NODISCARD Bnd_B3d Transformed (const gp_Trsf& theTrsf) const;
//! Check the given point for the inclusion in the Box. //! Check the given point for the inclusion in the Box.
//! Returns True if the point is outside. //! Returns True if the point is outside.

2
src/Bnd/Bnd_B3f.hxx
View File

@ -85,7 +85,7 @@ public:
//! Transform the bounding box with the given transformation. //! Transform the bounding box with the given transformation.
//! The resulting box will be larger if theTrsf contains rotation. //! The resulting box will be larger if theTrsf contains rotation.
Standard_EXPORT Bnd_B3f Transformed (const gp_Trsf& theTrsf) const; Standard_EXPORT Standard_NODISCARD Bnd_B3f Transformed (const gp_Trsf& theTrsf) const;
//! Check the given point for the inclusion in the Box. //! Check the given point for the inclusion in the Box.
//! Returns True if the point is outside. //! Returns True if the point is outside.

2
src/Bnd/Bnd_Box.hxx
View File

@ -213,7 +213,7 @@ public:
//! Applying a geometric transformation (for example, a //! Applying a geometric transformation (for example, a
//! rotation) to a bounding box generally increases its //! rotation) to a bounding box generally increases its
//! dimensions. This is not optimal for algorithms which use it. //! dimensions. This is not optimal for algorithms which use it.
Standard_EXPORT Bnd_Box Transformed (const gp_Trsf& T) const; Standard_EXPORT Standard_NODISCARD Bnd_Box Transformed (const gp_Trsf& T) const;
//! Adds the box <Other> to <me>. //! Adds the box <Other> to <me>.
Standard_EXPORT void Add (const Bnd_Box& Other); Standard_EXPORT void Add (const Bnd_Box& Other);

2
src/Bnd/Bnd_Box2d.hxx
View File

@ -160,7 +160,7 @@ public:
//! Applying a geometric transformation (for example, a //! Applying a geometric transformation (for example, a
//! rotation) to a bounding box generally increases its //! rotation) to a bounding box generally increases its
//! dimensions. This is not optimal for algorithms which use it. //! dimensions. This is not optimal for algorithms which use it.
Standard_EXPORT Bnd_Box2d Transformed (const gp_Trsf2d& T) const; Standard_EXPORT Standard_NODISCARD Bnd_Box2d Transformed (const gp_Trsf2d& T) const;
//! Adds the 2d box <Other> to <me>. //! Adds the 2d box <Other> to <me>.
Standard_EXPORT void Add (const Bnd_Box2d& Other); Standard_EXPORT void Add (const Bnd_Box2d& Other);

2
src/ChFi3d/ChFi3d_Builder_2.cxx
View File

@ -851,7 +851,7 @@ void ChFi3d_Builder::StartSol(const Handle(ChFiDS_Stripe)& Stripe,
PC->D1(woned, P1, derive); PC->D1(woned, P1, derive);
// There are ponts on the border, and internal points are found // There are ponts on the border, and internal points are found
if (derive.Magnitude() > Precision::PConfusion()) { if (derive.Magnitude() > Precision::PConfusion()) {
derive.Normalized(); derive.Normalize();
derive.Rotate(M_PI/2); derive.Rotate(M_PI/2);
AS.Initialize(f1); AS.Initialize(f1);
ResU = AS.UResolution(TolE); ResU = AS.UResolution(TolE);

2
src/Contap/Contap_ArcFunction.cxx
View File

@ -128,7 +128,7 @@ Standard_Boolean Contap_ArcFunction::Derivative (const Standard_Real U,
dnorm = d2uv.Crossed(d1v) + d1u.Crossed(d2v); dnorm = d2uv.Crossed(d1v) + d1u.Crossed(d2v);
dfv = (dnorm.Dot(myDir)-myCosAng*dnorm.Dot(norm))/myMean; dfv = (dnorm.Dot(myDir)-myCosAng*dnorm.Dot(norm))/myMean;
*/ */
norm.Normalized(); norm.Normalize();
dfu = (dnu.Dot(myDir)-myCosAng*dnu.Dot(norm))/myMean; dfu = (dnu.Dot(myDir)-myCosAng*dnu.Dot(norm))/myMean;
dfv = (dnv.Dot(myDir)-myCosAng*dnv.Dot(norm))/myMean; dfv = (dnv.Dot(myDir)-myCosAng*dnv.Dot(norm))/myMean;
} }

15
src/Extrema/Extrema_ExtPElS.cxx
View File

@ -162,13 +162,14 @@ void Extrema_ExtPElS::Perform(const gp_Pnt& P,
myDone = Standard_True; myDone = Standard_True;
return; return;
} }
gp_Vec DirZ; gp_Vec DirZ;
if (M.SquareDistance(O)<Tol * Tol) if (M.SquareDistance(O) < Tol * Tol)
{ DirZ=OZ; {
if( A<0) DirZ.Multiplied(-1.); DirZ = (A < 0 ? -OZ : OZ);
} }
else else
DirZ=gp_Vec(M,O); DirZ = gp_Vec(M, O);
// Projection of P in the reference plane of the cone ... // Projection of P in the reference plane of the cone ...
Standard_Real Zp = gp_Vec(O, P).Dot(OZ); Standard_Real Zp = gp_Vec(O, P).Dot(OZ);

2
src/Geom/Geom_Axis1Placement.hxx
View File

@ -65,7 +65,7 @@ public:
Standard_EXPORT void Reverse(); Standard_EXPORT void Reverse();
//! Returns a copy of <me> reversed. //! Returns a copy of <me> reversed.
Standard_EXPORT Handle(Geom_Axis1Placement) Reversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Axis1Placement) Reversed() const;
//! Assigns V to the unit vector of this axis. //! Assigns V to the unit vector of this axis.
Standard_EXPORT void SetDirection (const gp_Dir& V) Standard_OVERRIDE; Standard_EXPORT void SetDirection (const gp_Dir& V) Standard_OVERRIDE;

2
src/Geom/Geom_Curve.hxx
View File

@ -117,7 +117,7 @@ public:
Standard_EXPORT virtual Standard_Real ParametricTransformation (const gp_Trsf& T) const; Standard_EXPORT virtual Standard_Real ParametricTransformation (const gp_Trsf& T) const;
//! Returns a copy of <me> reversed. //! Returns a copy of <me> reversed.
Standard_EXPORT Handle(Geom_Curve) Reversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Curve) Reversed() const;
//! Returns the value of the first parameter. //! Returns the value of the first parameter.
//! Warnings : //! Warnings :

16
src/Geom/Geom_Geometry.hxx
View File

@ -99,21 +99,21 @@ public:
//! (see class Transformation of the package Geom). //! (see class Transformation of the package Geom).
Standard_EXPORT virtual void Transform (const gp_Trsf& T) = 0; Standard_EXPORT virtual void Transform (const gp_Trsf& T) = 0;
Standard_EXPORT Handle(Geom_Geometry) Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Mirrored (const gp_Pnt& P) const;
Standard_EXPORT Handle(Geom_Geometry) Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT Handle(Geom_Geometry) Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Mirrored (const gp_Ax2& A2) const;
Standard_EXPORT Handle(Geom_Geometry) Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
Standard_EXPORT Handle(Geom_Geometry) Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Scaled (const gp_Pnt& P, const Standard_Real S) const;
Standard_EXPORT Handle(Geom_Geometry) Transformed (const gp_Trsf& T) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Transformed (const gp_Trsf& T) const;
Standard_EXPORT Handle(Geom_Geometry) Translated (const gp_Vec& V) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Translated (const gp_Vec& V) const;
Standard_EXPORT Handle(Geom_Geometry) Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Geometry) Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;
//! Creates a new object which is a copy of this geometric object. //! Creates a new object which is a copy of this geometric object.
Standard_EXPORT virtual Handle(Geom_Geometry) Copy() const = 0; Standard_EXPORT virtual Handle(Geom_Geometry) Copy() const = 0;

4
src/Geom/Geom_Surface.hxx
View File

@ -79,7 +79,7 @@ public:
//! Reverses the U direction of parametrization of <me>. //! Reverses the U direction of parametrization of <me>.
//! The bounds of the surface are not modified. //! The bounds of the surface are not modified.
//! A copy of <me> is returned. //! A copy of <me> is returned.
Standard_EXPORT Handle(Geom_Surface) UReversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Surface) UReversed() const;
//! Returns the parameter on the Ureversed surface for //! Returns the parameter on the Ureversed surface for
//! the point of parameter U on <me>. //! the point of parameter U on <me>.
@ -100,7 +100,7 @@ public:
//! Reverses the V direction of parametrization of <me>. //! Reverses the V direction of parametrization of <me>.
//! The bounds of the surface are not modified. //! The bounds of the surface are not modified.
//! A copy of <me> is returned. //! A copy of <me> is returned.
Standard_EXPORT Handle(Geom_Surface) VReversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Surface) VReversed() const;
//! Returns the parameter on the Vreversed surface for //! Returns the parameter on the Vreversed surface for
//! the point of parameter V on <me>. //! the point of parameter V on <me>.

4
src/Geom/Geom_Transformation.hxx
View File

@ -160,12 +160,12 @@ public:
//! Raised if the the transformation is singular. This means that //! Raised if the the transformation is singular. This means that
//! the ScaleFactor is lower or equal to Resolution from //! the ScaleFactor is lower or equal to Resolution from
//! package gp. //! package gp.
Standard_EXPORT Handle(Geom_Transformation) Inverted() const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Transformation) Inverted() const;
//! Computes the transformation composed with Other and <me>. //! Computes the transformation composed with Other and <me>.
//! <me> * Other. //! <me> * Other.
//! Returns a new transformation //! Returns a new transformation
Standard_EXPORT Handle(Geom_Transformation) Multiplied (const Handle(Geom_Transformation)& Other) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Transformation) Multiplied (const Handle(Geom_Transformation)& Other) const;
//! Computes the transformation composed with Other and <me> . //! Computes the transformation composed with Other and <me> .
//! <me> = <me> * Other. //! <me> = <me> * Other.

2
src/Geom/Geom_Vector.hxx
View File

@ -47,7 +47,7 @@ public:
//! Returns a copy of <me> reversed. //! Returns a copy of <me> reversed.
Standard_EXPORT Handle(Geom_Vector) Reversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom_Vector) Reversed() const;
//! Computes the angular value, in radians, between this //! Computes the angular value, in radians, between this
//! vector and vector Other. The result is a value between 0 and Pi. //! vector and vector Other. The result is a value between 0 and Pi.

11
src/Geom/Geom_VectorWithMagnitude.hxx
View File

@ -80,7 +80,7 @@ public:
//! Adds the vector Other to <me>. //! Adds the vector Other to <me>.
Standard_EXPORT Handle(Geom_VectorWithMagnitude) Added (const Handle(Geom_Vector)& Other) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_VectorWithMagnitude) Added (const Handle(Geom_Vector)& Other) const;
//! Computes the cross product between <me> and Other //! Computes the cross product between <me> and Other
@ -106,12 +106,12 @@ public:
//! Divides <me> by a scalar. A new vector is returned. //! Divides <me> by a scalar. A new vector is returned.
Standard_EXPORT Handle(Geom_VectorWithMagnitude) Divided (const Standard_Real Scalar) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_VectorWithMagnitude) Divided (const Standard_Real Scalar) const;
//! Computes the product of the vector <me> by a scalar. //! Computes the product of the vector <me> by a scalar.
//! A new vector is returned. //! A new vector is returned.
Standard_EXPORT Handle(Geom_VectorWithMagnitude) Multiplied (const Standard_Real Scalar) const; Standard_EXPORT Standard_NODISCARD Handle(Geom_VectorWithMagnitude) Multiplied (const Standard_Real Scalar) const;
//! Computes the product of the vector <me> by a scalar. //! Computes the product of the vector <me> by a scalar.
@ -127,14 +127,15 @@ public:
//! //!
//! Raised if the magnitude of the vector is lower or equal to //! Raised if the magnitude of the vector is lower or equal to
//! Resolution from package gp. //! Resolution from package gp.
Standard_EXPORT Handle(Geom_VectorWithMagnitude) Normalized() const; Standard_EXPORT Standard_NODISCARD Handle(Geom_VectorWithMagnitude) Normalized() const;
//! Subtracts the Vector Other to <me>. //! Subtracts the Vector Other to <me>.
Standard_EXPORT void Subtract (const Handle(Geom_Vector)& Other); Standard_EXPORT void Subtract (const Handle(Geom_Vector)& Other);
//! Subtracts the vector Other to <me>. A new vector is returned. //! Subtracts the vector Other to <me>. A new vector is returned.
Standard_EXPORT Handle(Geom_VectorWithMagnitude) Subtracted (const Handle(Geom_Vector)& Other) const; Standard_EXPORT Standard_NODISCARD
Handle(Geom_VectorWithMagnitude) Subtracted (const Handle(Geom_Vector)& Other) const;
//! Applies the transformation T to this vector. //! Applies the transformation T to this vector.
Standard_EXPORT void Transform (const gp_Trsf& T) Standard_OVERRIDE; Standard_EXPORT void Transform (const gp_Trsf& T) Standard_OVERRIDE;

2
src/Geom2d/Geom2d_AxisPlacement.hxx
View File

@ -64,7 +64,7 @@ public:
//! Note: //! Note:
//! - Reverse assigns the result to this axis, while //! - Reverse assigns the result to this axis, while
//! - Reversed creates a new one. //! - Reversed creates a new one.
Standard_EXPORT Handle(Geom2d_AxisPlacement) Reversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_AxisPlacement) Reversed() const;
//! Changes the complete definition of the axis placement. //! Changes the complete definition of the axis placement.
Standard_EXPORT void SetAxis (const gp_Ax2d& A); Standard_EXPORT void SetAxis (const gp_Ax2d& A);

2
src/Geom2d/Geom2d_Curve.hxx
View File

@ -110,7 +110,7 @@ public:
//! - the end point of the initial curve becomes the start //! - the end point of the initial curve becomes the start
//! point of the reversed curve. //! point of the reversed curve.
//! - Reversed creates a new curve. //! - Reversed creates a new curve.
Standard_EXPORT Handle(Geom2d_Curve) Reversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Curve) Reversed() const;
//! Returns the value of the first parameter. //! Returns the value of the first parameter.
//! Warnings : //! Warnings :

14
src/Geom2d/Geom2d_Geometry.hxx
View File

@ -94,19 +94,19 @@ public:
//! itself. A copy of the object is returned. //! itself. A copy of the object is returned.
Standard_EXPORT virtual void Transform (const gp_Trsf2d& T) = 0; Standard_EXPORT virtual void Transform (const gp_Trsf2d& T) = 0;
Standard_EXPORT Handle(Geom2d_Geometry) Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Geometry) Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT Handle(Geom2d_Geometry) Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Geometry) Mirrored (const gp_Ax2d& A) const;
Standard_EXPORT Handle(Geom2d_Geometry) Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Geometry) Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
Standard_EXPORT Handle(Geom2d_Geometry) Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Geometry) Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
Standard_EXPORT Handle(Geom2d_Geometry) Transformed (const gp_Trsf2d& T) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Geometry) Transformed (const gp_Trsf2d& T) const;
Standard_EXPORT Handle(Geom2d_Geometry) Translated (const gp_Vec2d& V) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Geometry) Translated (const gp_Vec2d& V) const;
Standard_EXPORT Handle(Geom2d_Geometry) Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Geometry) Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;
Standard_EXPORT virtual Handle(Geom2d_Geometry) Copy() const = 0; Standard_EXPORT virtual Handle(Geom2d_Geometry) Copy() const = 0;

7
src/Geom2d/Geom2d_Transformation.hxx
View File

@ -170,14 +170,15 @@ public:
//! Computes the inverse of this transformation and creates a new one. //! Computes the inverse of this transformation and creates a new one.
//! Raises ConstructionError if the the transformation is singular. This means that //! Raises ConstructionError if the the transformation is singular. This means that
//! the ScaleFactor is lower or equal to Resolution from package gp. //! the ScaleFactor is lower or equal to Resolution from package gp.
Standard_EXPORT Handle(Geom2d_Transformation) Inverted() const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Transformation) Inverted() const;
//! Computes the transformation composed with Other and <me>. //! Computes the transformation composed with Other and <me>.
//! <me> * Other. //! <me> * Other.
//! Returns a new transformation //! Returns a new transformation
Standard_EXPORT Handle(Geom2d_Transformation) Multiplied (const Handle(Geom2d_Transformation)& Other) const; Standard_EXPORT Standard_NODISCARD
Handle(Geom2d_Transformation) operator * (const Handle(Geom2d_Transformation)& Other) const Handle(Geom2d_Transformation) Multiplied (const Handle(Geom2d_Transformation)& Other) const;
Standard_NODISCARD Handle(Geom2d_Transformation) operator * (const Handle(Geom2d_Transformation)& Other) const
{ {
return Multiplied(Other); return Multiplied(Other);
} }

2
src/Geom2d/Geom2d_Vector.hxx
View File

@ -46,7 +46,7 @@ public:
Standard_EXPORT void Reverse(); Standard_EXPORT void Reverse();
//! Returns a copy of <me> reversed. //! Returns a copy of <me> reversed.
Standard_EXPORT Handle(Geom2d_Vector) Reversed() const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_Vector) Reversed() const;
//! Computes the angular value, in radians, between this //! Computes the angular value, in radians, between this
//! vector and vector Other. The result is a value //! vector and vector Other. The result is a value

3
src/Geom2d/Geom2d_VectorWithMagnitude.cxx
View File

@ -135,8 +135,7 @@ void Geom2d_VectorWithMagnitude::Normalize () { gpVec2d.Normalize (); }
Handle(Geom2d_VectorWithMagnitude) Geom2d_VectorWithMagnitude::Normalized () const { Handle(Geom2d_VectorWithMagnitude) Geom2d_VectorWithMagnitude::Normalized () const {
gp_Vec2d V = gpVec2d; gp_Vec2d V = gpVec2d.Normalized();
V.Normalized ();
return new VectorWithMagnitude (V); return new VectorWithMagnitude (V);
} }

18
src/Geom2d/Geom2d_VectorWithMagnitude.hxx
View File

@ -80,8 +80,9 @@ void operator += (const Handle(Geom2d_Vector)& Other)
//! Adds the vector Other to <me>. //! Adds the vector Other to <me>.
Standard_EXPORT Handle(Geom2d_VectorWithMagnitude) Added (const Handle(Geom2d_Vector)& Other) const; Standard_EXPORT Standard_NODISCARD
Handle(Geom2d_VectorWithMagnitude) operator + (const Handle(Geom2d_Vector)& Other) const Handle(Geom2d_VectorWithMagnitude) Added (const Handle(Geom2d_Vector)& Other) const;
Standard_NODISCARD Handle(Geom2d_VectorWithMagnitude) operator + (const Handle(Geom2d_Vector)& Other) const
{ {
return Added(Other); return Added(Other);
} }
@ -104,8 +105,8 @@ void operator /= (const Standard_Real Scalar)
//! Divides <me> by a scalar. A new vector is returned. //! Divides <me> by a scalar. A new vector is returned.
Standard_EXPORT Handle(Geom2d_VectorWithMagnitude) Divided (const Standard_Real Scalar) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_VectorWithMagnitude) Divided (const Standard_Real Scalar) const;
Handle(Geom2d_VectorWithMagnitude) operator / (const Standard_Real Scalar) const Standard_NODISCARD Handle(Geom2d_VectorWithMagnitude) operator / (const Standard_Real Scalar) const
{ {
return Divided(Scalar); return Divided(Scalar);
} }
@ -116,7 +117,7 @@ Handle(Geom2d_VectorWithMagnitude) operator / (const Standard_Real Scalar) const
//! //!
//! -C++: alias operator * //! -C++: alias operator *
//! Collision with same operator defined for the class Vector! //! Collision with same operator defined for the class Vector!
Standard_EXPORT Handle(Geom2d_VectorWithMagnitude) Multiplied (const Standard_Real Scalar) const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_VectorWithMagnitude) Multiplied (const Standard_Real Scalar) const;
//! Computes the product of the vector <me> by a scalar. //! Computes the product of the vector <me> by a scalar.
@ -136,7 +137,7 @@ void operator *= (const Standard_Real Scalar)
//! //!
//! Raised if the magnitude of the vector is lower or equal to //! Raised if the magnitude of the vector is lower or equal to
//! Resolution from package gp. //! Resolution from package gp.
Standard_EXPORT Handle(Geom2d_VectorWithMagnitude) Normalized() const; Standard_EXPORT Standard_NODISCARD Handle(Geom2d_VectorWithMagnitude) Normalized() const;
//! Subtracts the Vector Other to <me>. //! Subtracts the Vector Other to <me>.
Standard_EXPORT void Subtract (const Handle(Geom2d_Vector)& Other); Standard_EXPORT void Subtract (const Handle(Geom2d_Vector)& Other);
@ -147,8 +148,9 @@ void operator -= (const Handle(Geom2d_Vector)& Other)
//! Subtracts the vector Other to <me>. A new vector is returned. //! Subtracts the vector Other to <me>. A new vector is returned.
Standard_EXPORT Handle(Geom2d_VectorWithMagnitude) Subtracted (const Handle(Geom2d_Vector)& Other) const; Standard_EXPORT Standard_NODISCARD
Handle(Geom2d_VectorWithMagnitude) operator - (const Handle(Geom2d_Vector)& Other) const Handle(Geom2d_VectorWithMagnitude) Subtracted (const Handle(Geom2d_Vector)& Other) const;
Standard_NODISCARD Handle(Geom2d_VectorWithMagnitude) operator - (const Handle(Geom2d_Vector)& Other) const
{ {
return Subtracted(Other); return Subtracted(Other);
} }

2
src/GeomFill/GeomFill_GuideTrihedronPlan.cxx
View File

@ -252,7 +252,7 @@ void GeomFill_GuideTrihedronPlan::SetCurve(const Handle(Adaptor3d_HCurve)& C)
Normal = n.Normalized(); Normal = n.Normalized();
BiNormal = Tangent.Crossed(Normal); BiNormal = Tangent.Crossed(Normal);
BiNormal.Normalized(); BiNormal.Normalize();
} }
else { // Erreur... else { // Erreur...
#ifdef OCCT_DEBUG #ifdef OCCT_DEBUG

2
src/GeomFill/GeomFill_TgtOnCoons.cxx
View File

@ -124,7 +124,7 @@ gp_Vec GeomFill_TgtOnCoons::D1(const Standard_Real W) const
Standard_Real scal = tgsc.Dot(n); Standard_Real scal = tgsc.Dot(n);
gp_Vec scaln = n.Multiplied(-scal); gp_Vec scaln = n.Multiplied(-scal);
tgsc.Added(scaln); tgsc.Add(scaln);
gp_Vec scaldn = dn.Multiplied(-scal); gp_Vec scaldn = dn.Multiplied(-scal);

1
src/IntImpParGen/IntImpParGen.cxx
View File

@ -125,7 +125,6 @@ void IntImpParGen::DetermineTransition(const IntRes2d_Position Pos1,
} }
else { else {
gp_Vec2d Norm; gp_Vec2d Norm;
Tan1.Normalized();
Norm.SetCoord(-Tan1.Y(),Tan1.X()); Norm.SetCoord(-Tan1.Y(),Tan1.X());
Standard_Real Val1,Val2; Standard_Real Val1,Val2;
if (!courbure1) { if (!courbure1) {

1
src/IntImpParGen/IntImpParGen_Tool.cxx
View File

@ -116,7 +116,6 @@ void Determine_Transition(const IntRes2d_Position Pos1,
} }
else { else {
gp_Vec2d Norm; gp_Vec2d Norm;
Tan1.Normalized();
Norm.SetCoord(-Tan1.Y(),Tan1.X()); Norm.SetCoord(-Tan1.Y(),Tan1.X());
Standard_Real Val1,Val2; Standard_Real Val1,Val2;
if (!courbure1) { if (!courbure1) {

5
src/ShapeAnalysis/ShapeAnalysis_TransferParametersProj.cxx
View File

@ -550,12 +550,11 @@ TopoDS_Vertex ShapeAnalysis_TransferParametersProj::CopyNMVertex (const TopoDS_V
Handle(BRep_GCurve) fromGC = Handle(BRep_GCurve)::DownCast(fromitcr.Value()); Handle(BRep_GCurve) fromGC = Handle(BRep_GCurve)::DownCast(fromitcr.Value());
if ( fromGC.IsNull() || !fromGC->IsCurveOnSurface()) continue; if ( fromGC.IsNull() || !fromGC->IsCurveOnSurface()) continue;
TopLoc_Location aL = fromGC->Location(); TopLoc_Location aL = fromGC->Location().Predivided(theV.Location());
aL.Predivided(theV.Location());
Handle(Geom_Surface) surface1 = fromGC->Surface(); Handle(Geom_Surface) surface1 = fromGC->Surface();
Handle(Geom2d_Curve) ac2d1 = fromGC->PCurve(); Handle(Geom2d_Curve) ac2d1 = fromGC->PCurve();
if (pr->IsPointOnCurveOnSurface(ac2d1,surface1,aL)) { if (pr->IsPointOnCurveOnSurface(ac2d1,surface1,aL)) {
found = Standard_True; found = Standard_True;
if(!hasRepr) { if(!hasRepr) {
aOldPar = pr->Parameter(); aOldPar = pr->Parameter();
} }

22
src/Standard/Standard_Macro.hxx
View File

@ -57,6 +57,28 @@
#define Standard_FALLTHROUGH #define Standard_FALLTHROUGH
#endif #endif
//! @def Standard_NODISCARD
//! This attribute may appear in a function declaration,
//! enumeration declaration or class declaration. It tells the compiler to
//! issue a warning, if a return value marked by that attribute is discarded.
//!
//! Expands to C++17 attribute statement "[[nodiscard]]" on compilers that
//! declare support of this attribute, or equivalent attribute on GCC.
#if defined(__has_cpp_attribute)
#if __has_cpp_attribute(nodiscard)
#define Standard_NODISCARD [[nodiscard]]
#else
#define Standard_NODISCARD
#endif
#elif defined(__GNUC__) && ! defined(INTEL_COMPILER)
// According to available documentation, GCC-style __attribute__ ((warn_unused_result))
// should be available in GCC since version 3.4, and in CLang since 3.9;
// Intel compiler does not seem to support this
#define Standard_NODISCARD __attribute__ ((warn_unused_result))
#else
#define Standard_NODISCARD
#endif
//! @def Standard_UNUSED //! @def Standard_UNUSED
//! Macro for marking variables / functions as possibly unused //! Macro for marking variables / functions as possibly unused
//! so that compiler will not emit redundant "unused" warnings. //! so that compiler will not emit redundant "unused" warnings.

14
src/TopLoc/TopLoc_Location.hxx
View File

@ -91,30 +91,30 @@ Standard_EXPORT operator gp_Trsf() const;
//! Returns the inverse of <me>. //! Returns the inverse of <me>.
//! //!
//! <me> * Inverted() is an Identity. //! <me> * Inverted() is an Identity.
Standard_EXPORT TopLoc_Location Inverted() const; Standard_EXPORT Standard_NODISCARD TopLoc_Location Inverted() const;
//! Returns <me> * <Other>, the elementary datums are //! Returns <me> * <Other>, the elementary datums are
//! concatenated. //! concatenated.
Standard_EXPORT TopLoc_Location Multiplied (const TopLoc_Location& Other) const; Standard_EXPORT Standard_NODISCARD TopLoc_Location Multiplied (const TopLoc_Location& Other) const;
TopLoc_Location operator* (const TopLoc_Location& Other) const Standard_NODISCARD TopLoc_Location operator* (const TopLoc_Location& Other) const
{ {
return Multiplied(Other); return Multiplied(Other);
} }
//! Returns <me> / <Other>. //! Returns <me> / <Other>.
Standard_EXPORT TopLoc_Location Divided (const TopLoc_Location& Other) const; Standard_EXPORT Standard_NODISCARD TopLoc_Location Divided (const TopLoc_Location& Other) const;
TopLoc_Location operator/ (const TopLoc_Location& Other) const Standard_NODISCARD TopLoc_Location operator/ (const TopLoc_Location& Other) const
{ {
return Divided(Other); return Divided(Other);
} }
//! Returns <Other>.Inverted() * <me>. //! Returns <Other>.Inverted() * <me>.
Standard_EXPORT TopLoc_Location Predivided (const TopLoc_Location& Other) const; Standard_EXPORT Standard_NODISCARD TopLoc_Location Predivided (const TopLoc_Location& Other) const;
//! Returns me at the power <pwr>. If <pwr> is zero //! Returns me at the power <pwr>. If <pwr> is zero
//! returns Identity. <pwr> can be lower than zero //! returns Identity. <pwr> can be lower than zero
//! (usual meaning for powers). //! (usual meaning for powers).
Standard_EXPORT TopLoc_Location Powered (const Standard_Integer pwr) const; Standard_EXPORT Standard_NODISCARD TopLoc_Location Powered (const Standard_Integer pwr) const;
//! Returns a hashed value for this local coordinate system. //! Returns a hashed value for this local coordinate system.
//! This value is used, with map tables, to store and //! This value is used, with map tables, to store and

4
src/Units/Units_Token.hxx
View File

@ -126,7 +126,7 @@ public:
//! This virtual method is called by the Measurement //! This virtual method is called by the Measurement
//! methods, to compute the measurement during a //! methods, to compute the measurement during a
//! conversion. //! conversion.
Standard_EXPORT virtual Standard_Real Multiplied (const Standard_Real avalue) const; Standard_EXPORT Standard_NODISCARD virtual Standard_Real Multiplied (const Standard_Real avalue) const;
//! Returns a token which is the division of <me> by another //! Returns a token which is the division of <me> by another
//! token <atoken>. //! token <atoken>.
@ -135,7 +135,7 @@ public:
//! This virtual method is called by the Measurement //! This virtual method is called by the Measurement
//! methods, to compute the measurement during a //! methods, to compute the measurement during a
//! conversion. //! conversion.
Standard_EXPORT virtual Standard_Real Divided (const Standard_Real avalue) const; Standard_EXPORT Standard_NODISCARD virtual Standard_Real Divided (const Standard_Real avalue) const;
//! Returns a token which is <me> to the power of another //! Returns a token which is <me> to the power of another
//! token <atoken>. The computation is possible only if //! token <atoken>. The computation is possible only if

18
src/gp/gp_Ax1.hxx
View File

@ -112,7 +112,7 @@ public:
void Reverse(); void Reverse();
//! Reverses the unit vector of this axis and creates a new one. //! Reverses the unit vector of this axis and creates a new one.
gp_Ax1 Reversed() const; Standard_NODISCARD gp_Ax1 Reversed() const;
//! Performs the symmetrical transformation of an axis //! Performs the symmetrical transformation of an axis
@ -123,7 +123,7 @@ public:
//! Performs the symmetrical transformation of an axis //! Performs the symmetrical transformation of an axis
//! placement with respect to the point P which is the //! placement with respect to the point P which is the
//! center of the symmetry and creates a new axis. //! center of the symmetry and creates a new axis.
Standard_EXPORT gp_Ax1 Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Ax1 Mirrored (const gp_Pnt& P) const;
//! Performs the symmetrical transformation of an axis //! Performs the symmetrical transformation of an axis
@ -135,7 +135,7 @@ public:
//! Performs the symmetrical transformation of an axis //! Performs the symmetrical transformation of an axis
//! placement with respect to an axis placement which //! placement with respect to an axis placement which
//! is the axis of the symmetry and creates a new axis. //! is the axis of the symmetry and creates a new axis.
Standard_EXPORT gp_Ax1 Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Ax1 Mirrored (const gp_Ax1& A1) const;
//! Performs the symmetrical transformation of an axis //! Performs the symmetrical transformation of an axis
@ -149,7 +149,7 @@ public:
//! placement with respect to a plane. The axis placement //! placement with respect to a plane. The axis placement
//! <A2> locates the plane of the symmetry : //! <A2> locates the plane of the symmetry :
//! (Location, XDirection, YDirection) and creates a new axis. //! (Location, XDirection, YDirection) and creates a new axis.
Standard_EXPORT gp_Ax1 Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Ax1 Mirrored (const gp_Ax2& A2) const;
//! Rotates this axis at an angle Ang (in radians) about the axis A1 //! Rotates this axis at an angle Ang (in radians) about the axis A1
//! and assigns the result to this axis. //! and assigns the result to this axis.
@ -157,7 +157,7 @@ public:
//! Rotates this axis at an angle Ang (in radians) about the axis A1 //! Rotates this axis at an angle Ang (in radians) about the axis A1
//! and creates a new one. //! and creates a new one.
gp_Ax1 Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Ax1 Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
//! Applies a scaling transformation to this axis with: //! Applies a scaling transformation to this axis with:
@ -169,7 +169,7 @@ public:
//! Applies a scaling transformation to this axis with: //! Applies a scaling transformation to this axis with:
//! - scale factor S, and //! - scale factor S, and
//! - center P and creates a new axis. //! - center P and creates a new axis.
gp_Ax1 Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Ax1 Scaled (const gp_Pnt& P, const Standard_Real S) const;
//! Applies the transformation T to this axis. //! Applies the transformation T to this axis.
//! and assigns the result to this axis. //! and assigns the result to this axis.
@ -180,7 +180,7 @@ public:
//! //!
//! Translates an axis plaxement in the direction of the vector //! Translates an axis plaxement in the direction of the vector
//! <V>. The magnitude of the translation is the vector's magnitude. //! <V>. The magnitude of the translation is the vector's magnitude.
gp_Ax1 Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Ax1 Transformed (const gp_Trsf& T) const;
//! Translates this axis by the vector V, //! Translates this axis by the vector V,
@ -190,7 +190,7 @@ public:
//! Translates this axis by the vector V, //! Translates this axis by the vector V,
//! and creates a new one. //! and creates a new one.
gp_Ax1 Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Ax1 Translated (const gp_Vec& V) const;
//! Translates this axis by: //! Translates this axis by:
@ -202,7 +202,7 @@ public:
//! Translates this axis by: //! Translates this axis by:
//! the vector (P1, P2) defined from point P1 to point P2. //! the vector (P1, P2) defined from point P1 to point P2.
//! and creates a new one. //! and creates a new one.
gp_Ax1 Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Ax1 Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Ax2.hxx
View File

@ -202,7 +202,7 @@ public:
//! product "X Direction" ^ "Y Direction". //! product "X Direction" ^ "Y Direction".
//! This maintains the right-handed property of the //! This maintains the right-handed property of the
//! coordinate system. //! coordinate system.
Standard_EXPORT gp_Ax2 Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Ax2 Mirrored (const gp_Pnt& P) const;
//! Performs a symmetrical transformation of this coordinate //! Performs a symmetrical transformation of this coordinate
@ -238,7 +238,7 @@ public:
//! product "X Direction" ^ "Y Direction". //! product "X Direction" ^ "Y Direction".
//! This maintains the right-handed property of the //! This maintains the right-handed property of the
//! coordinate system. //! coordinate system.
Standard_EXPORT gp_Ax2 Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Ax2 Mirrored (const gp_Ax1& A1) const;
//! Performs a symmetrical transformation of this coordinate //! Performs a symmetrical transformation of this coordinate
@ -276,7 +276,7 @@ public:
//! product "X Direction" ^ "Y Direction". //! product "X Direction" ^ "Y Direction".
//! This maintains the right-handed property of the //! This maintains the right-handed property of the
//! coordinate system. //! coordinate system.
Standard_EXPORT gp_Ax2 Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Ax2 Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
@ -284,7 +284,7 @@ public:
//! Rotates an axis placement. <A1> is the axis of the //! Rotates an axis placement. <A1> is the axis of the
//! rotation . Ang is the angular value of the rotation //! rotation . Ang is the angular value of the rotation
//! in radians. //! in radians.
gp_Ax2 Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Ax2 Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
@ -296,7 +296,7 @@ public:
//! . the main direction of the axis placement is not changed. //! . the main direction of the axis placement is not changed.
//! . The "XDirection" and the "YDirection" are reversed. //! . The "XDirection" and the "YDirection" are reversed.
//! So the axis placement stay right handed. //! So the axis placement stay right handed.
gp_Ax2 Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Ax2 Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
@ -306,21 +306,21 @@ public:
//! "YDirection" are transformed with T. The resulting //! "YDirection" are transformed with T. The resulting
//! main "Direction" of <me> is the cross product between //! main "Direction" of <me> is the cross product between
//! the "XDirection" and the "YDirection" after transformation. //! the "XDirection" and the "YDirection" after transformation.
gp_Ax2 Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Ax2 Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates an axis plaxement in the direction of the vector //! Translates an axis plaxement in the direction of the vector
//! <V>. The magnitude of the translation is the vector's magnitude. //! <V>. The magnitude of the translation is the vector's magnitude.
gp_Ax2 Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Ax2 Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates an axis placement from the point <P1> to the //! Translates an axis placement from the point <P1> to the
//! point <P2>. //! point <P2>.
gp_Ax2 Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Ax2 Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

14
src/gp/gp_Ax22d.hxx
View File

@ -152,7 +152,7 @@ public:
//! The main direction of the axis placement is not changed. //! The main direction of the axis placement is not changed.
//! The "XDirection" and the "YDirection" are reversed. //! The "XDirection" and the "YDirection" are reversed.
//! So the axis placement stay right handed. //! So the axis placement stay right handed.
Standard_EXPORT gp_Ax22d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Ax22d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
@ -164,7 +164,7 @@ public:
//! point, on the "XDirection" and "YDirection". //! point, on the "XDirection" and "YDirection".
//! The resulting main "Direction" is the cross product between //! The resulting main "Direction" is the cross product between
//! the "XDirection" and the "YDirection" after transformation. //! the "XDirection" and the "YDirection" after transformation.
Standard_EXPORT gp_Ax22d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Ax22d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
@ -172,7 +172,7 @@ public:
//! Rotates an axis placement. <A1> is the axis of the //! Rotates an axis placement. <A1> is the axis of the
//! rotation . Ang is the angular value of the rotation //! rotation . Ang is the angular value of the rotation
//! in radians. //! in radians.
gp_Ax22d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Ax22d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
void Scale (const gp_Pnt2d& P, const Standard_Real S); void Scale (const gp_Pnt2d& P, const Standard_Real S);
@ -184,7 +184,7 @@ public:
//! . the main direction of the axis placement is not changed. //! . the main direction of the axis placement is not changed.
//! . The "XDirection" and the "YDirection" are reversed. //! . The "XDirection" and the "YDirection" are reversed.
//! So the axis placement stay right handed. //! So the axis placement stay right handed.
gp_Ax22d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Ax22d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
void Transform (const gp_Trsf2d& T); void Transform (const gp_Trsf2d& T);
@ -194,21 +194,21 @@ public:
//! "YDirection" are transformed with T. The resulting //! "YDirection" are transformed with T. The resulting
//! main "Direction" of <me> is the cross product between //! main "Direction" of <me> is the cross product between
//! the "XDirection" and the "YDirection" after transformation. //! the "XDirection" and the "YDirection" after transformation.
gp_Ax22d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Ax22d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates an axis plaxement in the direction of the vector //! Translates an axis plaxement in the direction of the vector
//! <V>. The magnitude of the translation is the vector's magnitude. //! <V>. The magnitude of the translation is the vector's magnitude.
gp_Ax22d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Ax22d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
//! Translates an axis placement from the point <P1> to the //! Translates an axis placement from the point <P1> to the
//! point <P2>. //! point <P2>.
gp_Ax22d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Ax22d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

16
src/gp/gp_Ax2d.hxx
View File

@ -115,7 +115,7 @@ public:
//! Computes a new axis placement with a direction opposite to //! Computes a new axis placement with a direction opposite to
//! the direction of <me>. //! the direction of <me>.
gp_Ax2d Reversed() const; Standard_NODISCARD gp_Ax2d Reversed() const;
Standard_EXPORT void Mirror (const gp_Pnt2d& P); Standard_EXPORT void Mirror (const gp_Pnt2d& P);
@ -123,7 +123,7 @@ public:
//! Performs the symmetrical transformation of an axis //! Performs the symmetrical transformation of an axis
//! placement with respect to the point P which is the //! placement with respect to the point P which is the
//! center of the symmetry. //! center of the symmetry.
Standard_EXPORT gp_Ax2d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Ax2d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
@ -131,7 +131,7 @@ public:
//! Performs the symmetrical transformation of an axis //! Performs the symmetrical transformation of an axis
//! placement with respect to an axis placement which //! placement with respect to an axis placement which
//! is the axis of the symmetry. //! is the axis of the symmetry.
Standard_EXPORT gp_Ax2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Ax2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
@ -139,7 +139,7 @@ public:
//! Rotates an axis placement. <P> is the center of the //! Rotates an axis placement. <P> is the center of the
//! rotation . Ang is the angular value of the rotation //! rotation . Ang is the angular value of the rotation
//! in radians. //! in radians.
gp_Ax2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Ax2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
Standard_EXPORT void Scale (const gp_Pnt2d& P, const Standard_Real S); Standard_EXPORT void Scale (const gp_Pnt2d& P, const Standard_Real S);
@ -147,26 +147,26 @@ public:
//! Applies a scaling transformation on the axis placement. //! Applies a scaling transformation on the axis placement.
//! The "Location" point of the axisplacement is modified. //! The "Location" point of the axisplacement is modified.
//! The "Direction" is reversed if the scale is negative. //! The "Direction" is reversed if the scale is negative.
gp_Ax2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Ax2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
void Transform (const gp_Trsf2d& T); void Transform (const gp_Trsf2d& T);
//! Transforms an axis placement with a Trsf. //! Transforms an axis placement with a Trsf.
gp_Ax2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Ax2d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates an axis placement in the direction of the vector //! Translates an axis placement in the direction of the vector
//! <V>. The magnitude of the translation is the vector's magnitude. //! <V>. The magnitude of the translation is the vector's magnitude.
gp_Ax2d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Ax2d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
//! Translates an axis placement from the point <P1> to the //! Translates an axis placement from the point <P1> to the
//! point <P2>. //! point <P2>.
gp_Ax2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Ax2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

16
src/gp/gp_Ax3.hxx
View File

@ -218,7 +218,7 @@ public:
//! The main direction of the axis placement is not changed. //! The main direction of the axis placement is not changed.
//! The "XDirection" and the "YDirection" are reversed. //! The "XDirection" and the "YDirection" are reversed.
//! So the axis placement stay right handed. //! So the axis placement stay right handed.
Standard_EXPORT gp_Ax3 Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Ax3 Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -230,7 +230,7 @@ public:
//! point, on the "XDirection" and "YDirection". //! point, on the "XDirection" and "YDirection".
//! The resulting main "Direction" is the cross product between //! The resulting main "Direction" is the cross product between
//! the "XDirection" and the "YDirection" after transformation. //! the "XDirection" and the "YDirection" after transformation.
Standard_EXPORT gp_Ax3 Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Ax3 Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -243,7 +243,7 @@ public:
//! point, on the "XDirection" and "YDirection". //! point, on the "XDirection" and "YDirection".
//! The resulting main "Direction" is the cross product between //! The resulting main "Direction" is the cross product between
//! the "XDirection" and the "YDirection" after transformation. //! the "XDirection" and the "YDirection" after transformation.
Standard_EXPORT gp_Ax3 Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Ax3 Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
@ -251,7 +251,7 @@ public:
//! Rotates an axis placement. <A1> is the axis of the //! Rotates an axis placement. <A1> is the axis of the
//! rotation . Ang is the angular value of the rotation //! rotation . Ang is the angular value of the rotation
//! in radians. //! in radians.
gp_Ax3 Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Ax3 Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
@ -263,7 +263,7 @@ public:
//! . the main direction of the axis placement is not changed. //! . the main direction of the axis placement is not changed.
//! . The "XDirection" and the "YDirection" are reversed. //! . The "XDirection" and the "YDirection" are reversed.
//! So the axis placement stay right handed. //! So the axis placement stay right handed.
gp_Ax3 Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Ax3 Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
@ -273,21 +273,21 @@ public:
//! "YDirection" are transformed with T. The resulting //! "YDirection" are transformed with T. The resulting
//! main "Direction" of <me> is the cross product between //! main "Direction" of <me> is the cross product between
//! the "XDirection" and the "YDirection" after transformation. //! the "XDirection" and the "YDirection" after transformation.
gp_Ax3 Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Ax3 Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates an axis plaxement in the direction of the vector //! Translates an axis plaxement in the direction of the vector
//! <V>. The magnitude of the translation is the vector's magnitude. //! <V>. The magnitude of the translation is the vector's magnitude.
gp_Ax3 Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Ax3 Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates an axis placement from the point <P1> to the //! Translates an axis placement from the point <P1> to the
//! point <P2>. //! point <P2>.
gp_Ax3 Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Ax3 Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Circ.hxx
View File

@ -153,7 +153,7 @@ public:
//! Performs the symmetrical transformation of a circle //! Performs the symmetrical transformation of a circle
//! with respect to the point P which is the center of the //! with respect to the point P which is the center of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Circ Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Circ Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -161,7 +161,7 @@ public:
//! Performs the symmetrical transformation of a circle with //! Performs the symmetrical transformation of a circle with
//! respect to an axis placement which is the axis of the //! respect to an axis placement which is the axis of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Circ Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Circ Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -169,14 +169,14 @@ public:
//! Performs the symmetrical transformation of a circle with respect //! Performs the symmetrical transformation of a circle with respect
//! to a plane. The axis placement A2 locates the plane of the //! to a plane. The axis placement A2 locates the plane of the
//! of the symmetry : (Location, XDirection, YDirection). //! of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Circ Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Circ Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a circle. A1 is the axis of the rotation. //! Rotates a circle. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Circ Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Circ Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
@ -186,26 +186,26 @@ public:
//! If S is negative the radius stay positive but //! If S is negative the radius stay positive but
//! the "XAxis" and the "YAxis" are reversed as for //! the "XAxis" and the "YAxis" are reversed as for
//! an ellipse. //! an ellipse.
gp_Circ Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Circ Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms a circle with the transformation T from class Trsf. //! Transforms a circle with the transformation T from class Trsf.
gp_Circ Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Circ Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a circle in the direction of the vector V. //! Translates a circle in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Circ Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Circ Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a circle from the point P1 to the point P2. //! Translates a circle from the point P1 to the point P2.
gp_Circ Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Circ Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Circ2d.hxx
View File

@ -156,7 +156,7 @@ public:
//! of this circle (the "Y Direction" is reversed) and therefore //! of this circle (the "Y Direction" is reversed) and therefore
//! changes the implicit orientation of this circle. //! changes the implicit orientation of this circle.
//! Reversed creates a new circle. //! Reversed creates a new circle.
gp_Circ2d Reversed() const; Standard_NODISCARD gp_Circ2d Reversed() const;
//! Returns true if the local coordinate system is direct //! Returns true if the local coordinate system is direct
//! and false in the other case. //! and false in the other case.
@ -167,21 +167,21 @@ public:
//! Performs the symmetrical transformation of a circle with respect //! Performs the symmetrical transformation of a circle with respect
//! to the point P which is the center of the symmetry //! to the point P which is the center of the symmetry
Standard_EXPORT gp_Circ2d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Circ2d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
//! Performs the symmetrical transformation of a circle with respect //! Performs the symmetrical transformation of a circle with respect
//! to an axis placement which is the axis of the symmetry. //! to an axis placement which is the axis of the symmetry.
Standard_EXPORT gp_Circ2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Circ2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
//! Rotates a circle. P is the center of the rotation. //! Rotates a circle. P is the center of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Circ2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Circ2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
void Scale (const gp_Pnt2d& P, const Standard_Real S); void Scale (const gp_Pnt2d& P, const Standard_Real S);
@ -191,26 +191,26 @@ public:
//! If S is negative the radius stay positive but //! If S is negative the radius stay positive but
//! the "XAxis" and the "YAxis" are reversed as for //! the "XAxis" and the "YAxis" are reversed as for
//! an ellipse. //! an ellipse.
gp_Circ2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Circ2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
void Transform (const gp_Trsf2d& T); void Transform (const gp_Trsf2d& T);
//! Transforms a circle with the transformation T from class Trsf2d. //! Transforms a circle with the transformation T from class Trsf2d.
gp_Circ2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Circ2d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates a circle in the direction of the vector V. //! Translates a circle in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Circ2d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Circ2d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
//! Translates a circle from the point P1 to the point P2. //! Translates a circle from the point P1 to the point P2.
gp_Circ2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Circ2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

16
src/gp/gp_Cone.hxx
View File

@ -163,7 +163,7 @@ public:
//! Performs the symmetrical transformation of a cone //! Performs the symmetrical transformation of a cone
//! with respect to the point P which is the center of the //! with respect to the point P which is the center of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Cone Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Cone Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -171,7 +171,7 @@ public:
//! Performs the symmetrical transformation of a cone with //! Performs the symmetrical transformation of a cone with
//! respect to an axis placement which is the axis of the //! respect to an axis placement which is the axis of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Cone Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Cone Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -179,40 +179,40 @@ public:
//! Performs the symmetrical transformation of a cone with respect //! Performs the symmetrical transformation of a cone with respect
//! to a plane. The axis placement A2 locates the plane of the //! to a plane. The axis placement A2 locates the plane of the
//! of the symmetry : (Location, XDirection, YDirection). //! of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Cone Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Cone Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a cone. A1 is the axis of the rotation. //! Rotates a cone. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Cone Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Cone Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Scales a cone. S is the scaling value. //! Scales a cone. S is the scaling value.
//! The absolute value of S is used to scale the cone //! The absolute value of S is used to scale the cone
gp_Cone Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Cone Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms a cone with the transformation T from class Trsf. //! Transforms a cone with the transformation T from class Trsf.
gp_Cone Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Cone Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a cone in the direction of the vector V. //! Translates a cone in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Cone Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Cone Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a cone from the point P1 to the point P2. //! Translates a cone from the point P1 to the point P2.
gp_Cone Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Cone Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Cylinder.hxx
View File

@ -125,7 +125,7 @@ public:
//! Performs the symmetrical transformation of a cylinder //! Performs the symmetrical transformation of a cylinder
//! with respect to the point P which is the center of the //! with respect to the point P which is the center of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Cylinder Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Cylinder Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -133,7 +133,7 @@ public:
//! Performs the symmetrical transformation of a cylinder with //! Performs the symmetrical transformation of a cylinder with
//! respect to an axis placement which is the axis of the //! respect to an axis placement which is the axis of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Cylinder Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Cylinder Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -141,40 +141,40 @@ public:
//! Performs the symmetrical transformation of a cylinder with respect //! Performs the symmetrical transformation of a cylinder with respect
//! to a plane. The axis placement A2 locates the plane of the //! to a plane. The axis placement A2 locates the plane of the
//! of the symmetry : (Location, XDirection, YDirection). //! of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Cylinder Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Cylinder Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a cylinder. A1 is the axis of the rotation. //! Rotates a cylinder. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Cylinder Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Cylinder Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Scales a cylinder. S is the scaling value. //! Scales a cylinder. S is the scaling value.
//! The absolute value of S is used to scale the cylinder //! The absolute value of S is used to scale the cylinder
gp_Cylinder Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Cylinder Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms a cylinder with the transformation T from class Trsf. //! Transforms a cylinder with the transformation T from class Trsf.
gp_Cylinder Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Cylinder Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a cylinder in the direction of the vector V. //! Translates a cylinder in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Cylinder Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Cylinder Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a cylinder from the point P1 to the point P2. //! Translates a cylinder from the point P1 to the point P2.
gp_Cylinder Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Cylinder Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

20
src/gp/gp_Dir.hxx
View File

@ -176,8 +176,8 @@ public:
//! Raises the exception ConstructionError if V1 and V2 are parallel //! Raises the exception ConstructionError if V1 and V2 are parallel
//! or <me> and (V1^V2) are parallel because the computed vector //! or <me> and (V1^V2) are parallel because the computed vector
//! can't be normalized to create a direction. //! can't be normalized to create a direction.
gp_Dir Crossed (const gp_Dir& Right) const; Standard_NODISCARD gp_Dir Crossed (const gp_Dir& Right) const;
gp_Dir operator ^ (const gp_Dir& Right) const Standard_NODISCARD gp_Dir operator ^ (const gp_Dir& Right) const
{ {
return Crossed(Right); return Crossed(Right);
} }
@ -192,7 +192,7 @@ public:
//! - this unit vector and (V1 ^ V2) are parallel. //! - this unit vector and (V1 ^ V2) are parallel.
//! This is because, in these conditions, the computed vector //! This is because, in these conditions, the computed vector
//! is null and cannot be normalized. //! is null and cannot be normalized.
gp_Dir CrossCrossed (const gp_Dir& V1, const gp_Dir& V2) const; Standard_NODISCARD gp_Dir CrossCrossed (const gp_Dir& V1, const gp_Dir& V2) const;
//! Computes the scalar product //! Computes the scalar product
Standard_Real Dot (const gp_Dir& Other) const; Standard_Real Dot (const gp_Dir& Other) const;
@ -216,8 +216,8 @@ public:
//! Performs the symmetrical transformation of a direction //! Performs the symmetrical transformation of a direction
//! with respect to the direction V which is the center of //! with respect to the direction V which is the center of
//! the symmetry.] //! the symmetry.]
gp_Dir Reversed() const; Standard_NODISCARD gp_Dir Reversed() const;
gp_Dir operator -() const Standard_NODISCARD gp_Dir operator -() const
{ {
return Reversed(); return Reversed();
} }
@ -228,7 +228,7 @@ public:
//! Performs the symmetrical transformation of a direction //! Performs the symmetrical transformation of a direction
//! with respect to the direction V which is the center of //! with respect to the direction V which is the center of
//! the symmetry. //! the symmetry.
Standard_EXPORT gp_Dir Mirrored (const gp_Dir& V) const; Standard_EXPORT Standard_NODISCARD gp_Dir Mirrored (const gp_Dir& V) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -236,7 +236,7 @@ public:
//! Performs the symmetrical transformation of a direction //! Performs the symmetrical transformation of a direction
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
//! of the symmetry. //! of the symmetry.
Standard_EXPORT gp_Dir Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Dir Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -244,14 +244,14 @@ public:
//! Performs the symmetrical transformation of a direction //! Performs the symmetrical transformation of a direction
//! with respect to a plane. The axis placement A2 locates //! with respect to a plane. The axis placement A2 locates
//! the plane of the symmetry : (Location, XDirection, YDirection). //! the plane of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Dir Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Dir Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a direction. A1 is the axis of the rotation. //! Rotates a direction. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Dir Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Dir Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
Standard_EXPORT void Transform (const gp_Trsf& T); Standard_EXPORT void Transform (const gp_Trsf& T);
@ -260,7 +260,7 @@ public:
//! Warnings : //! Warnings :
//! If the scale factor of the "Trsf" T is negative then the //! If the scale factor of the "Trsf" T is negative then the
//! direction <me> is reversed. //! direction <me> is reversed.
gp_Dir Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Dir Transformed (const gp_Trsf& T) const;

16
src/gp/gp_Dir2d.hxx
View File

@ -195,8 +195,8 @@ public:
//! Computes the cross product between two directions. //! Computes the cross product between two directions.
Standard_Real Crossed (const gp_Dir2d& Right) const; Standard_NODISCARD Standard_Real Crossed (const gp_Dir2d& Right) const;
Standard_Real operator ^ (const gp_Dir2d& Right) const Standard_NODISCARD Standard_Real operator ^ (const gp_Dir2d& Right) const
{ {
return Crossed(Right); return Crossed(Right);
} }
@ -211,8 +211,8 @@ public:
void Reverse(); void Reverse();
//! Reverses the orientation of a direction //! Reverses the orientation of a direction
gp_Dir2d Reversed() const; Standard_NODISCARD gp_Dir2d Reversed() const;
gp_Dir2d operator -() const Standard_NODISCARD gp_Dir2d operator -() const
{ {
return Reversed(); return Reversed();
} }
@ -223,7 +223,7 @@ public:
//! Performs the symmetrical transformation of a direction //! Performs the symmetrical transformation of a direction
//! with respect to the direction V which is the center of //! with respect to the direction V which is the center of
//! the symmetry. //! the symmetry.
Standard_EXPORT gp_Dir2d Mirrored (const gp_Dir2d& V) const; Standard_EXPORT Standard_NODISCARD gp_Dir2d Mirrored (const gp_Dir2d& V) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
@ -231,14 +231,14 @@ public:
//! Performs the symmetrical transformation of a direction //! Performs the symmetrical transformation of a direction
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
//! of the symmetry. //! of the symmetry.
Standard_EXPORT gp_Dir2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Dir2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const Standard_Real Ang); void Rotate (const Standard_Real Ang);
//! Rotates a direction. Ang is the angular value of //! Rotates a direction. Ang is the angular value of
//! the rotation in radians. //! the rotation in radians.
gp_Dir2d Rotated (const Standard_Real Ang) const; Standard_NODISCARD gp_Dir2d Rotated (const Standard_Real Ang) const;
Standard_EXPORT void Transform (const gp_Trsf2d& T); Standard_EXPORT void Transform (const gp_Trsf2d& T);
@ -247,7 +247,7 @@ public:
//! Warnings : //! Warnings :
//! If the scale factor of the "Trsf" T is negative then the //! If the scale factor of the "Trsf" T is negative then the
//! direction <me> is reversed. //! direction <me> is reversed.
gp_Dir2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Dir2d Transformed (const gp_Trsf2d& T) const;

16
src/gp/gp_Elips.hxx
View File

@ -198,14 +198,14 @@ public:
//! Performs the symmetrical transformation of an ellipse with //! Performs the symmetrical transformation of an ellipse with
//! respect to the point P which is the center of the symmetry. //! respect to the point P which is the center of the symmetry.
Standard_EXPORT gp_Elips Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Elips Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
//! Performs the symmetrical transformation of an ellipse with //! Performs the symmetrical transformation of an ellipse with
//! respect to an axis placement which is the axis of the symmetry. //! respect to an axis placement which is the axis of the symmetry.
Standard_EXPORT gp_Elips Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Elips Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -213,39 +213,39 @@ public:
//! Performs the symmetrical transformation of an ellipse with //! Performs the symmetrical transformation of an ellipse with
//! respect to a plane. The axis placement A2 locates the plane //! respect to a plane. The axis placement A2 locates the plane
//! of the symmetry (Location, XDirection, YDirection). //! of the symmetry (Location, XDirection, YDirection).
Standard_EXPORT gp_Elips Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Elips Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates an ellipse. A1 is the axis of the rotation. //! Rotates an ellipse. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Elips Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Elips Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Scales an ellipse. S is the scaling value. //! Scales an ellipse. S is the scaling value.
gp_Elips Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Elips Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms an ellipse with the transformation T from class Trsf. //! Transforms an ellipse with the transformation T from class Trsf.
gp_Elips Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Elips Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates an ellipse in the direction of the vector V. //! Translates an ellipse in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Elips Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Elips Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates an ellipse from the point P1 to the point P2. //! Translates an ellipse from the point P1 to the point P2.
gp_Elips Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Elips Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Elips2d.hxx
View File

@ -197,7 +197,7 @@ public:
void Reverse(); void Reverse();
gp_Elips2d Reversed() const; Standard_NODISCARD gp_Elips2d Reversed() const;
//! Returns true if the local coordinate system is direct //! Returns true if the local coordinate system is direct
//! and false in the other case. //! and false in the other case.
@ -208,43 +208,43 @@ public:
//! Performs the symmetrical transformation of a ellipse with respect //! Performs the symmetrical transformation of a ellipse with respect
//! to the point P which is the center of the symmetry //! to the point P which is the center of the symmetry
Standard_EXPORT gp_Elips2d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Elips2d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
//! Performs the symmetrical transformation of a ellipse with respect //! Performs the symmetrical transformation of a ellipse with respect
//! to an axis placement which is the axis of the symmetry. //! to an axis placement which is the axis of the symmetry.
Standard_EXPORT gp_Elips2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Elips2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
gp_Elips2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Elips2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
void Scale (const gp_Pnt2d& P, const Standard_Real S); void Scale (const gp_Pnt2d& P, const Standard_Real S);
//! Scales a ellipse. S is the scaling value. //! Scales a ellipse. S is the scaling value.
gp_Elips2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Elips2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
void Transform (const gp_Trsf2d& T); void Transform (const gp_Trsf2d& T);
//! Transforms an ellipse with the transformation T from class Trsf2d. //! Transforms an ellipse with the transformation T from class Trsf2d.
gp_Elips2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Elips2d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates a ellipse in the direction of the vector V. //! Translates a ellipse in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Elips2d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Elips2d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
//! Translates a ellipse from the point P1 to the point P2. //! Translates a ellipse from the point P1 to the point P2.
gp_Elips2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Elips2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

8
src/gp/gp_GTrsf.hxx
View File

@ -182,7 +182,7 @@ public:
//! Computes the reverse transformation. //! Computes the reverse transformation.
//! Raises an exception if the matrix of the transformation //! Raises an exception if the matrix of the transformation
//! is not inversible. //! is not inversible.
gp_GTrsf Inverted() const; Standard_NODISCARD gp_GTrsf Inverted() const;
//! Computes the transformation composed from T and <me>. //! Computes the transformation composed from T and <me>.
@ -198,8 +198,8 @@ public:
//! XYZ P2(P); //! XYZ P2(P);
//! T1.Transforms(P2); //using T1 then T2 //! T1.Transforms(P2); //using T1 then T2
//! T2.Transforms(P2); // P1 = P2 !!! //! T2.Transforms(P2); // P1 = P2 !!!
gp_GTrsf Multiplied (const gp_GTrsf& T) const; Standard_NODISCARD gp_GTrsf Multiplied (const gp_GTrsf& T) const;
gp_GTrsf operator * (const gp_GTrsf& T) const Standard_NODISCARD gp_GTrsf operator * (const gp_GTrsf& T) const
{ {
return Multiplied(T); return Multiplied(T);
} }
@ -235,7 +235,7 @@ public:
//! //!
//! Raises an exception if N < 0 and if the matrix of the //! Raises an exception if N < 0 and if the matrix of the
//! transformation not inversible. //! transformation not inversible.
gp_GTrsf Powered (const Standard_Integer N) const; Standard_NODISCARD gp_GTrsf Powered (const Standard_Integer N) const;
void Transforms (gp_XYZ& Coord) const; void Transforms (gp_XYZ& Coord) const;

10
src/gp/gp_GTrsf2d.hxx
View File

@ -156,7 +156,7 @@ public:
//! Computes the reverse transformation. //! Computes the reverse transformation.
//! Raised an exception if the matrix of the transformation //! Raised an exception if the matrix of the transformation
//! is not inversible. //! is not inversible.
gp_GTrsf2d Inverted() const; Standard_NODISCARD gp_GTrsf2d Inverted() const;
//! Computes the transformation composed with T and <me>. //! Computes the transformation composed with T and <me>.
@ -172,8 +172,8 @@ public:
//! XY P2(P); //! XY P2(P);
//! T1.Transforms(P2); //using T1 then T2 //! T1.Transforms(P2); //using T1 then T2
//! T2.Transforms(P2); // P1 = P2 !!! //! T2.Transforms(P2); // P1 = P2 !!!
gp_GTrsf2d Multiplied (const gp_GTrsf2d& T) const; Standard_NODISCARD gp_GTrsf2d Multiplied (const gp_GTrsf2d& T) const;
gp_GTrsf2d operator * (const gp_GTrsf2d& T) const Standard_NODISCARD gp_GTrsf2d operator * (const gp_GTrsf2d& T) const
{ {
return Multiplied(T); return Multiplied(T);
} }
@ -200,11 +200,11 @@ void operator *= (const gp_GTrsf2d& T)
//! //!
//! Raises an exception if N < 0 and if the matrix of the //! Raises an exception if N < 0 and if the matrix of the
//! transformation is not inversible. //! transformation is not inversible.
gp_GTrsf2d Powered (const Standard_Integer N) const; Standard_NODISCARD gp_GTrsf2d Powered (const Standard_Integer N) const;
void Transforms (gp_XY& Coord) const; void Transforms (gp_XY& Coord) const;
gp_XY Transformed (const gp_XY& Coord) const; Standard_NODISCARD gp_XY Transformed (const gp_XY& Coord) const;
//! Applies this transformation to the coordinates: //! Applies this transformation to the coordinates:

16
src/gp/gp_Hypr.hxx
View File

@ -251,14 +251,14 @@ public:
//! Performs the symmetrical transformation of an hyperbola with //! Performs the symmetrical transformation of an hyperbola with
//! respect to the point P which is the center of the symmetry. //! respect to the point P which is the center of the symmetry.
Standard_EXPORT gp_Hypr Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Hypr Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
//! Performs the symmetrical transformation of an hyperbola with //! Performs the symmetrical transformation of an hyperbola with
//! respect to an axis placement which is the axis of the symmetry. //! respect to an axis placement which is the axis of the symmetry.
Standard_EXPORT gp_Hypr Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Hypr Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -266,40 +266,40 @@ public:
//! Performs the symmetrical transformation of an hyperbola with //! Performs the symmetrical transformation of an hyperbola with
//! respect to a plane. The axis placement A2 locates the plane //! respect to a plane. The axis placement A2 locates the plane
//! of the symmetry (Location, XDirection, YDirection). //! of the symmetry (Location, XDirection, YDirection).
Standard_EXPORT gp_Hypr Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Hypr Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates an hyperbola. A1 is the axis of the rotation. //! Rotates an hyperbola. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Hypr Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Hypr Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Scales an hyperbola. S is the scaling value. //! Scales an hyperbola. S is the scaling value.
gp_Hypr Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Hypr Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms an hyperbola with the transformation T from //! Transforms an hyperbola with the transformation T from
//! class Trsf. //! class Trsf.
gp_Hypr Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Hypr Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates an hyperbola in the direction of the vector V. //! Translates an hyperbola in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Hypr Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Hypr Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates an hyperbola from the point P1 to the point P2. //! Translates an hyperbola from the point P1 to the point P2.
gp_Hypr Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Hypr Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Hypr2d.hxx
View File

@ -268,7 +268,7 @@ public:
//! Note: //! Note:
//! - Reverse assigns the result to this hyperbola, while //! - Reverse assigns the result to this hyperbola, while
//! - Reversed creates a new one. //! - Reversed creates a new one.
gp_Hypr2d Reversed() const; Standard_NODISCARD gp_Hypr2d Reversed() const;
//! Returns true if the local coordinate system is direct //! Returns true if the local coordinate system is direct
//! and false in the other case. //! and false in the other case.
@ -279,21 +279,21 @@ public:
//! Performs the symmetrical transformation of an hyperbola with //! Performs the symmetrical transformation of an hyperbola with
//! respect to the point P which is the center of the symmetry. //! respect to the point P which is the center of the symmetry.
Standard_EXPORT gp_Hypr2d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Hypr2d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
//! Performs the symmetrical transformation of an hyperbola with //! Performs the symmetrical transformation of an hyperbola with
//! respect to an axis placement which is the axis of the symmetry. //! respect to an axis placement which is the axis of the symmetry.
Standard_EXPORT gp_Hypr2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Hypr2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
//! Rotates an hyperbola. P is the center of the rotation. //! Rotates an hyperbola. P is the center of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Hypr2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Hypr2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
void Scale (const gp_Pnt2d& P, const Standard_Real S); void Scale (const gp_Pnt2d& P, const Standard_Real S);
@ -302,27 +302,27 @@ public:
//! If <S> is positive only the location point is //! If <S> is positive only the location point is
//! modified. But if <S> is negative the "XAxis" is //! modified. But if <S> is negative the "XAxis" is
//! reversed and the "YAxis" too. //! reversed and the "YAxis" too.
gp_Hypr2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Hypr2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
void Transform (const gp_Trsf2d& T); void Transform (const gp_Trsf2d& T);
//! Transforms an hyperbola with the transformation T from //! Transforms an hyperbola with the transformation T from
//! class Trsf2d. //! class Trsf2d.
gp_Hypr2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Hypr2d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates an hyperbola in the direction of the vector V. //! Translates an hyperbola in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Hypr2d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Hypr2d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
//! Translates an hyperbola from the point P1 to the point P2. //! Translates an hyperbola from the point P1 to the point P2.
gp_Hypr2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Hypr2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

18
src/gp/gp_Lin.hxx
View File

@ -71,7 +71,7 @@ public:
//! Note: //! Note:
//! - Reverse assigns the result to this line, while //! - Reverse assigns the result to this line, while
//! - Reversed creates a new one. //! - Reversed creates a new one.
gp_Lin Reversed() const; Standard_NODISCARD gp_Lin Reversed() const;
//! Changes the direction of the line. //! Changes the direction of the line.
void SetDirection (const gp_Dir& V); void SetDirection (const gp_Dir& V);
@ -132,7 +132,7 @@ public:
//! Performs the symmetrical transformation of a line //! Performs the symmetrical transformation of a line
//! with respect to the point P which is the center of //! with respect to the point P which is the center of
//! the symmetry. //! the symmetry.
Standard_EXPORT gp_Lin Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Lin Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -140,7 +140,7 @@ public:
//! Performs the symmetrical transformation of a line //! Performs the symmetrical transformation of a line
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
//! of the symmetry. //! of the symmetry.
Standard_EXPORT gp_Lin Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Lin Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -149,14 +149,14 @@ public:
//! with respect to a plane. The axis placement <A2> //! with respect to a plane. The axis placement <A2>
//! locates the plane of the symmetry : //! locates the plane of the symmetry :
//! (Location, XDirection, YDirection). //! (Location, XDirection, YDirection).
Standard_EXPORT gp_Lin Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Lin Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a line. A1 is the axis of the rotation. //! Rotates a line. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Lin Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Lin Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
@ -164,26 +164,26 @@ public:
//! Scales a line. S is the scaling value. //! Scales a line. S is the scaling value.
//! The "Location" point (origin) of the line is modified. //! The "Location" point (origin) of the line is modified.
//! The "Direction" is reversed if the scale is negative. //! The "Direction" is reversed if the scale is negative.
gp_Lin Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Lin Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms a line with the transformation T from class Trsf. //! Transforms a line with the transformation T from class Trsf.
gp_Lin Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Lin Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a line in the direction of the vector V. //! Translates a line in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Lin Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Lin Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a line from the point P1 to the point P2. //! Translates a line from the point P1 to the point P2.
gp_Lin Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Lin Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Lin2d.hxx
View File

@ -79,7 +79,7 @@ public:
//! Note: //! Note:
//! - Reverse assigns the result to this line, while //! - Reverse assigns the result to this line, while
//! - Reversed creates a new one. //! - Reversed creates a new one.
gp_Lin2d Reversed() const; Standard_NODISCARD gp_Lin2d Reversed() const;
//! Changes the direction of the line. //! Changes the direction of the line.
void SetDirection (const gp_Dir2d& V); void SetDirection (const gp_Dir2d& V);
@ -143,7 +143,7 @@ public:
//! Performs the symmetrical transformation of a line //! Performs the symmetrical transformation of a line
//! with respect to the point <P> which is the center //! with respect to the point <P> which is the center
//! of the symmetry //! of the symmetry
Standard_EXPORT gp_Lin2d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Lin2d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
@ -151,40 +151,40 @@ public:
//! Performs the symmetrical transformation of a line //! Performs the symmetrical transformation of a line
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
//! of the symmetry. //! of the symmetry.
Standard_EXPORT gp_Lin2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Lin2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
//! Rotates a line. P is the center of the rotation. //! Rotates a line. P is the center of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Lin2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Lin2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
void Scale (const gp_Pnt2d& P, const Standard_Real S); void Scale (const gp_Pnt2d& P, const Standard_Real S);
//! Scales a line. S is the scaling value. Only the //! Scales a line. S is the scaling value. Only the
//! origin of the line is modified. //! origin of the line is modified.
gp_Lin2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Lin2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
void Transform (const gp_Trsf2d& T); void Transform (const gp_Trsf2d& T);
//! Transforms a line with the transformation T from class Trsf2d. //! Transforms a line with the transformation T from class Trsf2d.
gp_Lin2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Lin2d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates a line in the direction of the vector V. //! Translates a line in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Lin2d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Lin2d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
//! Translates a line from the point P1 to the point P2. //! Translates a line from the point P1 to the point P2.
gp_Lin2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Lin2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

26
src/gp/gp_Mat.hxx
View File

@ -159,8 +159,8 @@ public:
//! Computes the sum of this matrix and //! Computes the sum of this matrix and
//! the matrix Other for each coefficient of the matrix : //! the matrix Other for each coefficient of the matrix :
//! <me>.Coef(i,j) + <Other>.Coef(i,j) //! <me>.Coef(i,j) + <Other>.Coef(i,j)
gp_Mat Added (const gp_Mat& Other) const; Standard_NODISCARD gp_Mat Added (const gp_Mat& Other) const;
gp_Mat operator + (const gp_Mat& Other) const Standard_NODISCARD gp_Mat operator + (const gp_Mat& Other) const
{ {
return Added(Other); return Added(Other);
} }
@ -172,8 +172,8 @@ public:
} }
//! Divides all the coefficients of the matrix by Scalar //! Divides all the coefficients of the matrix by Scalar
gp_Mat Divided (const Standard_Real Scalar) const; Standard_NODISCARD gp_Mat Divided (const Standard_Real Scalar) const;
gp_Mat operator / (const Standard_Real Scalar) const Standard_NODISCARD gp_Mat operator / (const Standard_Real Scalar) const
{ {
return Divided(Scalar); return Divided(Scalar);
} }
@ -191,12 +191,12 @@ public:
//! Exceptions //! Exceptions
//! Standard_ConstructionError if this matrix is singular, //! Standard_ConstructionError if this matrix is singular,
//! and therefore cannot be inverted. //! and therefore cannot be inverted.
Standard_EXPORT gp_Mat Inverted() const; Standard_NODISCARD Standard_EXPORT gp_Mat Inverted() const;
//! Computes the product of two matrices <me> * <Other> //! Computes the product of two matrices <me> * <Other>
gp_Mat Multiplied (const gp_Mat& Other) const; Standard_NODISCARD gp_Mat Multiplied (const gp_Mat& Other) const;
gp_Mat operator * (const gp_Mat& Other) const Standard_NODISCARD gp_Mat operator * (const gp_Mat& Other) const
{ {
return Multiplied(Other); return Multiplied(Other);
} }
@ -210,8 +210,8 @@ public:
void PreMultiply (const gp_Mat& Other); void PreMultiply (const gp_Mat& Other);
gp_Mat Multiplied (const Standard_Real Scalar) const; Standard_NODISCARD gp_Mat Multiplied (const Standard_Real Scalar) const;
gp_Mat operator * (const Standard_Real Scalar) const Standard_NODISCARD gp_Mat operator * (const Standard_Real Scalar) const
{ {
return Multiplied(Scalar); return Multiplied(Scalar);
} }
@ -232,7 +232,7 @@ public:
//! if N < 0 <me> = <me>.Invert() *...........* <me>.Invert(). //! if N < 0 <me> = <me>.Invert() *...........* <me>.Invert().
//! If N < 0 an exception will be raised if the matrix is not //! If N < 0 an exception will be raised if the matrix is not
//! inversible //! inversible
gp_Mat Powered (const Standard_Integer N) const; Standard_NODISCARD gp_Mat Powered (const Standard_Integer N) const;
void Subtract (const gp_Mat& Other); void Subtract (const gp_Mat& Other);
void operator -= (const gp_Mat& Other) void operator -= (const gp_Mat& Other)
@ -243,8 +243,8 @@ public:
//! cOmputes for each coefficient of the matrix : //! cOmputes for each coefficient of the matrix :
//! <me>.Coef(i,j) - <Other>.Coef(i,j) //! <me>.Coef(i,j) - <Other>.Coef(i,j)
gp_Mat Subtracted (const gp_Mat& Other) const; Standard_NODISCARD gp_Mat Subtracted (const gp_Mat& Other) const;
gp_Mat operator - (const gp_Mat& Other) const Standard_NODISCARD gp_Mat operator - (const gp_Mat& Other) const
{ {
return Subtracted(Other); return Subtracted(Other);
} }
@ -253,7 +253,7 @@ public:
//! Transposes the matrix. A(j, i) -> A (i, j) //! Transposes the matrix. A(j, i) -> A (i, j)
gp_Mat Transposed() const; Standard_NODISCARD gp_Mat Transposed() const;
friend class gp_XYZ; friend class gp_XYZ;

26
src/gp/gp_Mat2d.hxx
View File

@ -139,8 +139,8 @@ public:
//! Note: //! Note:
//! - operator += assigns the result to this matrix, while //! - operator += assigns the result to this matrix, while
//! - operator + creates a new one. //! - operator + creates a new one.
gp_Mat2d Added (const gp_Mat2d& Other) const; Standard_NODISCARD gp_Mat2d Added (const gp_Mat2d& Other) const;
gp_Mat2d operator + (const gp_Mat2d& Other) const Standard_NODISCARD gp_Mat2d operator + (const gp_Mat2d& Other) const
{ {
return Added(Other); return Added(Other);
} }
@ -153,8 +153,8 @@ public:
//! Divides all the coefficients of the matrix by a scalar. //! Divides all the coefficients of the matrix by a scalar.
gp_Mat2d Divided (const Standard_Real Scalar) const; Standard_NODISCARD gp_Mat2d Divided (const Standard_Real Scalar) const;
gp_Mat2d operator / (const Standard_Real Scalar) const Standard_NODISCARD gp_Mat2d operator / (const Standard_Real Scalar) const
{ {
return Divided(Scalar); return Divided(Scalar);
} }
@ -164,10 +164,10 @@ public:
//! Inverses the matrix and raises exception if the matrix //! Inverses the matrix and raises exception if the matrix
//! is singular. //! is singular.
gp_Mat2d Inverted() const; Standard_NODISCARD gp_Mat2d Inverted() const;
gp_Mat2d Multiplied (const gp_Mat2d& Other) const; Standard_NODISCARD gp_Mat2d Multiplied (const gp_Mat2d& Other) const;
gp_Mat2d operator * (const gp_Mat2d& Other) const Standard_NODISCARD gp_Mat2d operator * (const gp_Mat2d& Other) const
{ {
return Multiplied(Other); return Multiplied(Other);
} }
@ -180,8 +180,8 @@ public:
//! <me> = Other * <me>. //! <me> = Other * <me>.
void PreMultiply (const gp_Mat2d& Other); void PreMultiply (const gp_Mat2d& Other);
gp_Mat2d Multiplied (const Standard_Real Scalar) const; Standard_NODISCARD gp_Mat2d Multiplied (const Standard_Real Scalar) const;
gp_Mat2d operator * (const Standard_Real Scalar) const Standard_NODISCARD gp_Mat2d operator * (const Standard_Real Scalar) const
{ {
return Multiplied(Scalar); return Multiplied(Scalar);
} }
@ -202,7 +202,7 @@ public:
//! if N < 0 <me> = <me>.Invert() *...........* <me>.Invert(). //! if N < 0 <me> = <me>.Invert() *...........* <me>.Invert().
//! If N < 0 an exception can be raised if the matrix is not //! If N < 0 an exception can be raised if the matrix is not
//! inversible //! inversible
gp_Mat2d Powered (const Standard_Integer N) const; Standard_NODISCARD gp_Mat2d Powered (const Standard_Integer N) const;
void Subtract (const gp_Mat2d& Other); void Subtract (const gp_Mat2d& Other);
void operator -= (const gp_Mat2d& Other) void operator -= (const gp_Mat2d& Other)
@ -213,8 +213,8 @@ public:
//! Computes for each coefficient of the matrix : //! Computes for each coefficient of the matrix :
//! <me>.Coef(i,j) - <Other>.Coef(i,j) //! <me>.Coef(i,j) - <Other>.Coef(i,j)
gp_Mat2d Subtracted (const gp_Mat2d& Other) const; Standard_NODISCARD gp_Mat2d Subtracted (const gp_Mat2d& Other) const;
gp_Mat2d operator - (const gp_Mat2d& Other) const Standard_NODISCARD gp_Mat2d operator - (const gp_Mat2d& Other) const
{ {
return Subtracted(Other); return Subtracted(Other);
} }
@ -223,7 +223,7 @@ public:
//! Transposes the matrix. A(j, i) -> A (i, j) //! Transposes the matrix. A(j, i) -> A (i, j)
gp_Mat2d Transposed() const; Standard_NODISCARD gp_Mat2d Transposed() const;
friend class gp_Trsf2d; friend class gp_Trsf2d;

16
src/gp/gp_Parab.hxx
View File

@ -165,7 +165,7 @@ public:
//! Performs the symmetrical transformation of a parabola //! Performs the symmetrical transformation of a parabola
//! with respect to the point P which is the center of the //! with respect to the point P which is the center of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Parab Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Parab Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -173,7 +173,7 @@ public:
//! Performs the symmetrical transformation of a parabola //! Performs the symmetrical transformation of a parabola
//! with respect to an axis placement which is the axis of //! with respect to an axis placement which is the axis of
//! the symmetry. //! the symmetry.
Standard_EXPORT gp_Parab Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Parab Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -181,14 +181,14 @@ public:
//! Performs the symmetrical transformation of a parabola //! Performs the symmetrical transformation of a parabola
//! with respect to a plane. The axis placement A2 locates //! with respect to a plane. The axis placement A2 locates
//! the plane of the symmetry (Location, XDirection, YDirection). //! the plane of the symmetry (Location, XDirection, YDirection).
Standard_EXPORT gp_Parab Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Parab Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a parabola. A1 is the axis of the rotation. //! Rotates a parabola. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Parab Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Parab Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
@ -196,26 +196,26 @@ public:
//! Scales a parabola. S is the scaling value. //! Scales a parabola. S is the scaling value.
//! If S is negative the direction of the symmetry axis //! If S is negative the direction of the symmetry axis
//! XAxis is reversed and the direction of the YAxis too. //! XAxis is reversed and the direction of the YAxis too.
gp_Parab Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Parab Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms a parabola with the transformation T from class Trsf. //! Transforms a parabola with the transformation T from class Trsf.
gp_Parab Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Parab Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a parabola in the direction of the vector V. //! Translates a parabola in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Parab Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Parab Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a parabola from the point P1 to the point P2. //! Translates a parabola from the point P1 to the point P2.
gp_Parab Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Parab Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Parab2d.hxx
View File

@ -177,7 +177,7 @@ public:
//! Note: //! Note:
//! - Reverse assigns the result to this parabola, while //! - Reverse assigns the result to this parabola, while
//! - Reversed creates a new one. //! - Reversed creates a new one.
gp_Parab2d Reversed() const; Standard_NODISCARD gp_Parab2d Reversed() const;
//! Returns true if the local coordinate system is direct //! Returns true if the local coordinate system is direct
//! and false in the other case. //! and false in the other case.
@ -188,21 +188,21 @@ public:
//! Performs the symmetrical transformation of a parabola with respect //! Performs the symmetrical transformation of a parabola with respect
//! to the point P which is the center of the symmetry //! to the point P which is the center of the symmetry
Standard_EXPORT gp_Parab2d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Parab2d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
//! Performs the symmetrical transformation of a parabola with respect //! Performs the symmetrical transformation of a parabola with respect
//! to an axis placement which is the axis of the symmetry. //! to an axis placement which is the axis of the symmetry.
Standard_EXPORT gp_Parab2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Parab2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
//! Rotates a parabola. P is the center of the rotation. //! Rotates a parabola. P is the center of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Parab2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Parab2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
void Scale (const gp_Pnt2d& P, const Standard_Real S); void Scale (const gp_Pnt2d& P, const Standard_Real S);
@ -210,26 +210,26 @@ public:
//! Scales a parabola. S is the scaling value. //! Scales a parabola. S is the scaling value.
//! If S is negative the direction of the symmetry axis //! If S is negative the direction of the symmetry axis
//! "XAxis" is reversed and the direction of the "YAxis" too. //! "XAxis" is reversed and the direction of the "YAxis" too.
gp_Parab2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Parab2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
void Transform (const gp_Trsf2d& T); void Transform (const gp_Trsf2d& T);
//! Transforms an parabola with the transformation T from class Trsf2d. //! Transforms an parabola with the transformation T from class Trsf2d.
gp_Parab2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Parab2d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates a parabola in the direction of the vector V. //! Translates a parabola in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Parab2d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Parab2d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
//! Translates a parabola from the point P1 to the point P2. //! Translates a parabola from the point P1 to the point P2.
gp_Parab2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Parab2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

16
src/gp/gp_Pln.hxx
View File

@ -178,7 +178,7 @@ public:
//! Warnings : //! Warnings :
//! The normal direction to the plane is not changed. //! The normal direction to the plane is not changed.
//! The "XAxis" and the "YAxis" are reversed. //! The "XAxis" and the "YAxis" are reversed.
Standard_EXPORT gp_Pln Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Pln Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -190,7 +190,7 @@ public:
//! the "XDirection" and the "YDirection" after transformation //! the "XDirection" and the "YDirection" after transformation
//! if the initial plane was right handed, else it is the //! if the initial plane was right handed, else it is the
//! opposite. //! opposite.
Standard_EXPORT gp_Pln Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Pln Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -202,20 +202,20 @@ public:
//! direction is the cross product between the "XDirection" //! direction is the cross product between the "XDirection"
//! and the "YDirection" after transformation if the initial //! and the "YDirection" after transformation if the initial
//! plane was right handed, else it is the opposite. //! plane was right handed, else it is the opposite.
Standard_EXPORT gp_Pln Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Pln Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! rotates a plane. A1 is the axis of the rotation. //! rotates a plane. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Pln Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Pln Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Scales a plane. S is the scaling value. //! Scales a plane. S is the scaling value.
gp_Pln Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Pln Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
@ -225,20 +225,20 @@ public:
//! point, on the "XAxis" and the "YAxis". //! point, on the "XAxis" and the "YAxis".
//! The resulting normal direction is the cross product between //! The resulting normal direction is the cross product between
//! the "XDirection" and the "YDirection" after transformation. //! the "XDirection" and the "YDirection" after transformation.
gp_Pln Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Pln Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a plane in the direction of the vector V. //! Translates a plane in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Pln Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Pln Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a plane from the point P1 to the point P2. //! Translates a plane from the point P1 to the point P2.
gp_Pln Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Pln Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Pnt.hxx
View File

@ -129,7 +129,7 @@ public:
//! Performs the symmetrical transformation of a point //! Performs the symmetrical transformation of a point
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
//! of the symmetry. //! of the symmetry.
Standard_EXPORT gp_Pnt Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Pnt Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -137,41 +137,41 @@ public:
//! Performs the symmetrical transformation of a point //! Performs the symmetrical transformation of a point
//! with respect to a plane. The axis placement A2 locates //! with respect to a plane. The axis placement A2 locates
//! the plane of the symmetry : (Location, XDirection, YDirection). //! the plane of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Pnt Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Pnt Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
//! Rotates a point. A1 is the axis of the rotation. //! Rotates a point. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
Standard_EXPORT gp_Pnt Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Pnt Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Scales a point. S is the scaling value. //! Scales a point. S is the scaling value.
gp_Pnt Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Pnt Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Transforms a point with the transformation T. //! Transforms a point with the transformation T.
gp_Pnt Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Pnt Scaled (const gp_Pnt& P, const Standard_Real S) const;
Standard_EXPORT void Transform (const gp_Trsf& T); Standard_EXPORT void Transform (const gp_Trsf& T);
//! Translates a point in the direction of the vector V. //! Translates a point in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Pnt Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Pnt Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a point from the point P1 to the point P2. //! Translates a point from the point P1 to the point P2.
gp_Pnt Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Pnt Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
gp_Pnt Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Pnt Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

14
src/gp/gp_Pnt2d.hxx
View File

@ -114,41 +114,41 @@ public:
//! Performs the symmetrical transformation of a point //! Performs the symmetrical transformation of a point
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
Standard_EXPORT gp_Pnt2d Mirrored (const gp_Pnt2d& P) const; Standard_EXPORT Standard_NODISCARD gp_Pnt2d Mirrored (const gp_Pnt2d& P) const;
Standard_EXPORT void Mirror (const gp_Ax2d& A); Standard_EXPORT void Mirror (const gp_Ax2d& A);
//! Rotates a point. A1 is the axis of the rotation. //! Rotates a point. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
Standard_EXPORT gp_Pnt2d Mirrored (const gp_Ax2d& A) const; Standard_EXPORT Standard_NODISCARD gp_Pnt2d Mirrored (const gp_Ax2d& A) const;
void Rotate (const gp_Pnt2d& P, const Standard_Real Ang); void Rotate (const gp_Pnt2d& P, const Standard_Real Ang);
//! Scales a point. S is the scaling value. //! Scales a point. S is the scaling value.
gp_Pnt2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const; Standard_NODISCARD gp_Pnt2d Rotated (const gp_Pnt2d& P, const Standard_Real Ang) const;
void Scale (const gp_Pnt2d& P, const Standard_Real S); void Scale (const gp_Pnt2d& P, const Standard_Real S);
//! Transforms a point with the transformation T. //! Transforms a point with the transformation T.
gp_Pnt2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const; Standard_NODISCARD gp_Pnt2d Scaled (const gp_Pnt2d& P, const Standard_Real S) const;
Standard_EXPORT void Transform (const gp_Trsf2d& T); Standard_EXPORT void Transform (const gp_Trsf2d& T);
//! Translates a point in the direction of the vector V. //! Translates a point in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Pnt2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Pnt2d Transformed (const gp_Trsf2d& T) const;
void Translate (const gp_Vec2d& V); void Translate (const gp_Vec2d& V);
//! Translates a point from the point P1 to the point P2. //! Translates a point from the point P1 to the point P2.
gp_Pnt2d Translated (const gp_Vec2d& V) const; Standard_NODISCARD gp_Pnt2d Translated (const gp_Vec2d& V) const;
void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2); void Translate (const gp_Pnt2d& P1, const gp_Pnt2d& P2);
gp_Pnt2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const; Standard_NODISCARD gp_Pnt2d Translated (const gp_Pnt2d& P1, const gp_Pnt2d& P2) const;

26
src/gp/gp_Quaternion.hxx
View File

@ -128,13 +128,13 @@ public:
void Reverse(); void Reverse();
//! Return rotation with reversed direction (conjugated quaternion) //! Return rotation with reversed direction (conjugated quaternion)
gp_Quaternion Reversed() const; Standard_NODISCARD gp_Quaternion Reversed() const;
//! Inverts quaternion (both rotation direction and norm) //! Inverts quaternion (both rotation direction and norm)
void Invert(); void Invert();
//! Return inversed quaternion q^-1 //! Return inversed quaternion q^-1
gp_Quaternion Inverted() const; Standard_NODISCARD gp_Quaternion Inverted() const;
//! Returns square norm of quaternion //! Returns square norm of quaternion
Standard_Real SquareNorm() const; Standard_Real SquareNorm() const;
@ -151,8 +151,8 @@ void operator *= (const Standard_Real theScale)
} }
//! Returns scaled quaternion //! Returns scaled quaternion
gp_Quaternion Scaled (const Standard_Real theScale) const; Standard_NODISCARD gp_Quaternion Scaled (const Standard_Real theScale) const;
gp_Quaternion operator * (const Standard_Real theScale) const Standard_NODISCARD gp_Quaternion operator * (const Standard_Real theScale) const
{ {
return Scaled(theScale); return Scaled(theScale);
} }
@ -168,27 +168,27 @@ gp_Quaternion operator * (const Standard_Real theScale) const
Standard_EXPORT void Normalize(); Standard_EXPORT void Normalize();
//! Returns quaternion scaled so that its norm goes to 1. //! Returns quaternion scaled so that its norm goes to 1.
gp_Quaternion Normalized() const; Standard_NODISCARD gp_Quaternion Normalized() const;
//! Returns quaternion with all components negated. //! Returns quaternion with all components negated.
//! Note that this operation does not affect neither //! Note that this operation does not affect neither
//! rotation operator defined by quaternion nor its norm. //! rotation operator defined by quaternion nor its norm.
gp_Quaternion Negated() const; Standard_NODISCARD gp_Quaternion Negated() const;
gp_Quaternion operator -() const Standard_NODISCARD gp_Quaternion operator -() const
{ {
return Negated(); return Negated();
} }
//! Makes sum of quaternion components; result is "rotations mix" //! Makes sum of quaternion components; result is "rotations mix"
gp_Quaternion Added (const gp_Quaternion& theOther) const; Standard_NODISCARD gp_Quaternion Added (const gp_Quaternion& theOther) const;
gp_Quaternion operator + (const gp_Quaternion& theOther) const Standard_NODISCARD gp_Quaternion operator + (const gp_Quaternion& theOther) const
{ {
return Added(theOther); return Added(theOther);
} }
//! Makes difference of quaternion components; result is "rotations mix" //! Makes difference of quaternion components; result is "rotations mix"
gp_Quaternion Subtracted (const gp_Quaternion& theOther) const; Standard_NODISCARD gp_Quaternion Subtracted (const gp_Quaternion& theOther) const;
gp_Quaternion operator - (const gp_Quaternion& theOther) const Standard_NODISCARD gp_Quaternion operator - (const gp_Quaternion& theOther) const
{ {
return Subtracted(theOther); return Subtracted(theOther);
} }
@ -199,8 +199,8 @@ gp_Quaternion operator - (const gp_Quaternion& theOther) const
//! Notices than: //! Notices than:
//! qq' != q'q; //! qq' != q'q;
//! qq^-1 = q; //! qq^-1 = q;
gp_Quaternion Multiplied (const gp_Quaternion& theOther) const; Standard_NODISCARD gp_Quaternion Multiplied (const gp_Quaternion& theOther) const;
gp_Quaternion operator * (const gp_Quaternion& theOther) const Standard_NODISCARD gp_Quaternion operator * (const gp_Quaternion& theOther) const
{ {
return Multiplied(theOther); return Multiplied(theOther);
} }

16
src/gp/gp_Sphere.hxx
View File

@ -132,7 +132,7 @@ public:
//! Performs the symmetrical transformation of a sphere //! Performs the symmetrical transformation of a sphere
//! with respect to the point P which is the center of the //! with respect to the point P which is the center of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Sphere Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Sphere Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -140,7 +140,7 @@ public:
//! Performs the symmetrical transformation of a sphere with //! Performs the symmetrical transformation of a sphere with
//! respect to an axis placement which is the axis of the //! respect to an axis placement which is the axis of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Sphere Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Sphere Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -148,40 +148,40 @@ public:
//! Performs the symmetrical transformation of a sphere with respect //! Performs the symmetrical transformation of a sphere with respect
//! to a plane. The axis placement A2 locates the plane of the //! to a plane. The axis placement A2 locates the plane of the
//! of the symmetry : (Location, XDirection, YDirection). //! of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Sphere Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Sphere Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a sphere. A1 is the axis of the rotation. //! Rotates a sphere. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Sphere Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Sphere Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Scales a sphere. S is the scaling value. //! Scales a sphere. S is the scaling value.
//! The absolute value of S is used to scale the sphere //! The absolute value of S is used to scale the sphere
gp_Sphere Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Sphere Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms a sphere with the transformation T from class Trsf. //! Transforms a sphere with the transformation T from class Trsf.
gp_Sphere Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Sphere Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a sphere in the direction of the vector V. //! Translates a sphere in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Sphere Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Sphere Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a sphere from the point P1 to the point P2. //! Translates a sphere from the point P1 to the point P2.
gp_Sphere Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Sphere Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

16
src/gp/gp_Torus.hxx
View File

@ -174,7 +174,7 @@ public:
//! Performs the symmetrical transformation of a torus //! Performs the symmetrical transformation of a torus
//! with respect to the point P which is the center of the //! with respect to the point P which is the center of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Torus Mirrored (const gp_Pnt& P) const; Standard_EXPORT Standard_NODISCARD gp_Torus Mirrored (const gp_Pnt& P) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -182,7 +182,7 @@ public:
//! Performs the symmetrical transformation of a torus with //! Performs the symmetrical transformation of a torus with
//! respect to an axis placement which is the axis of the //! respect to an axis placement which is the axis of the
//! symmetry. //! symmetry.
Standard_EXPORT gp_Torus Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Torus Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -190,40 +190,40 @@ public:
//! Performs the symmetrical transformation of a torus with respect //! Performs the symmetrical transformation of a torus with respect
//! to a plane. The axis placement A2 locates the plane of the //! to a plane. The axis placement A2 locates the plane of the
//! of the symmetry : (Location, XDirection, YDirection). //! of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Torus Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Torus Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a torus. A1 is the axis of the rotation. //! Rotates a torus. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Torus Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Torus Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const gp_Pnt& P, const Standard_Real S); void Scale (const gp_Pnt& P, const Standard_Real S);
//! Scales a torus. S is the scaling value. //! Scales a torus. S is the scaling value.
//! The absolute value of S is used to scale the torus //! The absolute value of S is used to scale the torus
gp_Torus Scaled (const gp_Pnt& P, const Standard_Real S) const; Standard_NODISCARD gp_Torus Scaled (const gp_Pnt& P, const Standard_Real S) const;
void Transform (const gp_Trsf& T); void Transform (const gp_Trsf& T);
//! Transforms a torus with the transformation T from class Trsf. //! Transforms a torus with the transformation T from class Trsf.
gp_Torus Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Torus Transformed (const gp_Trsf& T) const;
void Translate (const gp_Vec& V); void Translate (const gp_Vec& V);
//! Translates a torus in the direction of the vector V. //! Translates a torus in the direction of the vector V.
//! The magnitude of the translation is the vector's magnitude. //! The magnitude of the translation is the vector's magnitude.
gp_Torus Translated (const gp_Vec& V) const; Standard_NODISCARD gp_Torus Translated (const gp_Vec& V) const;
void Translate (const gp_Pnt& P1, const gp_Pnt& P2); void Translate (const gp_Pnt& P1, const gp_Pnt& P2);
//! Translates a torus from the point P1 to the point P2. //! Translates a torus from the point P1 to the point P2.
gp_Torus Translated (const gp_Pnt& P1, const gp_Pnt& P2) const; Standard_NODISCARD gp_Torus Translated (const gp_Pnt& P1, const gp_Pnt& P2) const;

8
src/gp/gp_Trsf.hxx
View File

@ -282,10 +282,10 @@ public:
//! Pnt P2 = P1.Transformed(Tcomp); //using Tcomp //! Pnt P2 = P1.Transformed(Tcomp); //using Tcomp
//! Pnt P3 = P1.Transformed(T1); //using T1 then T2 //! Pnt P3 = P1.Transformed(T1); //using T1 then T2
//! P3.Transform(T2); // P3 = P2 !!! //! P3.Transform(T2); // P3 = P2 !!!
gp_Trsf Inverted() const; Standard_NODISCARD gp_Trsf Inverted() const;
gp_Trsf Multiplied (const gp_Trsf& T) const; Standard_NODISCARD gp_Trsf Multiplied (const gp_Trsf& T) const;
gp_Trsf operator * (const gp_Trsf& T) const Standard_NODISCARD gp_Trsf operator * (const gp_Trsf& T) const
{ {
return Multiplied(T); return Multiplied(T);
} }
@ -314,7 +314,7 @@ void operator *= (const gp_Trsf& T)
//! //!
//! Raises if N < 0 and if the matrix of the transformation not //! Raises if N < 0 and if the matrix of the transformation not
//! inversible. //! inversible.
gp_Trsf Powered (const Standard_Integer N) const; Standard_NODISCARD gp_Trsf Powered (const Standard_Integer N) const;
void Transforms (Standard_Real& X, Standard_Real& Y, Standard_Real& Z) const; void Transforms (Standard_Real& X, Standard_Real& Y, Standard_Real& Z) const;

6
src/gp/gp_Trsf2d.hxx
View File

@ -164,10 +164,10 @@ public:
//! Raises an exception if the matrix of the transformation //! Raises an exception if the matrix of the transformation
//! is not inversible, it means that the scale factor is lower //! is not inversible, it means that the scale factor is lower
//! or equal to Resolution from package gp. //! or equal to Resolution from package gp.
gp_Trsf2d Inverted() const; Standard_NODISCARD gp_Trsf2d Inverted() const;
gp_Trsf2d Multiplied (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Trsf2d Multiplied (const gp_Trsf2d& T) const;
gp_Trsf2d operator * (const gp_Trsf2d& T) const Standard_NODISCARD gp_Trsf2d operator * (const gp_Trsf2d& T) const
{ {
return Multiplied(T); return Multiplied(T);
} }

40
src/gp/gp_Vec.hxx
View File

@ -173,8 +173,8 @@ public:
} }
//! Adds two vectors //! Adds two vectors
gp_Vec Added (const gp_Vec& Other) const; Standard_NODISCARD gp_Vec Added (const gp_Vec& Other) const;
gp_Vec operator + (const gp_Vec& Other) const Standard_NODISCARD gp_Vec operator + (const gp_Vec& Other) const
{ {
return Added(Other); return Added(Other);
} }
@ -187,8 +187,8 @@ public:
} }
//! Subtracts two vectors //! Subtracts two vectors
gp_Vec Subtracted (const gp_Vec& Right) const; Standard_NODISCARD gp_Vec Subtracted (const gp_Vec& Right) const;
gp_Vec operator - (const gp_Vec& Right) const Standard_NODISCARD gp_Vec operator - (const gp_Vec& Right) const
{ {
return Subtracted(Right); return Subtracted(Right);
} }
@ -201,8 +201,8 @@ public:
} }
//! Multiplies a vector by a scalar //! Multiplies a vector by a scalar
gp_Vec Multiplied (const Standard_Real Scalar) const; Standard_NODISCARD gp_Vec Multiplied (const Standard_Real Scalar) const;
gp_Vec operator * (const Standard_Real Scalar) const Standard_NODISCARD gp_Vec operator * (const Standard_Real Scalar) const
{ {
return Multiplied(Scalar); return Multiplied(Scalar);
} }
@ -215,8 +215,8 @@ public:
} }
//! Divides a vector by a scalar //! Divides a vector by a scalar
gp_Vec Divided (const Standard_Real Scalar) const; Standard_NODISCARD gp_Vec Divided (const Standard_Real Scalar) const;
gp_Vec operator / (const Standard_Real Scalar) const Standard_NODISCARD gp_Vec operator / (const Standard_Real Scalar) const
{ {
return Divided(Scalar); return Divided(Scalar);
} }
@ -229,8 +229,8 @@ public:
} }
//! computes the cross product between two vectors //! computes the cross product between two vectors
gp_Vec Crossed (const gp_Vec& Right) const; Standard_NODISCARD gp_Vec Crossed (const gp_Vec& Right) const;
gp_Vec operator ^ (const gp_Vec& Right) const Standard_NODISCARD gp_Vec operator ^ (const gp_Vec& Right) const
{ {
return Crossed(Right); return Crossed(Right);
} }
@ -253,7 +253,7 @@ public:
//! Computes the triple vector product. //! Computes the triple vector product.
//! <me> ^ (V1 ^ V2) //! <me> ^ (V1 ^ V2)
gp_Vec CrossCrossed (const gp_Vec& V1, const gp_Vec& V2) const; Standard_NODISCARD gp_Vec CrossCrossed (const gp_Vec& V1, const gp_Vec& V2) const;
//! computes the scalar product //! computes the scalar product
Standard_Real Dot (const gp_Vec& Other) const; Standard_Real Dot (const gp_Vec& Other) const;
@ -273,14 +273,14 @@ public:
//! normalizes a vector //! normalizes a vector
//! Raises an exception if the magnitude of the vector is //! Raises an exception if the magnitude of the vector is
//! lower or equal to Resolution from gp. //! lower or equal to Resolution from gp.
gp_Vec Normalized() const; Standard_NODISCARD gp_Vec Normalized() const;
//! Reverses the direction of a vector //! Reverses the direction of a vector
void Reverse(); void Reverse();
//! Reverses the direction of a vector //! Reverses the direction of a vector
gp_Vec Reversed() const; Standard_NODISCARD gp_Vec Reversed() const;
gp_Vec operator -() const Standard_NODISCARD gp_Vec operator -() const
{ {
return Reversed(); return Reversed();
} }
@ -319,7 +319,7 @@ public:
//! Performs the symmetrical transformation of a vector //! Performs the symmetrical transformation of a vector
//! with respect to the vector V which is the center of //! with respect to the vector V which is the center of
//! the symmetry. //! the symmetry.
Standard_EXPORT gp_Vec Mirrored (const gp_Vec& V) const; Standard_EXPORT Standard_NODISCARD gp_Vec Mirrored (const gp_Vec& V) const;
Standard_EXPORT void Mirror (const gp_Ax1& A1); Standard_EXPORT void Mirror (const gp_Ax1& A1);
@ -327,7 +327,7 @@ public:
//! Performs the symmetrical transformation of a vector //! Performs the symmetrical transformation of a vector
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
//! of the symmetry. //! of the symmetry.
Standard_EXPORT gp_Vec Mirrored (const gp_Ax1& A1) const; Standard_EXPORT Standard_NODISCARD gp_Vec Mirrored (const gp_Ax1& A1) const;
Standard_EXPORT void Mirror (const gp_Ax2& A2); Standard_EXPORT void Mirror (const gp_Ax2& A2);
@ -335,25 +335,25 @@ public:
//! Performs the symmetrical transformation of a vector //! Performs the symmetrical transformation of a vector
//! with respect to a plane. The axis placement A2 locates //! with respect to a plane. The axis placement A2 locates
//! the plane of the symmetry : (Location, XDirection, YDirection). //! the plane of the symmetry : (Location, XDirection, YDirection).
Standard_EXPORT gp_Vec Mirrored (const gp_Ax2& A2) const; Standard_EXPORT Standard_NODISCARD gp_Vec Mirrored (const gp_Ax2& A2) const;
void Rotate (const gp_Ax1& A1, const Standard_Real Ang); void Rotate (const gp_Ax1& A1, const Standard_Real Ang);
//! Rotates a vector. A1 is the axis of the rotation. //! Rotates a vector. A1 is the axis of the rotation.
//! Ang is the angular value of the rotation in radians. //! Ang is the angular value of the rotation in radians.
gp_Vec Rotated (const gp_Ax1& A1, const Standard_Real Ang) const; Standard_NODISCARD gp_Vec Rotated (const gp_Ax1& A1, const Standard_Real Ang) const;
void Scale (const Standard_Real S); void Scale (const Standard_Real S);
//! Scales a vector. S is the scaling value. //! Scales a vector. S is the scaling value.
gp_Vec Scaled (const Standard_Real S) const; Standard_NODISCARD gp_Vec Scaled (const Standard_Real S) const;
//! Transforms a vector with the transformation T. //! Transforms a vector with the transformation T.
Standard_EXPORT void Transform (const gp_Trsf& T); Standard_EXPORT void Transform (const gp_Trsf& T);
//! Transforms a vector with the transformation T. //! Transforms a vector with the transformation T.
gp_Vec Transformed (const gp_Trsf& T) const; Standard_NODISCARD gp_Vec Transformed (const gp_Trsf& T) const;

36
src/gp/gp_Vec2d.hxx
View File

@ -147,15 +147,15 @@ public:
} }
//! Adds two vectors //! Adds two vectors
gp_Vec2d Added (const gp_Vec2d& Other) const; Standard_NODISCARD gp_Vec2d Added (const gp_Vec2d& Other) const;
gp_Vec2d operator + (const gp_Vec2d& Other) const Standard_NODISCARD gp_Vec2d operator + (const gp_Vec2d& Other) const
{ {
return Added(Other); return Added(Other);
} }
//! Computes the crossing product between two vectors //! Computes the crossing product between two vectors
Standard_Real Crossed (const gp_Vec2d& Right) const; Standard_NODISCARD Standard_Real Crossed (const gp_Vec2d& Right) const;
Standard_Real operator ^ (const gp_Vec2d& Right) const Standard_NODISCARD Standard_Real operator ^ (const gp_Vec2d& Right) const
{ {
return Crossed(Right); return Crossed(Right);
} }
@ -177,8 +177,8 @@ public:
} }
//! divides a vector by a scalar //! divides a vector by a scalar
gp_Vec2d Divided (const Standard_Real Scalar) const; Standard_NODISCARD gp_Vec2d Divided (const Standard_Real Scalar) const;
gp_Vec2d operator / (const Standard_Real Scalar) const Standard_NODISCARD gp_Vec2d operator / (const Standard_Real Scalar) const
{ {
return Divided(Scalar); return Divided(Scalar);
} }
@ -201,8 +201,8 @@ public:
//! Normalizes a vector //! Normalizes a vector
//! Raises an exception if the magnitude of the vector is //! Raises an exception if the magnitude of the vector is
//! lower or equal to Resolution from package gp. //! lower or equal to Resolution from package gp.
gp_Vec2d Multiplied (const Standard_Real Scalar) const; Standard_NODISCARD gp_Vec2d Multiplied (const Standard_Real Scalar) const;
gp_Vec2d operator * (const Standard_Real Scalar) const Standard_NODISCARD gp_Vec2d operator * (const Standard_Real Scalar) const
{ {
return Multiplied(Scalar); return Multiplied(Scalar);
} }
@ -213,13 +213,13 @@ public:
//! Raises an exception if the magnitude of the vector is //! Raises an exception if the magnitude of the vector is
//! lower or equal to Resolution from package gp. //! lower or equal to Resolution from package gp.
//! Reverses the direction of a vector //! Reverses the direction of a vector
gp_Vec2d Normalized() const; Standard_NODISCARD gp_Vec2d Normalized() const;
void Reverse(); void Reverse();
//! Reverses the direction of a vector //! Reverses the direction of a vector
gp_Vec2d Reversed() const; Standard_NODISCARD gp_Vec2d Reversed() const;
gp_Vec2d operator -() const Standard_NODISCARD gp_Vec2d operator -() const
{ {
return Reversed(); return Reversed();
} }
@ -232,8 +232,8 @@ public:
} }
//! Subtracts two vectors //! Subtracts two vectors
gp_Vec2d Subtracted (const gp_Vec2d& Right) const; Standard_NODISCARD gp_Vec2d Subtracted (const gp_Vec2d& Right) const;
gp_Vec2d operator - (const gp_Vec2d& Right) const Standard_NODISCARD gp_Vec2d operator - (const gp_Vec2d& Right) const
{ {
return Subtracted(Right); return Subtracted(Right);
} }
@ -265,7 +265,7 @@ public:
//! Performs the symmetrical transformation of a vector //! Performs the symmetrical transformation of a vector
//! with respect to the vector V which is the center of //! with respect to the vector V which is the center of
//! the symmetry. //! the symmetry.
Standard_EXPORT gp_Vec2d Mirrored (const gp_Vec2d& V) const; Standard_EXPORT Standard_NODISCARD gp_Vec2d Mirrored (const gp_Vec2d& V) const;
//! Performs the symmetrical transformation of a vector //! Performs the symmetrical transformation of a vector
@ -277,24 +277,24 @@ public:
//! Performs the symmetrical transformation of a vector //! Performs the symmetrical transformation of a vector
//! with respect to an axis placement which is the axis //! with respect to an axis placement which is the axis
//! of the symmetry. //! of the symmetry.
Standard_EXPORT gp_Vec2d Mirrored (const gp_Ax2d& A1) const; Standard_EXPORT Standard_NODISCARD gp_Vec2d Mirrored (const gp_Ax2d& A1) const;
void Rotate (const Standard_Real Ang); void Rotate (const Standard_Real Ang);
//! Rotates a vector. Ang is the angular value of the //! Rotates a vector. Ang is the angular value of the
//! rotation in radians. //! rotation in radians.
gp_Vec2d Rotated (const Standard_Real Ang) const; Standard_NODISCARD gp_Vec2d Rotated (const Standard_Real Ang) const;
void Scale (const Standard_Real S); void Scale (const Standard_Real S);
//! Scales a vector. S is the scaling value. //! Scales a vector. S is the scaling value.
gp_Vec2d Scaled (const Standard_Real S) const; Standard_NODISCARD gp_Vec2d Scaled (const Standard_Real S) const;
Standard_EXPORT void Transform (const gp_Trsf2d& T); Standard_EXPORT void Transform (const gp_Trsf2d& T);
//! Transforms a vector with a Trsf from gp. //! Transforms a vector with a Trsf from gp.
gp_Vec2d Transformed (const gp_Trsf2d& T) const; Standard_NODISCARD gp_Vec2d Transformed (const gp_Trsf2d& T) const;

32
src/gp/gp_XY.hxx
View File

@ -109,16 +109,16 @@ public:
//! Computes the sum of this number pair and number pair Other //! Computes the sum of this number pair and number pair Other
//! new.X() = <me>.X() + Other.X() //! new.X() = <me>.X() + Other.X()
//! new.Y() = <me>.Y() + Other.Y() //! new.Y() = <me>.Y() + Other.Y()
gp_XY Added (const gp_XY& Other) const; Standard_NODISCARD gp_XY Added (const gp_XY& Other) const;
gp_XY operator + (const gp_XY& Other) const Standard_NODISCARD gp_XY operator + (const gp_XY& Other) const
{ {
return Added(Other); return Added(Other);
} }
//! Real D = <me>.X() * Other.Y() - <me>.Y() * Other.X() //! Real D = <me>.X() * Other.Y() - <me>.Y() * Other.X()
Standard_Real Crossed (const gp_XY& Right) const; Standard_NODISCARD Standard_Real Crossed (const gp_XY& Right) const;
Standard_Real operator ^ (const gp_XY& Right) const Standard_NODISCARD Standard_Real operator ^ (const gp_XY& Right) const
{ {
return Crossed(Right); return Crossed(Right);
} }
@ -141,8 +141,8 @@ public:
} }
//! Divides <me> by a real. //! Divides <me> by a real.
gp_XY Divided (const Standard_Real Scalar) const; Standard_NODISCARD gp_XY Divided (const Standard_Real Scalar) const;
gp_XY operator / (const Standard_Real Scalar) const Standard_NODISCARD gp_XY operator / (const Standard_Real Scalar) const
{ {
return Divided(Scalar); return Divided(Scalar);
} }
@ -182,8 +182,8 @@ public:
//! New.X() = <me>.X() * Scalar; //! New.X() = <me>.X() * Scalar;
//! New.Y() = <me>.Y() * Scalar; //! New.Y() = <me>.Y() * Scalar;
gp_XY Multiplied (const Standard_Real Scalar) const; Standard_NODISCARD gp_XY Multiplied (const Standard_Real Scalar) const;
gp_XY operator * (const Standard_Real Scalar) const Standard_NODISCARD gp_XY operator * (const Standard_Real Scalar) const
{ {
return Multiplied(Scalar); return Multiplied(Scalar);
} }
@ -191,11 +191,11 @@ public:
//! new.X() = <me>.X() * Other.X(); //! new.X() = <me>.X() * Other.X();
//! new.Y() = <me>.Y() * Other.Y(); //! new.Y() = <me>.Y() * Other.Y();
gp_XY Multiplied (const gp_XY& Other) const; Standard_NODISCARD gp_XY Multiplied (const gp_XY& Other) const;
//! New = Matrix * <me> //! New = Matrix * <me>
gp_XY Multiplied (const gp_Mat2d& Matrix) const; Standard_NODISCARD gp_XY Multiplied (const gp_Mat2d& Matrix) const;
gp_XY operator * (const gp_Mat2d& Matrix) const Standard_NODISCARD gp_XY operator * (const gp_Mat2d& Matrix) const
{ {
return Multiplied(Matrix); return Multiplied(Matrix);
} }
@ -210,7 +210,7 @@ public:
//! New.X() = <me>.X()/ <me>.Modulus() //! New.X() = <me>.X()/ <me>.Modulus()
//! New.Y() = <me>.Y()/ <me>.Modulus() //! New.Y() = <me>.Y()/ <me>.Modulus()
//! Raises ConstructionError if <me>.Modulus() <= Resolution from gp //! Raises ConstructionError if <me>.Modulus() <= Resolution from gp
gp_XY Normalized() const; Standard_NODISCARD gp_XY Normalized() const;
//! <me>.X() = -<me>.X() //! <me>.X() = -<me>.X()
@ -220,8 +220,8 @@ public:
//! New.X() = -<me>.X() //! New.X() = -<me>.X()
//! New.Y() = -<me>.Y() //! New.Y() = -<me>.Y()
gp_XY Reversed() const; Standard_NODISCARD gp_XY Reversed() const;
gp_XY operator -() const Standard_NODISCARD gp_XY operator -() const
{ {
return Reversed(); return Reversed();
} }
@ -262,8 +262,8 @@ public:
//! new.X() = <me>.X() - Other.X() //! new.X() = <me>.X() - Other.X()
//! new.Y() = <me>.Y() - Other.Y() //! new.Y() = <me>.Y() - Other.Y()
gp_XY Subtracted (const gp_XY& Right) const; Standard_NODISCARD gp_XY Subtracted (const gp_XY& Right) const;
gp_XY operator - (const gp_XY& Right) const Standard_NODISCARD gp_XY operator - (const gp_XY& Right) const
{ {
return Subtracted(Right); return Subtracted(Right);
} }

32
src/gp/gp_XYZ.hxx
View File

@ -129,8 +129,8 @@ public:
//! new.X() = <me>.X() + Other.X() //! new.X() = <me>.X() + Other.X()
//! new.Y() = <me>.Y() + Other.Y() //! new.Y() = <me>.Y() + Other.Y()
//! new.Z() = <me>.Z() + Other.Z() //! new.Z() = <me>.Z() + Other.Z()
gp_XYZ Added (const gp_XYZ& Other) const; Standard_NODISCARD gp_XYZ Added (const gp_XYZ& Other) const;
gp_XYZ operator + (const gp_XYZ& Other) const Standard_NODISCARD gp_XYZ operator + (const gp_XYZ& Other) const
{ {
return Added(Other); return Added(Other);
} }
@ -149,8 +149,8 @@ public:
//! new.X() = <me>.Y() * Other.Z() - <me>.Z() * Other.Y() //! new.X() = <me>.Y() * Other.Z() - <me>.Z() * Other.Y()
//! new.Y() = <me>.Z() * Other.X() - <me>.X() * Other.Z() //! new.Y() = <me>.Z() * Other.X() - <me>.X() * Other.Z()
//! new.Z() = <me>.X() * Other.Y() - <me>.Y() * Other.X() //! new.Z() = <me>.X() * Other.Y() - <me>.Y() * Other.X()
gp_XYZ Crossed (const gp_XYZ& Right) const; Standard_NODISCARD gp_XYZ Crossed (const gp_XYZ& Right) const;
gp_XYZ operator ^ (const gp_XYZ& Right) const Standard_NODISCARD gp_XYZ operator ^ (const gp_XYZ& Right) const
{ {
return Crossed(Right); return Crossed(Right);
} }
@ -171,7 +171,7 @@ public:
//! Triple vector product //! Triple vector product
//! computes New = <me>.Cross(Coord1.Cross(Coord2)) //! computes New = <me>.Cross(Coord1.Cross(Coord2))
gp_XYZ CrossCrossed (const gp_XYZ& Coord1, const gp_XYZ& Coord2) const; Standard_NODISCARD gp_XYZ CrossCrossed (const gp_XYZ& Coord1, const gp_XYZ& Coord2) const;
//! divides <me> by a real. //! divides <me> by a real.
void Divide (const Standard_Real Scalar); void Divide (const Standard_Real Scalar);
@ -181,8 +181,8 @@ public:
} }
//! divides <me> by a real. //! divides <me> by a real.
gp_XYZ Divided (const Standard_Real Scalar) const; Standard_NODISCARD gp_XYZ Divided (const Standard_Real Scalar) const;
gp_XYZ operator / (const Standard_Real Scalar) const Standard_NODISCARD gp_XYZ operator / (const Standard_Real Scalar) const
{ {
return Divided(Scalar); return Divided(Scalar);
} }
@ -228,8 +228,8 @@ public:
//! New.X() = <me>.X() * Scalar; //! New.X() = <me>.X() * Scalar;
//! New.Y() = <me>.Y() * Scalar; //! New.Y() = <me>.Y() * Scalar;
//! New.Z() = <me>.Z() * Scalar; //! New.Z() = <me>.Z() * Scalar;
gp_XYZ Multiplied (const Standard_Real Scalar) const; Standard_NODISCARD gp_XYZ Multiplied (const Standard_Real Scalar) const;
gp_XYZ operator * (const Standard_Real Scalar) const Standard_NODISCARD gp_XYZ operator * (const Standard_Real Scalar) const
{ {
return Multiplied(Scalar); return Multiplied(Scalar);
} }
@ -238,11 +238,11 @@ public:
//! new.X() = <me>.X() * Other.X(); //! new.X() = <me>.X() * Other.X();
//! new.Y() = <me>.Y() * Other.Y(); //! new.Y() = <me>.Y() * Other.Y();
//! new.Z() = <me>.Z() * Other.Z(); //! new.Z() = <me>.Z() * Other.Z();
gp_XYZ Multiplied (const gp_XYZ& Other) const; Standard_NODISCARD gp_XYZ Multiplied (const gp_XYZ& Other) const;
//! New = Matrix * <me> //! New = Matrix * <me>
gp_XYZ Multiplied (const gp_Mat& Matrix) const; Standard_NODISCARD gp_XYZ Multiplied (const gp_Mat& Matrix) const;
gp_XYZ operator * (const gp_Mat& Matrix) const Standard_NODISCARD gp_XYZ operator * (const gp_Mat& Matrix) const
{ {
return Multiplied(Matrix); return Multiplied(Matrix);
} }
@ -259,7 +259,7 @@ public:
//! New.Y() = <me>.Y()/ <me>.Modulus() //! New.Y() = <me>.Y()/ <me>.Modulus()
//! New.Z() = <me>.Z()/ <me>.Modulus() //! New.Z() = <me>.Z()/ <me>.Modulus()
//! Raised if <me>.Modulus() <= Resolution from gp //! Raised if <me>.Modulus() <= Resolution from gp
gp_XYZ Normalized() const; Standard_NODISCARD gp_XYZ Normalized() const;
//! <me>.X() = -<me>.X() //! <me>.X() = -<me>.X()
@ -271,7 +271,7 @@ public:
//! New.X() = -<me>.X() //! New.X() = -<me>.X()
//! New.Y() = -<me>.Y() //! New.Y() = -<me>.Y()
//! New.Z() = -<me>.Z() //! New.Z() = -<me>.Z()
gp_XYZ Reversed() const; Standard_NODISCARD gp_XYZ Reversed() const;
//! <me>.X() = <me>.X() - Other.X() //! <me>.X() = <me>.X() - Other.X()
@ -287,8 +287,8 @@ public:
//! new.X() = <me>.X() - Other.X() //! new.X() = <me>.X() - Other.X()
//! new.Y() = <me>.Y() - Other.Y() //! new.Y() = <me>.Y() - Other.Y()
//! new.Z() = <me>.Z() - Other.Z() //! new.Z() = <me>.Z() - Other.Z()
gp_XYZ Subtracted (const gp_XYZ& Right) const; Standard_NODISCARD gp_XYZ Subtracted (const gp_XYZ& Right) const;
gp_XYZ operator - (const gp_XYZ& Right) const Standard_NODISCARD gp_XYZ operator - (const gp_XYZ& Right) const
{ {
return Subtracted(Right); return Subtracted(Right);
} }

18
src/math/math_IntegerVector.hxx
View File

@ -132,15 +132,15 @@ public:
} }
//! returns the product of an IntegerVector by an integer value. //! returns the product of an IntegerVector by an integer value.
Standard_EXPORT math_IntegerVector Multiplied(const Standard_Integer theRight) const; Standard_EXPORT Standard_NODISCARD math_IntegerVector Multiplied(const Standard_Integer theRight) const;
math_IntegerVector operator*(const Standard_Integer theRight) const Standard_NODISCARD math_IntegerVector operator*(const Standard_Integer theRight) const
{ {
return Multiplied(theRight); return Multiplied(theRight);
} }
//! returns the product of a vector and a real value. //! returns the product of a vector and a real value.
Standard_EXPORT math_IntegerVector TMultiplied(const Standard_Integer theRight) const; Standard_EXPORT Standard_NODISCARD math_IntegerVector TMultiplied(const Standard_Integer theRight) const;
friend inline math_IntegerVector operator* (const Standard_Integer theLeft, const math_IntegerVector& theRight) friend inline math_IntegerVector operator* (const Standard_Integer theLeft, const math_IntegerVector& theRight)
{ {
@ -160,9 +160,9 @@ public:
//! adds the IntegerVector "theRight" to an IntegerVector. //! adds the IntegerVector "theRight" to an IntegerVector.
//! An exception is raised if the IntegerVectors have not the same length. //! An exception is raised if the IntegerVectors have not the same length.
//! An exception is raised if the lengths are not equal. //! An exception is raised if the lengths are not equal.
Standard_EXPORT math_IntegerVector Added(const math_IntegerVector& theRight) const; Standard_EXPORT Standard_NODISCARD math_IntegerVector Added(const math_IntegerVector& theRight) const;
math_IntegerVector operator+(const math_IntegerVector& theRight) const Standard_NODISCARD math_IntegerVector operator+(const math_IntegerVector& theRight) const
{ {
return Added(theRight); return Added(theRight);
} }
@ -199,9 +199,9 @@ public:
//! returns the inner product of 2 IntegerVectors. //! returns the inner product of 2 IntegerVectors.
//! An exception is raised if the lengths are not equal. //! An exception is raised if the lengths are not equal.
Standard_EXPORT Standard_Integer Multiplied(const math_IntegerVector& theRight) const; Standard_EXPORT Standard_NODISCARD Standard_Integer Multiplied(const math_IntegerVector& theRight) const;
Standard_Integer operator*(const math_IntegerVector& theRight) const Standard_NODISCARD Standard_Integer operator*(const math_IntegerVector& theRight) const
{ {
return Multiplied(theRight); return Multiplied(theRight);
} }
@ -225,9 +225,9 @@ public:
//! returns the subtraction of "theRight" from "me". //! returns the subtraction of "theRight" from "me".
//! An exception is raised if the IntegerVectors have not the same length. //! An exception is raised if the IntegerVectors have not the same length.
Standard_EXPORT math_IntegerVector Subtracted(const math_IntegerVector& theRight) const; Standard_EXPORT Standard_NODISCARD math_IntegerVector Subtracted(const math_IntegerVector& theRight) const;
math_IntegerVector operator-(const math_IntegerVector& theRight) const Standard_NODISCARD math_IntegerVector operator-(const math_IntegerVector& theRight) const
{ {
return Subtracted(theRight); return Subtracted(theRight);
} }

28
src/math/math_Matrix.hxx
View File

@ -170,8 +170,8 @@ void operator*= (const Standard_Real Right)
//! multiplies all the elements of a matrix by the //! multiplies all the elements of a matrix by the
//! value <Right>. //! value <Right>.
Standard_EXPORT math_Matrix Multiplied (const Standard_Real Right) const; Standard_EXPORT Standard_NODISCARD math_Matrix Multiplied (const Standard_Real Right) const;
math_Matrix operator* (const Standard_Real Right) const Standard_NODISCARD math_Matrix operator* (const Standard_Real Right) const
{ {
return Multiplied(Right); return Multiplied(Right);
} }
@ -194,7 +194,7 @@ math_Matrix operator* (const Standard_Real Right) const
//! rows of this matrix, or //! rows of this matrix, or
//! - the number of columns of matrix Right is not equal to //! - the number of columns of matrix Right is not equal to
//! the number of columns of this matrix. //! the number of columns of this matrix.
Standard_EXPORT math_Matrix TMultiplied (const Standard_Real Right) const; Standard_EXPORT Standard_NODISCARD math_Matrix TMultiplied (const Standard_Real Right) const;
friend math_Matrix operator *(const Standard_Real Left,const math_Matrix& Right); friend math_Matrix operator *(const Standard_Real Left,const math_Matrix& Right);
//! divides all the elements of a matrix by the value <Right>. //! divides all the elements of a matrix by the value <Right>.
@ -207,8 +207,8 @@ void operator/= (const Standard_Real Right)
//! divides all the elements of a matrix by the value <Right>. //! divides all the elements of a matrix by the value <Right>.
//! An exception is raised if <Right> = 0. //! An exception is raised if <Right> = 0.
Standard_EXPORT math_Matrix Divided (const Standard_Real Right) const; Standard_EXPORT Standard_NODISCARD math_Matrix Divided (const Standard_Real Right) const;
math_Matrix operator/ (const Standard_Real Right) const Standard_NODISCARD math_Matrix operator/ (const Standard_Real Right) const
{ {
return Divided(Right); return Divided(Right);
} }
@ -227,8 +227,8 @@ void operator+= (const math_Matrix& Right)
//! adds the matrix <Right> to a matrix. //! adds the matrix <Right> to a matrix.
//! An exception is raised if the dimensions are different. //! An exception is raised if the dimensions are different.
Standard_EXPORT math_Matrix Added (const math_Matrix& Right) const; Standard_EXPORT Standard_NODISCARD math_Matrix Added (const math_Matrix& Right) const;
math_Matrix operator+ (const math_Matrix& Right) const Standard_NODISCARD math_Matrix operator+ (const math_Matrix& Right) const
{ {
return Added(Right); return Added(Right);
} }
@ -251,8 +251,8 @@ void operator-= (const math_Matrix& Right)
//! Returns the result of the subtraction of <Right> from <me>. //! Returns the result of the subtraction of <Right> from <me>.
//! An exception is raised if the dimensions are different. //! An exception is raised if the dimensions are different.
Standard_EXPORT math_Matrix Subtracted (const math_Matrix& Right) const; Standard_EXPORT Standard_NODISCARD math_Matrix Subtracted (const math_Matrix& Right) const;
math_Matrix operator- (const math_Matrix& Right) const Standard_NODISCARD math_Matrix operator- (const math_Matrix& Right) const
{ {
return Subtracted(Right); return Subtracted(Right);
} }
@ -304,7 +304,7 @@ math_Matrix operator- (const math_Matrix& Right) const
//! Teturns the transposed of a matrix. //! Teturns the transposed of a matrix.
//! An exception is raised if the matrix is not a square matrix. //! An exception is raised if the matrix is not a square matrix.
Standard_EXPORT math_Matrix Transposed() const; Standard_EXPORT Standard_NODISCARD math_Matrix Transposed() const;
//! Returns the inverse of a matrix. //! Returns the inverse of a matrix.
//! Exception NotSquare is raised if the matrix is not square. //! Exception NotSquare is raised if the matrix is not square.
@ -363,16 +363,16 @@ void operator*= (const math_Matrix& Right)
//! Returns the product of 2 matrices. //! Returns the product of 2 matrices.
//! An exception is raised if the dimensions are different. //! An exception is raised if the dimensions are different.
Standard_EXPORT math_Matrix Multiplied (const math_Matrix& Right) const; Standard_EXPORT Standard_NODISCARD math_Matrix Multiplied (const math_Matrix& Right) const;
math_Matrix operator* (const math_Matrix& Right) const Standard_NODISCARD math_Matrix operator* (const math_Matrix& Right) const
{ {
return Multiplied(Right); return Multiplied(Right);
} }
//! Returns the product of a matrix by a vector. //! Returns the product of a matrix by a vector.
//! An exception is raised if the dimensions are different. //! An exception is raised if the dimensions are different.
Standard_EXPORT math_Vector Multiplied (const math_Vector& Right) const; Standard_EXPORT Standard_NODISCARD math_Vector Multiplied (const math_Vector& Right) const;
math_Vector operator* (const math_Vector& Right) const Standard_NODISCARD math_Vector operator* (const math_Vector& Right) const
{ {
return Multiplied(Right); return Multiplied(Right);
} }

28
src/math/math_Vector.hxx
View File

@ -127,7 +127,7 @@ public:
//! Exceptions //! Exceptions
//! Standard_NullValue if this vector is null (i.e. if its norm is //! Standard_NullValue if this vector is null (i.e. if its norm is
//! less than or equal to Standard_Real::RealEpsilon(). //! less than or equal to Standard_Real::RealEpsilon().
Standard_EXPORT math_Vector Normalized() const; Standard_EXPORT Standard_NODISCARD math_Vector Normalized() const;
//! Inverts this vector and assigns the result to this vector. //! Inverts this vector and assigns the result to this vector.
Standard_EXPORT void Invert(); Standard_EXPORT void Invert();
@ -156,15 +156,15 @@ public:
} }
//! returns the product of a vector and a real value. //! returns the product of a vector and a real value.
Standard_EXPORT math_Vector Multiplied(const Standard_Real theRight) const; Standard_EXPORT Standard_NODISCARD math_Vector Multiplied(const Standard_Real theRight) const;
math_Vector operator*(const Standard_Real theRight) const Standard_NODISCARD math_Vector operator*(const Standard_Real theRight) const
{ {
return Multiplied(theRight); return Multiplied(theRight);
} }
//! returns the product of a vector and a real value. //! returns the product of a vector and a real value.
Standard_EXPORT math_Vector TMultiplied(const Standard_Real theRight) const; Standard_EXPORT Standard_NODISCARD math_Vector TMultiplied(const Standard_Real theRight) const;
friend inline math_Vector operator* (const Standard_Real theLeft, const math_Vector& theRight) friend inline math_Vector operator* (const Standard_Real theLeft, const math_Vector& theRight)
{ {
@ -182,9 +182,9 @@ public:
//! divides a vector by the value "theRight". //! divides a vector by the value "theRight".
//! An exception is raised if "theRight" = 0. //! An exception is raised if "theRight" = 0.
Standard_EXPORT math_Vector Divided(const Standard_Real theRight) const; Standard_EXPORT Standard_NODISCARD math_Vector Divided(const Standard_Real theRight) const;
math_Vector operator/(const Standard_Real theRight) const Standard_NODISCARD math_Vector operator/(const Standard_Real theRight) const
{ {
return Divided(theRight); return Divided(theRight);
} }
@ -204,9 +204,9 @@ public:
//! adds the vector theRight to a vector. //! adds the vector theRight to a vector.
//! An exception is raised if the vectors have not the same length. //! An exception is raised if the vectors have not the same length.
//! An exception is raised if the lengths are not equal. //! An exception is raised if the lengths are not equal.
Standard_EXPORT math_Vector Added(const math_Vector& theRight) const; Standard_EXPORT Standard_NODISCARD math_Vector Added(const math_Vector& theRight) const;
math_Vector operator+(const math_Vector& theRight) const Standard_NODISCARD math_Vector operator+(const math_Vector& theRight) const
{ {
return Added(theRight); return Added(theRight);
} }
@ -264,16 +264,16 @@ public:
//! returns the inner product of 2 vectors. //! returns the inner product of 2 vectors.
//! An exception is raised if the lengths are not equal. //! An exception is raised if the lengths are not equal.
Standard_EXPORT Standard_Real Multiplied(const math_Vector& theRight) const; Standard_EXPORT Standard_NODISCARD Standard_Real Multiplied(const math_Vector& theRight) const;
Standard_Real operator*(const math_Vector& theRight) const Standard_NODISCARD Standard_Real operator*(const math_Vector& theRight) const
{ {
return Multiplied(theRight); return Multiplied(theRight);
} }
//! returns the product of a vector by a matrix. //! returns the product of a vector by a matrix.
Standard_EXPORT math_Vector Multiplied(const math_Matrix& theRight) const; Standard_EXPORT Standard_NODISCARD math_Vector Multiplied(const math_Matrix& theRight) const;
math_Vector operator*(const math_Matrix& theRight) const Standard_NODISCARD math_Vector operator*(const math_Matrix& theRight) const
{ {
return Multiplied(theRight); return Multiplied(theRight);
} }
@ -297,9 +297,9 @@ public:
//! returns the subtraction of "theRight" from "me". //! returns the subtraction of "theRight" from "me".
//! An exception is raised if the vectors have not the same length. //! An exception is raised if the vectors have not the same length.
Standard_EXPORT math_Vector Subtracted(const math_Vector& theRight) const; Standard_EXPORT Standard_NODISCARD math_Vector Subtracted(const math_Vector& theRight) const;
math_Vector operator-(const math_Vector& theRight) const Standard_NODISCARD math_Vector operator-(const math_Vector& theRight) const
{ {
return Subtracted(theRight); return Subtracted(theRight);
} }