🪐 KRONOS

Real-Time Gesture-Controlled Saturn Simulation

KRONOS is an interactive space visualization that renders a realistic Saturn with seven dynamic rings and a glowing starfield, fully controlled in real time using hand gestures captured via webcam.
It blends Three.js, custom GPU shaders, post-processing bloom, and MediaPipe hand tracking to create an immersive, futuristic UI experience.

---

✨ Features

🌌 Realistic Space Environment

• High-density procedural starfield
• Stars with three behaviors:
  • Stable stars
  • Natural blinking (twinkling)
  • Ultra-bright glowing stars (bloom-triggered)
• Deep black background for cinematic contrast

🪐 Saturn with Multi-Layer Rings

• Saturn core rendered using particle-based volumetric points
• 7 physically inspired ring layers:
  • D, C, B, A, F, G, E
• Each ring has:
  • Independent radius ranges
  • Particle density variation
  • Subtle vertical thickness

✋ Real-Time Hand Gesture Control (Webcam)

• Powered by MediaPipe Hand Landmarker
• Gesture-based interactions:
  • Rotate Saturn by moving your hand
  • Tilt angles mapped to hand position
  • Zoom in / out using finger distance (pinch gesture)
• Smooth interpolation for natural motion

💡 Advanced Visual Effects

• Custom vertex & fragment shaders
• Star-only selective bloom (UnrealBloomPass)
• Reinhard tone mapping
• Additive blending for realistic glow

---

🧠 How It Works

• Three.js handles 3D rendering and scene management
• ShaderMaterial controls star blinking, glow, and size scaling
• Post-processing pipeline ensures bloom affects only very bright stars
• MediaPipe Vision Tasks track hand landmarks in real time
• Hand data dynamically controls:
  • Planet rotation (X / Y / Z)
  • Global scale (zoom)

---

🛠️ Tech Stack

• Three.js – 3D rendering
• WebGL Shaders (GLSL) – star & particle behavior
• MediaPipe Hand Landmarker – gesture detection
• EffectComposer & UnrealBloomPass – post-processing
• JavaScript (ES Modules)
• HTML5 & Web APIs

---

🚀 Getting Started

1️⃣ Clone the Repository

git clone https://github.com/your-username/KRONOS.git
cd KRONOS

2️⃣ Run Locally

⚠️ Webcam access requires a local server

• Using VS Code Live Server
• Right click → Open with Live Server

or

python -m http.server

Then open:

http://localhost:8000

3️⃣ Allow Webcam Access

• Grant camera permission when prompted to enable hand tracking.

4️⃣ Open The Live Demo

Type the link below into your browser’s address bar to explore the live version.

jaymeen07-r.github.io/KRONOS/

---

🎮 Controls

Gesture	Action
Move hand left/right	Rotate Saturn
Move hand up/down	Tilt angle
Pinch (thumb + index)	Zoom in / out
Remove hand	Smooth idle rotation

---

📜 License

This project is licensed under the MIT License.

You are free to use, modify, and distribute with attribution.