Cube Eye

Drew Developer

Despre joc

## 🚀 Prezentare generală

**CubeEye** este o aplicație Android avansată, concepută pentru a rezolva cuburi Rubik de 3x3. Aceasta utilizează viziunea computerizată pentru a scana un cub fizic și oferă un ghid 3D interactiv, animat, pentru a-l rezolva folosind mișcări aproape optime.

## ✨ Caracteristici cheie

### 📷 Sistem inteligent de scanare

* **Detectare culori în timp real:** Identifică automat culorile fețelor cubului folosind camera prin intermediul funcției personalizate `ColorAnalyzer`.
* **Scanare ghidată:** O interfață intuitivă ghidează utilizatorii prin procesul de captare corectă a tuturor celor 6 fețe.
* **Logică de validare:** Funcția `CubeValidator` încorporată asigură că starea scanată este rezolvabilă fizic înainte de a continua.
* **Corecție manuală:** Include un `ColorPickerDialog` care permite utilizatorilor să ajusteze manual culorile dacă condițiile de iluminare afectează detectarea automată.

### 🧩 Rezolvator inteligent

* **Algoritmul Kociemba:** Integrează faimosul algoritm cu două faze (prin intermediul bibliotecii *min2phase*) pentru a găsi soluții aproape optime, necesitând adesea mai puțin de 20 de mutări.
* **Calcul local rapid:** Rezolvă probleme complexe în câteva secunde direct pe dispozitiv, fără a fi nevoie de o conexiune la rețea.

### 🎥 Ghid 3D interactiv

* **Vizualizare 3D:** Dispune de o randare 3D complet interactivă (`Cube3DView`) care imită cu acuratețe starea cubului real.
* **Animație pas cu pas:** Utilizatorii pot reda, întrerupe și parcurge mișcările soluției în ritmul lor propriu.

## 🛠 Caracteristici tehnice importante

* **Stiva Android modernă:** Construită în întregime folosind Kotlin și Jetpack Compose (Material 3).
* **Arhitectură robustă:** Respectă principiile Clean Architecture, utilizând modele MVVM, Hilt pentru injectarea de dependențe și Coroutine pentru operațiuni asincrone.
* **CameraX:** Implementează o bază de cameră stabilă și eficientă pentru previzualizare live și analiza imaginilor.
* **SceneView:** Utilizează biblioteca SceneView pentru randare 3D de înaltă performanță.

## 🐛 Probleme cunoscute / Lucrări de făcut

* Optimizează pragurile de detectare a culorilor pentru a gestiona mai bine condițiile de iluminare extremă.
* Automatizează integrarea bibliotecii „min2phase” (inclusă în prezent ca fișiere sursă manuale).

Noutăți

This is our very first release!