Cube Eye

🚀 Overview

CubeEye is an advanced Android application designed to solve 3x3 Rubik's Cubes. It leverages computer vision to scan a physical cube and provides an interactive, animated 3D guide to solve it using near-optimal moves.

## ✨ Key Features

### 📷 Smart Scanning System

* Real-time Color Detection: Automatically identifies cube face colors using the camera via the custom ColorAnalyzer.
* Guided Scanning: An intuitive UI overlay guides users through the process of capturing all 6 faces correctly.
* Validation Logic: The built-in CubeValidator ensures the scanned state is physically solvable before proceeding.
* Manual Correction: Includes a ColorPickerDialog allowing users to manually adjust colors if lighting conditions affect automatic detection.

### 🧩 Intelligent Solver

* Kociemba Algorithm: Integrates the famous Two-Phase Algorithm (via the min2phase library) to find near-optimal solutions, often requiring fewer than 20 moves.
* Fast Local Computation: Solves complex scrambles in seconds directly on the device without needing a network connection.

### 🎥 Interactive 3D Guide

* 3D Visualization: Features a fully interactive 3D render (Cube3DView) that accurately mimics the real cube's state.
* Step-by-Step Animation: Users can play, pause, and scrub through the solution moves at their own pace.

## 🛠 Technical Highlights

* Modern Android Stack: Built entirely using Kotlin and Jetpack Compose (Material 3).
* Robust Architecture: Follows Clean Architecture principles, utilizing MVVM patterns, Hilt for dependency injection, and Coroutines for asynchronous operations.
* CameraX: Implements a stable and efficient camera foundation for live preview and image analysis.
* SceneView: Utilizes the SceneView library for high-performance 3D rendering.

## 🐛 Known Issues / TODOs

* Optimize color detection thresholds to better handle extreme lighting conditions.
* Automate the integration of the "min2phase" library (currently included as manual source files).