Updates project version to 3.5.0

Increments the project version number in CMakeLists.txt
from 3.4.0 to 3.5.0.

CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.26)
 
-project(omath VERSION 3.3.0 LANGUAGES CXX)
+project(omath VERSION 3.5.0 LANGUAGES CXX)
 
 include(CMakePackageConfigHelpers)
 
@@ -39,6 +39,8 @@ endif ()
 
 add_library(${PROJECT_NAME}::${PROJECT_NAME} ALIAS ${PROJECT_NAME})
 
+target_compile_definitions(${PROJECT_NAME} PUBLIC OMATH_VERSION="${PROJECT_VERSION}")
+
 if (OMATH_IMGUI_INTEGRATION)
     target_compile_definitions(${PROJECT_NAME} PUBLIC OMATH_IMGUI_INTEGRATION)
 

include/omath/3d_primitives/plane.hpp

@@ -0,0 +1,16 @@
+//
+// Created by Vlad on 8/28/2025.
+//
+
+#pragma once
+#include "omath/triangle.hpp"
+#include "omath/vector3.hpp"
+#include <array>
+
+namespace omath::primitives
+{
+    [[nodiscard]]
+    std::array<Triangle<Vector3<float>>, 2> create_plane(const Vector3<float>& vertex_a,
+                                                          const Vector3<float>& vertex_b,
+                                                          const Vector3<float>& direction, float size) noexcept;
+}

include/omath/angle.hpp

@@ -6,6 +6,7 @@
 #include "omath/angles.hpp"
 #include <algorithm>
 #include <utility>
+#include <format>
 
 namespace omath
 {
@@ -149,3 +150,17 @@ namespace omath
         }
     };
 } // namespace omath
+template<class Type, Type min, Type max, omath::AngleFlags flags>
+struct std::formatter<omath::Angle<Type, min, max, flags>> // NOLINT(*-dcl58-cpp)
+{
+    [[nodiscard]]
+    static constexpr auto parse(std::format_parse_context& ctx)
+    {
+        return ctx.begin();
+    }
+    [[nodiscard]]
+    static auto format(const omath::Angle<Type, min, max, flags>& deg, std::format_context& ctx)
+    {
+        return std::format_to(ctx.out(), "{}deg", deg.as_degrees());
+    }
+};

include/omath/color.hpp

@@ -167,3 +167,21 @@ namespace omath
 #endif
     };
 } // namespace omath
+template<>
+struct std::formatter<omath::Color> // NOLINT(*-dcl58-cpp)
+{
+    [[nodiscard]]
+    static constexpr auto parse(std::format_parse_context& ctx)
+    {
+        return ctx.begin();
+    }
+    [[nodiscard]]
+    static auto format(const omath::Color& col, std::format_context& ctx)
+    {
+        return std::format_to(ctx.out(), "[r:{}, g:{}, b:{}, a:{}]",
+            static_cast<int>(col.x * 255.f),
+            static_cast<int>(col.y * 255.f),
+            static_cast<int>(col.z * 255.f),
+            static_cast<int>(col.w * 255.f));
+    }
+};

include/omath/mat.hpp

@@ -479,4 +479,49 @@ namespace omath
                 {0.f, 0.f, -(far + near) / (far - near), -(2.f * near * far) / (far - near)},
                 {0.f, 0.f, -1.f, 0.f}};
     }
+    template<class Type = float, MatStoreType St = MatStoreType::ROW_MAJOR>
+    [[nodiscard]]
+    Mat<4, 4, Type, St> mat_ortho_left_handed(const Type left, const Type right,
+                                              const Type bottom, const Type top,
+                                              const Type near, const Type far) noexcept
+    {
+        return
+        {
+            { static_cast<Type>(2) / (right - left), 0.f,       0.f,    -(right + left) / (right - left)},
+            { 0.f,      static_cast<Type>(2) / (top - bottom),  0.f,    -(top + bottom) / (top - bottom)},
+            { 0.f,      0.f,       static_cast<Type>(2) / (far - near), -(far + near) / (far - near)    },
+            { 0.f,      0.f,       0.f,                                 1.f                             }
+        };
+    }
+    template<class Type = float, MatStoreType St = MatStoreType::ROW_MAJOR>
+    [[nodiscard]]
+    Mat<4, 4, Type, St> mat_ortho_right_handed(const Type left, const Type right,
+                                              const Type bottom, const Type top,
+                                              const Type near, const Type far) noexcept
+    {
+        return
+        {
+                { static_cast<Type>(2) / (right - left), 0.f,       0.f,     -(right + left) / (right - left)},
+                { 0.f,      static_cast<Type>(2) / (top - bottom),  0.f,     -(top + bottom) / (top - bottom)},
+                { 0.f,      0.f,       -static_cast<Type>(2) / (far - near), -(far + near) / (far - near)    },
+                { 0.f,      0.f,       0.f,                                  1.f                             }
+        };
+    }
+
 } // namespace omath
