// Copyright (c) 1991-1999 Matra Datavision // Copyright (c) 1999-2014 OPEN CASCADE SAS // // This file is part of Open CASCADE Technology software library. // // This library is free software; you can redistribute it and/or modify it under // the terms of the GNU Lesser General Public License version 2.1 as published // by the Free Software Foundation, with special exception defined in the file // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT // distribution for complete text of the license and disclaimer of any warranty. // // Alternatively, this file may be used under the terms of Open CASCADE // commercial license or contractual agreement. #ifndef _gp_Pnt_HeaderFile #define _gp_Pnt_HeaderFile #include "Standard.hxx" #include "Standard_DefineAlloc.hxx" #include "Standard_Handle.hxx" #include "gp_XYZ.hxx" #include "Standard_Real.hxx" #include "Standard_Boolean.hxx" class gp_Ax1; class gp_Ax2; class gp_Trsf; class gp_Vec; //! Defines a 3D cartesian point. class gp_Pnt { public: DEFINE_STANDARD_ALLOC //! Creates a point with zero coordinates. constexpr gp_Pnt() noexcept = default; //! Creates a point from a XYZ object. constexpr gp_Pnt(const gp_XYZ& theCoord) noexcept : coord(theCoord) { } //! Creates a point with its 3 cartesian's coordinates: theXp, theYp, theZp. constexpr gp_Pnt(const double theXp, const double theYp, const double theZp) noexcept : coord(theXp, theYp, theZp) { } //! Changes the coordinate of range theIndex: //! theIndex = 1 => X is modified //! theIndex = 2 => Y is modified //! theIndex = 3 => Z is modified //! Raised if theIndex != {1, 2, 3}. constexpr void SetCoord(const int theIndex, const double theXi) { coord.SetCoord(theIndex, theXi); } //! For this point, assigns the values theXp, theYp and theZp to its three coordinates. constexpr void SetCoord(const double theXp, const double theYp, const double theZp) noexcept { coord.SetCoord(theXp, theYp, theZp); } //! Assigns the given value to the X coordinate of this point. constexpr void SetX(const double theX) noexcept { coord.SetX(theX); } //! Assigns the given value to the Y coordinate of this point. constexpr void SetY(const double theY) noexcept { coord.SetY(theY); } //! Assigns the given value to the Z coordinate of this point. constexpr void SetZ(const double theZ) noexcept { coord.SetZ(theZ); } //! Assigns the three coordinates of theCoord to this point. constexpr void SetXYZ(const gp_XYZ& theCoord) noexcept { coord = theCoord; } //! Returns the coordinate of corresponding to the value of theIndex : //! theIndex = 1 => X is returned //! theIndex = 2 => Y is returned //! theIndex = 3 => Z is returned //! Raises OutOfRange if theIndex != {1, 2, 3}. //! Raised if theIndex != {1, 2, 3}. constexpr double Coord(const int theIndex) const { return coord.Coord(theIndex); } //! For this point gives its three coordinates theXp, theYp and theZp. constexpr void Coord(double& theXp, double& theYp, double& theZp) const noexcept { coord.Coord(theXp, theYp, theZp); } //! For this point, returns its X coordinate. constexpr double X() const noexcept { return coord.X(); } //! For this point, returns its Y coordinate. constexpr double Y() const noexcept { return coord.Y(); } //! For this point, returns its Z coordinate. constexpr double Z() const noexcept { return coord.Z(); } //! For this point, returns its three coordinates as a XYZ object. constexpr const gp_XYZ& XYZ() const noexcept { return coord; } //! For this point, returns its three coordinates as a XYZ object. constexpr const gp_XYZ& Coord() const noexcept { return coord; } //! Returns the coordinates of this point. //! Note: This syntax allows direct modification of the returned value. constexpr gp_XYZ& ChangeCoord() noexcept { return coord; } //! Assigns the result of the following expression to this point //! (theAlpha*this + theBeta*theP) / (theAlpha + theBeta) constexpr void BaryCenter(const double theAlpha, const gp_Pnt& theP, const double theBeta) { coord.SetLinearForm(theAlpha, coord, theBeta, theP.coord); coord.Divide(theAlpha + theBeta); } //! Comparison //! Returns True if the distance between the two points is //! lower or equal to theLinearTolerance. bool IsEqual(const gp_Pnt& theOther, const double theLinearTolerance) const { return Distance(theOther) <= theLinearTolerance; } //! Computes the distance between two points. double Distance(const gp_Pnt& theOther) const; //! Computes the square distance between two points. constexpr double SquareDistance(const gp_Pnt& theOther) const noexcept; //! Performs the symmetrical transformation of a point //! with respect to the point theP which is the center of //! the symmetry. Standard_EXPORT void Mirror(const gp_Pnt& theP) noexcept; //! Performs the symmetrical transformation of a point //! with respect to an axis placement which is the axis //! of the symmetry. [[nodiscard]] Standard_EXPORT gp_Pnt Mirrored(const gp_Pnt& theP) const noexcept; Standard_EXPORT void Mirror(const gp_Ax1& theA1) noexcept; //! Performs the symmetrical transformation of a point //! with respect to a plane. The axis placement theA2 locates //! the plane of the symmetry : (Location, XDirection, YDirection). [[nodiscard]] Standard_EXPORT gp_Pnt Mirrored(const gp_Ax1& theA1) const noexcept; Standard_EXPORT void Mirror(const gp_Ax2& theA2) noexcept; //! Rotates a point. theA1 is the axis of the rotation. //! theAng is the angular value of the rotation in radians. [[nodiscard]] Standard_EXPORT gp_Pnt Mirrored(const gp_Ax2& theA2) const noexcept; void Rotate(const gp_Ax1& theA1, const double theAng); [[nodiscard]] gp_Pnt Rotated(const gp_Ax1& theA1, const double theAng) const { gp_Pnt aP = *this; aP.Rotate(theA1, theAng); return aP; } //! Scales a point. theS is the scaling value. constexpr void Scale(const gp_Pnt& theP, const double theS) noexcept; [[nodiscard]] constexpr gp_Pnt Scaled(const gp_Pnt& theP, const double theS) const noexcept { gp_Pnt aPres = *this; aPres.Scale(theP, theS); return aPres; } //! Transforms a point with the transformation T. Standard_EXPORT void Transform(const gp_Trsf& theT); [[nodiscard]] gp_Pnt Transformed(const gp_Trsf& theT) const { gp_Pnt aP = *this; aP.Transform(theT); return aP; } //! Translates a point in the direction of the vector theV. //! The magnitude of the translation is the vector's magnitude. constexpr void Translate(const gp_Vec& theV) noexcept; [[nodiscard]] constexpr gp_Pnt Translated(const gp_Vec& theV) const noexcept; //! Translates a point from the point theP1 to the point theP2. constexpr void Translate(const gp_Pnt& theP1, const gp_Pnt& theP2) noexcept { coord.Add(theP2.coord); coord.Subtract(theP1.coord); } [[nodiscard]] constexpr gp_Pnt Translated(const gp_Pnt& theP1, const gp_Pnt& theP2) const noexcept { gp_Pnt aP = *this; aP.Translate(theP1, theP2); return aP; } //! Dumps the content of me into the stream Standard_EXPORT void DumpJson(Standard_OStream& theOStream, int theDepth = -1) const; //! Inits the content of me from the stream Standard_EXPORT bool InitFromJson(const Standard_SStream& theSStream, int& theStreamPos); private: gp_XYZ coord; }; namespace std { template <> struct hash { size_t operator()(const gp_Pnt& thePnt) const noexcept { union { double R[3]; int I[6]; } U; thePnt.Coord(U.R[0], U.R[1], U.R[2]); return std::hash{}(U.I[0] / 23 + U.I[1] / 19 + U.I[2] / 17 + U.I[3] / 13 + U.I[4] / 11 + U.I[5] / 7); } }; template <> struct equal_to { bool operator()(const gp_Pnt& thePnt1, const gp_Pnt& thePnt2) const noexcept { if (std::abs(thePnt1.X() - thePnt2.X()) > Epsilon(thePnt2.X())) return false; if (std::abs(thePnt1.Y() - thePnt2.Y()) > Epsilon(thePnt2.Y())) return false; if (std::abs(thePnt1.Z() - thePnt2.Z()) > Epsilon(thePnt2.Z())) return false; return true; } }; } // namespace std #include "gp_Trsf.hxx" #include "gp_Vec.hxx" //================================================================================================= inline double gp_Pnt::Distance(const gp_Pnt& theOther) const { return sqrt(SquareDistance(theOther)); } //================================================================================================= inline constexpr double gp_Pnt::SquareDistance(const gp_Pnt& theOther) const noexcept { const gp_XYZ& aXYZ = theOther.coord; const double aDx = coord.X() - aXYZ.X(); const double aDy = coord.Y() - aXYZ.Y(); const double aDz = coord.Z() - aXYZ.Z(); return aDx * aDx + aDy * aDy + aDz * aDz; } //================================================================================================= inline void gp_Pnt::Rotate(const gp_Ax1& theA1, const double theAng) { gp_Trsf aT; aT.SetRotation(theA1, theAng); aT.Transforms(coord); } //================================================================================================= inline constexpr void gp_Pnt::Scale(const gp_Pnt& theP, const double theS) noexcept { gp_XYZ aXYZ = theP.coord; aXYZ.Multiply(1.0 - theS); coord.Multiply(theS); coord.Add(aXYZ); } //================================================================================================= inline constexpr void gp_Pnt::Translate(const gp_Vec& theV) noexcept { coord.Add(theV.XYZ()); } //================================================================================================= inline constexpr gp_Pnt gp_Pnt::Translated(const gp_Vec& theV) const noexcept { gp_Pnt aP = *this; aP.coord.Add(theV.XYZ()); return aP; } #endif // _gp_Pnt_HeaderFile