Cube Eye

Drew Developer

Joko honi buruz

## 🚀 Orokorra

**CubeEye** 3x3 Rubik kuboak ebazteko diseinatutako Android aplikazio aurreratu bat da. Ikusmen artifiziala erabiltzen du kubo fisiko bat eskaneatzeko eta 3D gida interaktibo eta animatu bat eskaintzen du mugimendu ia optimoak erabiliz ebazteko.

## ✨ Ezaugarri nagusiak

### 📷 Eskaneatze sistema adimenduna

* **Koloreen detekzioa denbora errealean:** Kuboaren aurpegien koloreak automatikoki identifikatzen ditu kamera erabiliz, `ColorAnalyzer` pertsonalizatuaren bidez.
* **Eskaneatzea gidatua:** UI gainjarri intuitibo batek erabiltzaileak gidatzen ditu 6 aurpegiak behar bezala harrapatzeko prozesuan.
* **Balidazio logika:** Barneratutako `CubeValidator`-ek eskaneatutako egoera fisikoki ebazteko modukoa dela ziurtatzen du jarraitu aurretik.
* **Eskuzko zuzenketa:** `ColorPickerDialog` bat barne hartzen du, erabiltzaileei koloreak eskuz doitzeko aukera emanez, argiztapen baldintzek detekzio automatikoan eragina badute.

### 🧩 Ebazle Adimenduna

* **Kociemba Algoritmoa:** Bi Faseko Algoritmo ospetsua integratzen du (*min2phase* liburutegiaren bidez) ia optimoak diren irtenbideak aurkitzeko, askotan 20 mugimendu baino gutxiago behar izaten dituztenak.
* **Tokiko Kalkulu Azkarra:** Nahasketa konplexuak segundotan ebazten ditu zuzenean gailuan, sareko konexiorik behar izan gabe.

### 🎥 3D Gida Interaktiboa

* **3D Bistaratze:** Kubo errealaren egoera zehatz-mehatz imitatzen duen 3D errendatze guztiz interaktiboa du (`Cube3DView`).
* **Pausoz Pausoko Animazioa:** Erabiltzaileek irtenbide mugimenduak erreproduzitu, pausatu eta arakatu ditzakete beren erritmoan.

## 🛠 Ezaugarri Tekniko Nabarmenak

* **Android Stack Modernoa:** Kotlin eta Jetpack Compose (Material 3) erabiliz eraikia.

* **Arkitektura sendoa:** Arkitektura garbiaren printzipioak jarraitzen ditu, MVVM ereduak erabiliz, Hilt mendekotasunen injekziorako eta Koroutinak eragiketa asinkronoetarako.
* **CameraX:** Kamera oinarri egonkor eta eraginkorra ezartzen du zuzeneko aurrebista eta irudien analisietarako.
* **SceneView:** SceneView liburutegia erabiltzen du 3D errendatze errendimendu handikoa lortzeko.

## 🐛 Arazo ezagunak / Egitekoak

* Koloreen detekzio atalaseak optimizatu muturreko argiztapen baldintzak hobeto kudeatzeko.
* "min2phase" liburutegiaren integrazioa automatizatu (gaur egun eskuzko iturburu fitxategi gisa sartuta).

Berritasunak

This is our very first release!