+
+template<size_t Rows, size_t Columns, class Type, omath::MatStoreType StoreType>
+struct std::formatter<omath::Mat<Rows, Columns, Type, StoreType>> // NOLINT(*-dcl58-cpp)
+{
+    using MatType = omath::Mat<Rows, Columns, Type, StoreType>;
+    [[nodiscard]]
+    static constexpr auto parse(std::format_parse_context& ctx)
+    {
+        return ctx.begin();
+    }
+    [[nodiscard]]
+    static auto format(const MatType& mat, std::format_context& ctx)
+    {
+        return std::format_to(ctx.out(), "{}", mat.to_string());
+    }
+};

include/omath/vector2.hpp

@@ -3,7 +3,9 @@
 //
 
 #pragma once
+#include "vector3.hpp"
 #include <cmath>
+#include <format>
 #include <tuple>
 
 #ifdef OMATH_IMGUI_INTEGRATION
@@ -218,7 +220,6 @@ namespace omath
         {
             return std::make_tuple(x, y);
         }
-
 #ifdef OMATH_IMGUI_INTEGRATION
         [[nodiscard]]
         ImVec2 to_im_vec2() const noexcept
@@ -233,3 +234,18 @@ namespace omath
 #endif
     };
 } // namespace omath
+
+template<class Type>
+struct std::formatter<omath::Vector2<Type>> // NOLINT(*-dcl58-cpp)
+{
+    [[nodiscard]]
+    static constexpr auto parse(std::format_parse_context& ctx)
+    {
+        return ctx.begin();
+    }
+    [[nodiscard]]
+    static auto format(const omath::Vector2<Type>& vec, std::format_context& ctx)
+    {
+        return std::format_to(ctx.out(), "[{}, {}]", vec.x, vec.y);
+    }
+};

include/omath/vector3.hpp

@@ -159,9 +159,9 @@ namespace omath
             return Vector2<Type>::length();
         }
 
-        [[nodiscard]] Type distance_to(const Vector3& vOther) const noexcept
+        [[nodiscard]] Type distance_to(const Vector3& v_other) const noexcept
         {
-            return (*this - vOther).length();
+            return (*this - v_other).length();
         }
 #endif
 
@@ -279,10 +279,8 @@ namespace omath
         }
     };
 } // namespace omath
-// ReSharper disable once CppRedundantNamespaceDefinition
-namespace std
-{
-    template<> struct hash<omath::Vector3<float>>
+
+template<> struct std::hash<omath::Vector3<float>>
 {
     std::size_t operator()(const omath::Vector3<float>& vec) const noexcept
     {
@@ -296,4 +294,18 @@ namespace std
         return hash;
     }
 };
-} // namespace std
+
+template<class Type>
+struct std::formatter<omath::Vector3<Type>> // NOLINT(*-dcl58-cpp)
+{
+    [[nodiscard]]
+    static constexpr auto parse(std::format_parse_context& ctx)
+    {
+        return ctx.begin();
+    }
+    [[nodiscard]]
+    static auto format(const omath::Vector3<Type>& vec, std::format_context& ctx)
+    {
+        return std::format_to(ctx.out(), "[{}, {}, {}]", vec.x, vec.y, vec.z);
+    }
+};

include/omath/vector4.hpp

@@ -201,3 +201,18 @@ namespace omath
 #endif
 };
 } // namespace omath
+
+template<class Type>
+struct std::formatter<omath::Vector4<Type>> // NOLINT(*-dcl58-cpp)
+{
+    [[nodiscard]]
+    static constexpr auto parse(std::format_parse_context& ctx)
+    {
+        return ctx.begin();
+    }
+    [[nodiscard]]
+    static auto format(const omath::Vector4<Type>& vec, std::format_context& ctx)
+    {
+        return std::format_to(ctx.out(), "[{}, {}, {}, {}]", vec.x, vec.y, vec.z, vec.w);
+    }
+};

source/3d_primitives/plane.cpp

@@ -0,0 +1,19 @@
+//
+// Created by Vlad on 8/28/2025.
+//
+#include "omath/3d_primitives/plane.hpp"
+
+namespace omath::primitives
+{
+    std::array<Triangle<Vector3<float>>, 2> create_plane(const Vector3<float>& vertex_a,
+                                                          const Vector3<float>& vertex_b,
+                                                          const Vector3<float>& direction, const float size) noexcept
+    {
+        const auto second_vertex_a = vertex_a + direction * size;
+        return std::array
+        {
+            Triangle{second_vertex_a, vertex_a, vertex_b},
+            Triangle{second_vertex_a, vertex_b + direction * size, vertex_b}
+        };
+    }
+} // namespace omath::primitives

tests/general/unit_test_mat.cpp

@@ -125,7 +125,7 @@ TEST_F(UnitTestMat, Clear)
 
 TEST_F(UnitTestMat, ToString)
 {
-    const std::string str = m2.to_string();
+    const std::string str = std::format("{}", m2);
     EXPECT_FALSE(str.empty());
     EXPECT_EQ(str, "[[    1.000,     2.000]\n [    3.000,     4.000]]");
 }