From 80938cd913d0e3da6e635a91803eb7fb84beab5c Mon Sep 17 00:00:00 2001
From: Orange <orange-cpp@yandex.ru>
Date: Thu, 28 Aug 2025 23:18:36 +0300
Subject: [PATCH] Adds plane primitive generation

Implements a function to generate a plane primitive from two vertices, a direction vector, and a size, returning an array of two triangles.
---
 include/omath/3d_primitives/plane.hpp | 16 ++++++++++++++++
 source/3d_primitives/plane.cpp        | 21 +++++++++++++++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 include/omath/3d_primitives/plane.hpp
 create mode 100644 source/3d_primitives/plane.cpp

diff --git a/include/omath/3d_primitives/plane.hpp b/include/omath/3d_primitives/plane.hpp
new file mode 100644
index 0000000..62ff993
--- /dev/null
+++ b/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;
+}
diff --git a/source/3d_primitives/plane.cpp b/source/3d_primitives/plane.cpp
new file mode 100644
index 0000000..dffbe42
--- /dev/null
+++ b/source/3d_primitives/plane.cpp
@@ -0,0 +1,21 @@
+//
+// 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
+    {
+        Triangle<Vector3<float>> triangles;
+        const auto second_vertex_a = vertex_a + direction * size;
+        const auto second_vertex_b = vertex_b + direction * size;
+        return std::array
+        {
+            Triangle{second_vertex_a, vertex_a, vertex_b},
+            Triangle{second_vertex_b, vertex_b, vertex_a}
+        };
+    }
+} // namespace omath::primitives
\ No newline at end of file