Cube Eye

Drew Developer

O ovoj igri

## 🚀 Преглед

**CubeEye** је напредна Андроид апликација дизајнирана за решавање Рубикових коцки 3x3. Користи компјутерски вид за скенирање физичке коцке и пружа интерактивни, анимирани 3Д водич за њено решавање користећи скоро оптималне потезе.

## ✨ Кључне карактеристике

### 📷 Паметни систем скенирања

* **Детекција боја у реалном времену:** Аутоматски идентификује боје површина коцке помоћу камере преко прилагођеног `ColorAnalyzer`-а.
* **Вођено скенирање:** Интуитивни кориснички интерфејс води кориснике кроз процес исправног снимања свих 6 површина.
* **Логика валидације:** Уграђени `CubeValidator` осигурава да је скенирано стање физички решиво пре него што се настави.
* **Ручна корекција:** Укључује `ColorPickerDialog` који омогућава корисницима да ручно подесе боје ако услови осветљења утичу на аутоматску детекцију.

### 🧩 Интелигентни решавач

* **Коциемба алгоритам:** Интегрише познати двофазни алгоритам (преко библиотеке *min2phase*) да би пронашао скоро оптимална решења, често захтевајући мање од 20 потеза.
* **Брзо локално израчунавање:** Решава сложене проблеме за неколико секунди директно на уређају без потребе за мрежном везом.

### 🎥 Интерактивни 3Д водич

* **3Д визуелизација:** Садржи потпуно интерактивни 3Д рендер (`Cube3DView`) који тачно опонаша стање стварне коцке.
* **Корак по корак анимација:** Корисници могу да репродукују, паузирају и прегледају потезе решења својим темпом.

## 🛠 Техничке карактеристике

* **Модерни Андроид стек:** Направљен у потпуности коришћењем Kotlin-а и Jetpack Compose-а (Material 3).

* **Робустна архитектура:** Прати принципе чисте архитектуре, користећи MVVM обрасце, Hilt за убризгавање зависности и корутине за асинхроне операције.
* **CameraX:** Имплементира стабилну и ефикасну основу камере за преглед уживо и анализу слике.
* **SceneView:** Користи SceneView библиотеку за високо ефикасно 3D рендеровање.

## 🐛 Познати проблеми / Задаци

* Оптимизујте прагове детекције боја како бисте боље поднели екстремне услове осветљења.
* Аутоматизујте интеграцију библиотеке „min2phase“ (тренутно укључене као ручне изворне датотеке).

Šta je novo

This is our very first release!