From 2397384a6c819b18a891c888d99a283aef588a42 Mon Sep 17 00:00:00 2001
From: kaj dijkstra <kajdijkstra@protonmail.com>
Date: Sun, 4 Jan 2026 13:59:50 +0100
Subject: [PATCH] Added Readme

---
 README.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..51726d6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+
+
+# WebGL FFT-Inspired Wave Visualization
+
+## Overview
+
+This project is a self-contained WebGL experiment that renders an animated, ocean-like wave surface using a summed sine-wave spectrum inspired by Fast Fourier Transform principles. It demonstrates real-time vertex displacement, custom GLSL shaders, and interactive camera controls without relying on external 3D engines or frameworks.
+
+All logic is implemented directly in a single HTML file using raw WebGL.
+
+## Features
+
+* **Procedural Wave Generation**
+
+  * Multiple sine waves summed in the vertex shader
+  * Varying frequencies, amplitudes, and directions
+  * Time-based animation for continuous motion
+
+* **Wireframe Grid Surface**
+
+  * Dynamically generated grid geometry
+  * Rendered using line primitives for clarity
+  * Scalable resolution and plane size
+
+* **Custom GLSL Shaders**
+
+  * Vertex shader performs wave displacement
+  * Fragment shader applies height-based coloring
+  * No fixed-function pipeline usage
+
+* **Interactive Camera**
+
+  * Click-and-drag orbit controls
+  * Mouse wheel zoom
+  * Spherical camera positioning with limits
+
+* **Zero Build Step**
+
+  * Runs directly in the browser
+  * No bundlers, compilers, or dependencies
+  * Uses only the WebGL API
+
+## Controls
+
+* **Left mouse button + drag**: Orbit camera
+* **Mouse wheel**: Zoom in and out
+
+## File Structure
+
+* `index.html`
+  Contains:
+
+  * HTML layout and minimal styling
+  * WebGL context initialization
+  * Shader source code
+  * Geometry generation
+  * Camera math and interaction
+  * Animation loop
+
+## Technical Notes
+
+* The wave model is **FFT-inspired**, not a true FFT implementation.
+* All wave calculations are executed per-vertex on the GPU.
+* The grid resolution and wave parameters are hard-coded for clarity and experimentation.
+* Designed for readability and educational inspection rather than maximum performance.
+
+## Requirements
+
+* A modern browser with WebGL support
+* JavaScript enabled
+
+## Purpose
+
+This project serves as a lightweight rendering and shader experiment, as well as a practical test of rapid WebGL code generation and reasoning.
+
+## License
+
+MIT
\ No newline at end of file