From 4bceddd4dee834cb5aa73a8e6567d89807860058 Mon Sep 17 00:00:00 2001
From: Ray <raysan5@gmail.com>
Date: Sun, 12 Jan 2025 16:19:32 +0100
Subject: [PATCH] ADDED: example: `models_tesseract`

---
 examples/models/models_tesseract_view.c   | 124 ++++++++++++++++++++++
 examples/models/models_tesseract_view.png | Bin 0 -> 18900 bytes
 2 files changed, 124 insertions(+)
 create mode 100644 examples/models/models_tesseract_view.c
 create mode 100644 examples/models/models_tesseract_view.png

diff --git a/examples/models/models_tesseract_view.c b/examples/models/models_tesseract_view.c
new file mode 100644
index 000000000..411b59497
--- /dev/null
+++ b/examples/models/models_tesseract_view.c
@@ -0,0 +1,124 @@
+/*******************************************************************************************
+*
+*   raylib [models] example - Tesseract view
+*
+*   NOTE: This example only works on platforms that support drag & drop (Windows, Linux, OSX, Html5?)
+*
+*   Example originally created with raylib 5.6-dev, last time updated with raylib 5.6-dev
+*
+*   Example licensed under an unmodified zlib/libpng license, which is an OSI-certified,
+*   BSD-like license that allows static linking with closed source software
+*
+*   Copyright (c) 2024-2025 raylib contributor (?) & Ramon Santamaria (@raysan5)
+*
+********************************************************************************************/
+
+#include "raylib.h"
+
+#include "raymath.h"
+
+//------------------------------------------------------------------------------------
+// Program main entry point
+//------------------------------------------------------------------------------------
+int main(void)
+{
+    // Initialization
+    //--------------------------------------------------------------------------------------
+    const int screenWidth = 800;
+    const int screenHeight = 450;
+
+    InitWindow(screenWidth, screenHeight, "raylib [models] example - tesseract view");
+    
+    // Define the camera to look into our 3d world
+    Camera camera = { 0 };
+    camera.position = (Vector3){ 4.0f, 4.0f, 4.0f };    // Camera position
+    camera.target = (Vector3){ 0.0f, 0.0f, 0.0f };      // Camera looking at point
+    camera.up = (Vector3){ 0.0f, 0.0f, 1.0f };          // Camera up vector (rotation towards target)
+    camera.fovy = 50.0f;                                // Camera field-of-view Y
+    camera.projection = CAMERA_PERSPECTIVE;             // Camera mode type
+
+    // Find the coordinates by setting XYZW to +-1
+    Vector4 tesseract[16] = {
+        {  1,  1,  1, 1 }, {  1,  1,  1, -1 }, 
+        {  1,  1, -1, 1 }, {  1,  1, -1, -1 },
+        {  1, -1,  1, 1 }, {  1, -1,  1, -1 }, 
+        {  1, -1, -1, 1 }, {  1, -1, -1, -1 },
+        { -1,  1,  1, 1 }, { -1,  1,  1, -1 }, 
+        { -1,  1, -1, 1 }, { -1,  1, -1, -1 },
+        { -1, -1,  1, 1 }, { -1, -1,  1, -1 }, 
+        { -1, -1, -1, 1 }, { -1, -1, -1, -1 },
+    };
+    
+    float rotation = 0.0f;
+    Vector3 transformed[16] = { 0 };
+    float wValues[16] = { 0 };
+
+    SetTargetFPS(60);               // Set our game to run at 60 frames-per-second
+    //--------------------------------------------------------------------------------------
+
+    // Main game loop
+    while (!WindowShouldClose())    // Detect window close button or ESC key
+    {
+        // Update
+        //----------------------------------------------------------------------------------
+        rotation = DEG2RAD*45.0f*GetTime();
+        
+        for (int i = 0; i < 16; i++)
+        {
+            Vector4 p = tesseract[i];
+
+            // Rotate the XW part of the vector
+            Vector2 rotXW = Vector2Rotate((Vector2){ p.x, p.w }, rotation);
+            p.x = rotXW.x;
+            p.w = rotXW.y;
+
+            // Projection from XYZW to XYZ from perspective point (0, 0, 0, 3)
+            // NOTE: Trace a ray from (0, 0, 0, 3) > p and continue until W = 0
+            float c = 3/(3 - p.w);
+            p.x = c * p.x;
+            p.y = c * p.y;
+            p.z = c * p.z;
+
+            // Split XYZ coordinate and W values later for drawing
+            transformed[i] = (Vector3){ p.x, p.y, p.z };
+            wValues[i] = p.w;
+        }
+        //----------------------------------------------------------------------------------
+
+        // Draw
+        //----------------------------------------------------------------------------------
+        BeginDrawing();
+        
+            ClearBackground(RAYWHITE);
+            
+            BeginMode3D(camera);
+                for (int i = 0; i < 16; i++)
+                {
+                    // Draw spheres to indicate the W value
+                    DrawSphere(transformed[i], fabsf(wValues[i]*0.1), RED);
+
+                    for (int j = 0; j < 16; j++)
+                    {
+                        // Two lines are connected if they differ by 1 coordinate
+                        // This way we dont have to keep an edge list
+                        Vector4 v1 = tesseract[i];
+                        Vector4 v2 = tesseract[j];
+                        int diff = (int)(v1.x == v2.x) + (int)(v1.y == v2.y) + (int)(v1.z == v2.z) + (int)(v1.w == v2.w);
+
+                        // Draw only differing by 1 coordinate and the lower index only (duplicate lines)
+                        if (diff == 3 && i < j) DrawLine3D(transformed[i], transformed[j], MAROON);
+                    }
+                }
+            EndMode3D();
+            
+        EndDrawing();
+        //----------------------------------------------------------------------------------
+    }
+
+    // De-Initialization
+    //--------------------------------------------------------------------------------------
+    CloseWindow();          // Close window and OpenGL context
+    //--------------------------------------------------------------------------------------
+
+    return 0;
+}
\ No newline at end of file
diff --git a/examples/models/models_tesseract_view.png b/examples/models/models_tesseract_view.png
new file mode 100644
index 0000000000000000000000000000000000000000..664e560b2487c0f6ef9393e4b731ffb7658b4619
GIT binary patch
literal 18900
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
DUW%+8

literal 0
HcmV?d00001