// Created by: Kirill GAVRILOV // Copyright (c) 2013-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 NCollection_Vec2_HeaderFile #define NCollection_Vec2_HeaderFile #include // std::sqrt() #include "Standard_Dump.hxx" //! Auxiliary macros to define couple of similar access components as vector methods. //! @return 2 components by their names in specified order #define NCOLLECTION_VEC_COMPONENTS_2D(theX, theY) \ constexpr NCollection_Vec2 theX##theY() const noexcept \ { \ return NCollection_Vec2(theX(), theY()); \ } \ constexpr NCollection_Vec2 theY##theX() const noexcept \ { \ return NCollection_Vec2(theY(), theX()); \ } //! Defines the 2D-vector template. //! The main target for this class - to handle raw low-level arrays (from/to graphic driver etc.). template class NCollection_Vec2 { public: //! Returns the number of components. static constexpr int Length() noexcept { return 2; } //! Empty constructor. Construct the zero vector. constexpr NCollection_Vec2() noexcept : v{Element_t(0), Element_t(0)} { } //! Initialize ALL components of vector within specified value. explicit constexpr NCollection_Vec2(const Element_t theXY) noexcept : v{theXY, theXY} { } //! Per-component constructor. explicit constexpr NCollection_Vec2(const Element_t theX, const Element_t theY) noexcept : v{theX, theY} { } //! Conversion constructor (explicitly converts some 2-component vector with other element type //! to a new 2-component vector with the element type Element_t, //! whose elements are static_cast'ed corresponding elements of theOtherVec2 vector) //! @tparam OtherElement_t the element type of the other 2-component vector theOtherVec2 //! @param theOtherVec2 the 2-component vector that needs to be converted template explicit constexpr NCollection_Vec2(const NCollection_Vec2& theOtherVec2) noexcept : v{static_cast(theOtherVec2[0]), static_cast(theOtherVec2[1])} { } //! Assign new values to the vector. constexpr void SetValues(const Element_t theX, const Element_t theY) noexcept { v[0] = theX; v[1] = theY; } //! Alias to 1st component as X coordinate in XY. constexpr Element_t x() const noexcept { return v[0]; } //! Alias to 2nd component as Y coordinate in XY. constexpr Element_t y() const noexcept { return v[1]; } //! @return 2 components by their names in specified order (in GLSL-style) NCOLLECTION_VEC_COMPONENTS_2D(x, y) //! Alias to 1st component as X coordinate in XY. constexpr Element_t& x() noexcept { return v[0]; } //! Alias to 2nd component as Y coordinate in XY. constexpr Element_t& y() noexcept { return v[1]; } //! Check this vector with another vector for equality (without tolerance!). constexpr bool IsEqual(const NCollection_Vec2& theOther) const noexcept { return v[0] == theOther.v[0] && v[1] == theOther.v[1]; } //! Check this vector with another vector for equality (without tolerance!). constexpr bool operator==(const NCollection_Vec2& theOther) const noexcept { return IsEqual(theOther); } //! Check this vector with another vector for non-equality (without tolerance!). constexpr bool operator!=(const NCollection_Vec2& theOther) const noexcept { return !IsEqual(theOther); } //! Raw access to the data (for OpenGL exchange). constexpr const Element_t* GetData() const noexcept { return v; } constexpr Element_t* ChangeData() noexcept { return v; } constexpr operator const Element_t*() const noexcept { return v; } constexpr operator Element_t*() noexcept { return v; } //! Compute per-component summary. constexpr NCollection_Vec2& operator+=(const NCollection_Vec2& theAdd) noexcept { v[0] += theAdd.v[0]; v[1] += theAdd.v[1]; return *this; } //! Compute per-component summary. friend constexpr NCollection_Vec2 operator+(const NCollection_Vec2& theLeft, const NCollection_Vec2& theRight) noexcept { return NCollection_Vec2(theLeft.v[0] + theRight.v[0], theLeft.v[1] + theRight.v[1]); } //! Compute per-component subtraction. constexpr NCollection_Vec2& operator-=(const NCollection_Vec2& theDec) noexcept { v[0] -= theDec.v[0]; v[1] -= theDec.v[1]; return *this; } //! Compute per-component subtraction. friend constexpr NCollection_Vec2 operator-(const NCollection_Vec2& theLeft, const NCollection_Vec2& theRight) noexcept { return NCollection_Vec2(theLeft.v[0] - theRight.v[0], theLeft.v[1] - theRight.v[1]); } //! Unary -. constexpr NCollection_Vec2 operator-() const noexcept { return NCollection_Vec2(-x(), -y()); } //! Compute per-component multiplication. constexpr NCollection_Vec2& operator*=(const NCollection_Vec2& theRight) noexcept { v[0] *= theRight.v[0]; v[1] *= theRight.v[1]; return *this; } //! Compute per-component multiplication. friend constexpr NCollection_Vec2 operator*(const NCollection_Vec2& theLeft, const NCollection_Vec2& theRight) noexcept { return NCollection_Vec2(theLeft.v[0] * theRight.v[0], theLeft.v[1] * theRight.v[1]); } //! Compute per-component multiplication by scale factor. constexpr void Multiply(const Element_t theFactor) noexcept { v[0] *= theFactor; v[1] *= theFactor; } //! Compute per-component multiplication by scale factor. constexpr NCollection_Vec2 Multiplied(const Element_t theFactor) const noexcept { return NCollection_Vec2(v[0] * theFactor, v[1] * theFactor); } //! Compute component-wise minimum of two vectors. constexpr NCollection_Vec2 cwiseMin(const NCollection_Vec2& theVec) const noexcept { return NCollection_Vec2(v[0] < theVec.v[0] ? v[0] : theVec.v[0], v[1] < theVec.v[1] ? v[1] : theVec.v[1]); } //! Compute component-wise maximum of two vectors. constexpr NCollection_Vec2 cwiseMax(const NCollection_Vec2& theVec) const noexcept { return NCollection_Vec2(v[0] > theVec.v[0] ? v[0] : theVec.v[0], v[1] > theVec.v[1] ? v[1] : theVec.v[1]); } //! Compute component-wise modulus of the vector. NCollection_Vec2 cwiseAbs() const noexcept { return NCollection_Vec2(std::abs(v[0]), std::abs(v[1])); } //! Compute maximum component of the vector. constexpr Element_t maxComp() const noexcept { return v[0] > v[1] ? v[0] : v[1]; } //! Compute minimum component of the vector. constexpr Element_t minComp() const noexcept { return v[0] < v[1] ? v[0] : v[1]; } //! Compute per-component multiplication by scale factor. constexpr NCollection_Vec2& operator*=(const Element_t theFactor) noexcept { Multiply(theFactor); return *this; } //! Compute per-component division by scale factor. constexpr NCollection_Vec2& operator/=(const Element_t theInvFactor) { v[0] /= theInvFactor; v[1] /= theInvFactor; return *this; } //! Compute per-component division. constexpr NCollection_Vec2& operator/=(const NCollection_Vec2& theRight) { v[0] /= theRight.v[0]; v[1] /= theRight.v[1]; return *this; } //! Compute per-component multiplication by scale factor. constexpr NCollection_Vec2 operator*(const Element_t theFactor) const noexcept { return Multiplied(theFactor); } //! Compute per-component division by scale factor. constexpr NCollection_Vec2 operator/(const Element_t theInvFactor) const { return NCollection_Vec2(v[0] / theInvFactor, v[1] / theInvFactor); } //! Compute per-component division. friend constexpr NCollection_Vec2 operator/(const NCollection_Vec2& theLeft, const NCollection_Vec2& theRight) { return NCollection_Vec2(theLeft.v[0] / theRight.v[0], theLeft.v[1] / theRight.v[1]); } //! Computes the dot product. constexpr Element_t Dot(const NCollection_Vec2& theOther) const noexcept { return x() * theOther.x() + y() * theOther.y(); } //! Computes the vector modulus (magnitude, length). Element_t Modulus() const noexcept { return std::sqrt(x() * x() + y() * y()); } //! Computes the square of vector modulus (magnitude, length). //! This method may be used for performance tricks. constexpr Element_t SquareModulus() const noexcept { return x() * x() + y() * y(); } //! Construct DX unit vector. static constexpr NCollection_Vec2 DX() noexcept { return NCollection_Vec2(Element_t(1), Element_t(0)); } //! Construct DY unit vector. static constexpr NCollection_Vec2 DY() noexcept { return NCollection_Vec2(Element_t(0), Element_t(1)); } //! Dumps the content of me into the stream void DumpJson(Standard_OStream& theOStream, int theDepth = -1) const { (void)theDepth; OCCT_DUMP_FIELD_VALUES_NUMERICAL(theOStream, "Vec2", 2, v[0], v[1]) } private: Element_t v[2]; }; #endif // _NCollection_Vec2_H__