Cube Eye

Drew Developer‏

מידע על משחק זה

## 🚀 סקירה כללית

**CubeEye** היא אפליקציית אנדרואיד מתקדמת שנועדה לפתור קוביות רוביק 3x3. היא ממנפת ראייה ממוחשבת כדי לסרוק קובייה פיזית ומספקת מדריך תלת-ממדי מונפש אינטראקטיבי לפתרון באמצעות מהלכים כמעט אופטימליים.

## ✨ תכונות עיקריות

### 📷 מערכת סריקה חכמה

* **זיהוי צבעים בזמן אמת:** מזהה אוטומטית את צבעי הפנים של הקובייה באמצעות המצלמה באמצעות `ColorAnalyzer` המותאם אישית.
* **סריקה מודרכת:** שכבת-על אינטואיטיבית של ממשק משתמש מנחה את המשתמשים בתהליך לכידת כל 6 הפנים בצורה נכונה.
* **לוגיקת אימות:** ה-`CubeValidator` המובנה מבטיח שהמצב הסרוק ניתן לפתרון פיזית לפני שתמשיך.
* **תיקון ידני:** כולל `ColorPickerDialog` המאפשר למשתמשים להתאים צבעים באופן ידני אם תנאי התאורה משפיעים על הזיהוי האוטומטי.

### 🧩 פותר חכם

* **אלגוריתם קוצ'מבה:** משלב את אלגוריתם הדו-פאזי המפורסם (דרך ספריית *min2phase*) כדי למצוא פתרונות כמעט אופטימליים, שלעתים קרובות דורשים פחות מ-20 מהלכים.
* **חישוב מקומי מהיר:** פותר בעיות מורכבות תוך שניות ישירות במכשיר ללא צורך בחיבור רשת.

### 🎥 מדריך תלת-ממדי אינטראקטיבי

* **ויזואליזציה תלת-ממדית:** כולל רינדור תלת-ממדי אינטראקטיבי לחלוטין (`Cube3DView`) המחקה במדויק את מצב הקובייה האמיתית.

* **אנימציה שלב אחר שלב:** משתמשים יכולים להפעיל, להשהות ולעבור על מהלכי הפתרון בקצב שלהם.

## 🛠 נקודות עיקריות טכניות

* **מודרני אנדרואיד סטאק:** בנוי כולו באמצעות Kotlin ו-Jetpack Compose (חומר 3).

* **ארכיטקטורה חזקה:** פועלת לפי עקרונות ארכיטקטורה נקייה, תוך שימוש בתבניות MVVM, Hilt להזרקת תלויות ו-Coroutines לפעולות אסינכרוניות.
* **CameraX:** מיישם בסיס מצלמה יציב ויעיל לתצוגה מקדימה חיה וניתוח תמונה.
* **SceneView:** משתמש בספריית SceneView לרינדור תלת-ממדי בעל ביצועים גבוהים.

## 🐛 בעיות ידועות / משימות לביצועים

* אופטימיזציה של ספי זיהוי צבעים להתמודדות טובה יותר עם תנאי תאורה קיצוניים.
* אוטומציה של שילוב ספריית "min2phase" (הכלולה כעת כקבצי מקור ידניים).

מה חדש?

This is our very first release!