Cube Eye

Drew Developer

Περιγραφή παιχνιδιού

## 🚀 Επισκόπηση

**Το CubeEye** είναι μια προηγμένη εφαρμογή Android που έχει σχεδιαστεί για την επίλυση κύβων του Ρούμπικ 3x3. Αξιοποιεί την όραση υπολογιστή για να σαρώσει έναν φυσικό κύβο και παρέχει έναν διαδραστικό, κινούμενο τρισδιάστατο οδηγό για την επίλυσή του χρησιμοποιώντας σχεδόν βέλτιστες κινήσεις.

## ✨ Βασικά χαρακτηριστικά

### 📷 Έξυπνο σύστημα σάρωσης

* **Ανίχνευση χρώματος σε πραγματικό χρόνο:** Αναγνωρίζει αυτόματα τα χρώματα των προσώπων του κύβου χρησιμοποιώντας την κάμερα μέσω του προσαρμοσμένου `ColorAnalyzer`.
* **Καθοδηγούμενη σάρωση:** Μια διαισθητική επικάλυψη UI καθοδηγεί τους χρήστες στη διαδικασία σωστής λήψης και των 6 προσώπων.
* **Λογική επικύρωσης:** Το ενσωματωμένο `CubeValidator` διασφαλίζει ότι η κατάσταση σάρωσης είναι φυσικά επιλύσιμη πριν προχωρήσετε.
* **Χειροκίνητη διόρθωση:** Περιλαμβάνει ένα `ColorPickerDialog` που επιτρέπει στους χρήστες να προσαρμόζουν χειροκίνητα τα χρώματα εάν οι συνθήκες φωτισμού επηρεάζουν την αυτόματη ανίχνευση.

### 🧩 Έξυπνος Λύτης

* **Αλγόριθμος Kociemba:** Ενσωματώνει τον διάσημο Αλγόριθμο Δύο Φάσεων (μέσω της βιβλιοθήκης *min2phase*) για την εύρεση σχεδόν βέλτιστων λύσεων, που συχνά απαιτούν λιγότερες από 20 κινήσεις.
* **Γρήγορος Τοπικός Υπολογισμός:** Επιλύει πολύπλοκα προβλήματα σε δευτερόλεπτα απευθείας στη συσκευή χωρίς να χρειάζεται σύνδεση δικτύου.

### 🎥 Διαδραστικός Οδηγός 3D

* **Οπτικοποίηση 3D:** Διαθέτει μια πλήρως διαδραστική απόδοση 3D (`Cube3DView`) που μιμείται με ακρίβεια την πραγματική κατάσταση του κύβου.
* **Κίνηση βήμα προς βήμα:** Οι χρήστες μπορούν να αναπαράγουν, να παύουν και να περιηγούνται στις κινήσεις της λύσης με τον δικό τους ρυθμό.

## 🛠 Τεχνικά Χαρακτηριστικά

* **Σύγχρονο Android Stack:** Κατασκευασμένο εξ ολοκλήρου με χρήση Kotlin και Jetpack Compose (Υλικό 3).
* **Ανθεκτική Αρχιτεκτονική:** Ακολουθεί τις αρχές της Καθαρής Αρχιτεκτονικής, χρησιμοποιώντας μοτίβα MVVM, Hilt για εισαγωγή εξαρτήσεων και Coroutines για ασύγχρονες λειτουργίες.
* **CameraX:** Εφαρμόζει μια σταθερή και αποτελεσματική βάση κάμερας για ζωντανή προεπισκόπηση και ανάλυση εικόνας.
* **SceneView:** Χρησιμοποιεί τη βιβλιοθήκη SceneView για απόδοση 3D υψηλής απόδοσης.

## 🐛 Γνωστά Προβλήματα / TODOs

* Βελτιστοποίηση των ορίων ανίχνευσης χρώματος για καλύτερη διαχείριση ακραίων συνθηκών φωτισμού.
* Αυτοματοποίηση της ενσωμάτωσης της βιβλιοθήκης "min2phase" (περιλαμβάνεται προς το παρόν ως αρχεία μη αυτόματης προέλευσης).

Τι νέο υπάρχει

This is our very first release!