// 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 #include #include #include #include #include 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. gp_Pnt() {} //! Creates a point from a XYZ object. gp_Pnt(const gp_XYZ& theCoord) : coord(theCoord) { } //! Creates a point with its 3 cartesian's coordinates : theXp, theYp, theZp. gp_Pnt(const Standard_Real theXp, const Standard_Real theYp, const Standard_Real theZp) : 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}. void SetCoord(const Standard_Integer theIndex, const Standard_Real theXi) { coord.SetCoord(theIndex, theXi); } //! For this point, assigns the values theXp, theYp and theZp to its three coordinates. void SetCoord(const Standard_Real theXp, const Standard_Real theYp, const Standard_Real theZp) { coord.SetCoord(theXp, theYp, theZp); } //! Assigns the given value to the X coordinate of this point. void SetX(const Standard_Real theX) { coord.SetX(theX); } //! Assigns the given value to the Y coordinate of this point. void SetY(const Standard_Real theY) { coord.SetY(theY); } //! Assigns the given value to the Z coordinate of this point. void SetZ(const Standard_Real theZ) { coord.SetZ(theZ); } //! Assigns the three coordinates of theCoord to this point. void SetXYZ(const gp_XYZ& theCoord) { 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}. Standard_Real Coord(const Standard_Integer theIndex) const { return coord.Coord(theIndex); } //! For this point gives its three coordinates theXp, theYp and theZp. void Coord(Standard_Real& theXp, Standard_Real& theYp, Standard_Real& theZp) const { coord.Coord(theXp, theYp, theZp); } //! For this point, returns its X coordinate. Standard_Real X() const { return coord.X(); } //! For this point, returns its Y coordinate. Standard_Real Y() const { return coord.Y(); } //! For this point, returns its Z coordinate. Standard_Real Z() const { return coord.Z(); } //! For this point, returns its three coordinates as a XYZ object. const gp_XYZ& XYZ() const { return coord; } //! For this point, returns its three coordinates as a XYZ object. const gp_XYZ& Coord() const { return coord; } //! Returns the coordinates of this point. //! Note: This syntax allows direct modification of the returned value. gp_XYZ& ChangeCoord() { return coord; } //! Assigns the result of the following expression to this point //! (theAlpha*this + theBeta*theP) / (theAlpha + theBeta) void BaryCenter(const Standard_Real theAlpha, const gp_Pnt& theP, const Standard_Real 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. Standard_Boolean IsEqual(const gp_Pnt& theOther, const Standard_Real theLinearTolerance) const { return Distance(theOther) <= theLinearTolerance; } //! Computes the distance between two points. Standard_Real Distance(const gp_Pnt& theOther) const; //! Computes the square distance between two points. Standard_Real SquareDistance(const gp_Pnt& theOther) const; //! 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); //! Performs the symmetrical transformation of a point //! with respect to an axis placement which is the axis //! of the symmetry. Standard_NODISCARD Standard_EXPORT gp_Pnt Mirrored(const gp_Pnt& theP) const; Standard_EXPORT void Mirror(const gp_Ax1& theA1); //! 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). Standard_NODISCARD Standard_EXPORT gp_Pnt Mirrored(const gp_Ax1& theA1) const; Standard_EXPORT void Mirror(const gp_Ax2& theA2); //! Rotates a point. theA1 is the axis of the rotation. //! theAng is the angular value of the rotation in radians. Standard_NODISCARD Standard_EXPORT gp_Pnt Mirrored(const gp_Ax2& theA2) const; void Rotate(const gp_Ax1& theA1, const Standard_Real theAng); Standard_NODISCARD gp_Pnt Rotated(const gp_Ax1& theA1, const Standard_Real theAng) const { gp_Pnt aP = *this; aP.Rotate(theA1, theAng); return aP; } //! Scales a point. theS is the scaling value. void Scale(const gp_Pnt& theP, const Standard_Real theS); Standard_NODISCARD gp_Pnt Scaled(const gp_Pnt& theP, const Standard_Real theS) const { 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); Standard_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. void Translate(const gp_Vec& theV); Standard_NODISCARD gp_Pnt Translated(const gp_Vec& theV) const; //! Translates a point from the point theP1 to the point theP2. void Translate(const gp_Pnt& theP1, const gp_Pnt& theP2) { coord.Add(theP2.coord); coord.Subtract(theP1.coord); } Standard_NODISCARD gp_Pnt Translated(const gp_Pnt& theP1, const gp_Pnt& theP2) const { 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, Standard_Integer theDepth = -1) const; //! Inits the content of me from the stream Standard_EXPORT Standard_Boolean InitFromJson(const Standard_SStream& theSStream, Standard_Integer& theStreamPos); private: gp_XYZ coord; }; namespace std { template <> struct hash { size_t operator()(const gp_Pnt& thePnt) const noexcept { union { Standard_Real R[3]; Standard_Integer 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 (Abs(thePnt1.X() - thePnt2.X()) > Epsilon(thePnt2.X())) return false; if (Abs(thePnt1.Y() - thePnt2.Y()) > Epsilon(thePnt2.Y())) return false; if (Abs(thePnt1.Z() - thePnt2.Z()) > Epsilon(thePnt2.Z())) return false; return true; } }; } // namespace std #include #include #include //======================================================================= // function : Distance // purpose : //======================================================================= inline Standard_Real gp_Pnt::Distance(const gp_Pnt& theOther) const { return sqrt(SquareDistance(theOther)); } //======================================================================= // function : SquareDistance // purpose : //======================================================================= inline Standard_Real gp_Pnt::SquareDistance(const gp_Pnt& theOther) const { const gp_XYZ& aXYZ = theOther.coord; const Standard_Real aDx = coord.X() - aXYZ.X(); const Standard_Real aDy = coord.Y() - aXYZ.Y(); const Standard_Real aDz = coord.Z() - aXYZ.Z(); return aDx * aDx + aDy * aDy + aDz * aDz; } //======================================================================= // function : Rotate // purpose : //======================================================================= inline void gp_Pnt::Rotate(const gp_Ax1& theA1, const Standard_Real theAng) { gp_Trsf aT; aT.SetRotation(theA1, theAng); aT.Transforms(coord); } //======================================================================= // function : Scale // purpose : //======================================================================= inline void gp_Pnt::Scale(const gp_Pnt& theP, const Standard_Real theS) { gp_XYZ aXYZ = theP.coord; aXYZ.Multiply(1.0 - theS); coord.Multiply(theS); coord.Add(aXYZ); } //======================================================================= // function : Translate // purpose : //======================================================================= inline void gp_Pnt::Translate(const gp_Vec& theV) { coord.Add(theV.XYZ()); } //======================================================================= // function : Translated // purpose : //======================================================================= inline gp_Pnt gp_Pnt::Translated(const gp_Vec& theV) const { gp_Pnt aP = *this; aP.coord.Add(theV.XYZ()); return aP; } #endif // _gp_Pnt_HeaderFile