prog

2026-06-18 20:25:54 -05:00
parent 730a5b2b10
commit 57b2cdb9d1
111 changed files with 865 additions and 3328 deletions
@@ -0,0 +1,61 @@
+/**
+ * Copyright (c) 2026 Dominic Masters
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+#pragma once
+#include "display/mesh/mesh.h"
+#include "display/color.h"
+
+#define PLANE_VERTEX_COUNT 6
+#define PLANE_PRIMITIVE_TYPE MESH_PRIMITIVE_TYPE_TRIANGLES
+
+/** Which axis the plane's normal points along. */
+typedef enum {
+  PLANE_AXIS_XY = 0, /**< Flat in XY, normal along +Z (billboard/wall face). */
+  PLANE_AXIS_XZ = 1, /**< Flat in XZ, normal along +Y (ground/floor plane). */
+  PLANE_AXIS_YZ = 2, /**< Flat in YZ, normal along +X (side wall). */
+} planeaxis_t;
+
+extern mesh_t PLANE_MESH_SIMPLE;
+extern meshvertex_t PLANE_MESH_SIMPLE_VERTICES[PLANE_VERTEX_COUNT];
+
+/**
+ * Initializes the simple unit XZ plane mesh (ground plane) from (0,0,0) to
+ * (1,0,1).
+ *
+ * @return Error for initialization of the plane mesh.
+ */
+errorret_t planeInit();
+
+/**
+ * Buffers an axis-aligned plane into the provided vertex array.
+ * Writes PLANE_VERTEX_COUNT (6) vertices (two triangles, CCW winding).
+ *
+ * The min/max corners fully describe the plane in 3D space. The axis enum
+ * controls which dimension is treated as the "depth" (normal) axis:
+ *   PLANE_AXIS_XY: spans X and Y, depth from min[2]/max[2] (uses min[2])
+ *   PLANE_AXIS_XZ: spans X and Z, depth from min[1]/max[1] (uses min[1])
+ *   PLANE_AXIS_YZ: spans Y and Z, depth from min[0]/max[0] (uses min[0])
+ *
+ * @param vertices  Vertex array to write into (must hold PLANE_VERTEX_COUNT).
+ * @param axis      Which axis the plane's normal points along.
+ * @param min       Minimum XYZ corner.
+ * @param max       Maximum XYZ corner.
+ * @param color     Color applied to all vertices.
+ * @param uvMin     Minimum UV coordinates.
+ * @param uvMax     Maximum UV coordinates.
+ */
+void planeBuffer(
+  meshvertex_t *vertices,
+  const planeaxis_t axis,
+  const vec3 min,
+  const vec3 max
+  #if MESH_ENABLE_COLOR
+    , const color_t color
+  #endif
+  , const vec2 uvMin,
+  const vec2 uvMax
+);