## 🚀 అవలోకనం
**CubeEye** అనేది 3x3 రూబిక్స్ క్యూబ్లను పరిష్కరించడానికి రూపొందించబడిన అధునాతన Android అప్లికేషన్. ఇది భౌతిక క్యూబ్ను స్కాన్ చేయడానికి కంప్యూటర్ దృష్టిని ఉపయోగించుకుంటుంది మరియు దాదాపుగా సరైన కదలికలను ఉపయోగించి దాన్ని పరిష్కరించడానికి ఇంటరాక్టివ్, యానిమేటెడ్ 3D గైడ్ను అందిస్తుంది.
## ✨ ముఖ్య లక్షణాలు
### 📷 స్మార్ట్ స్కానింగ్ సిస్టమ్
* **రియల్-టైమ్ కలర్ డిటెక్షన్:** కస్టమ్ `కలర్ అనలైజర్` ద్వారా కెమెరాను ఉపయోగించి క్యూబ్ ఫేస్ రంగులను స్వయంచాలకంగా గుర్తిస్తుంది.
* **గైడెడ్ స్కానింగ్:** ఒక సహజమైన UI ఓవర్లే వినియోగదారులను అన్ని 6 ముఖాలను సరిగ్గా సంగ్రహించే ప్రక్రియ ద్వారా మార్గనిర్దేశం చేస్తుంది.
* **వాలిడేషన్ లాజిక్:** అంతర్నిర్మిత `CubeValidator` స్కాన్ చేయబడిన స్థితి కొనసాగే ముందు భౌతికంగా పరిష్కరించగలదని నిర్ధారిస్తుంది.
* **మాన్యువల్ కరెక్షన్:** లైటింగ్ పరిస్థితులు ఆటోమేటిక్ డిటెక్షన్ను ప్రభావితం చేస్తే రంగులను మాన్యువల్గా సర్దుబాటు చేయడానికి వినియోగదారులను అనుమతించే `ColorPickerDialog`ను కలిగి ఉంటుంది.
### 🧩 ఇంటెలిజెంట్ సాల్వర్
* **కోసిఎంబా అల్గోరిథం:** దాదాపుగా అనుకూలమైన పరిష్కారాలను కనుగొనడానికి ప్రసిద్ధ రెండు-దశల అల్గోరిథంను (*min2phase* లైబ్రరీ ద్వారా) అనుసంధానిస్తుంది, తరచుగా 20 కంటే తక్కువ కదలికలు అవసరం.
**వేగవంతమైన స్థానిక గణన:** నెట్వర్క్ కనెక్షన్ అవసరం లేకుండానే పరికరంలో నేరుగా సంక్లిష్టమైన స్క్రాంబుల్లను సెకన్లలో పరిష్కరిస్తుంది.
### 🎥 ఇంటరాక్టివ్ 3D గైడ్
* **3D విజువలైజేషన్:** నిజమైన క్యూబ్ స్థితిని ఖచ్చితంగా అనుకరించే పూర్తి ఇంటరాక్టివ్ 3D రెండర్ (`Cube3DView`)ని కలిగి ఉంటుంది.
**దశల వారీ యానిమేషన్:** వినియోగదారులు వారి స్వంత వేగంతో పరిష్కార కదలికలను ప్లే చేయవచ్చు, పాజ్ చేయవచ్చు మరియు స్క్రబ్ చేయవచ్చు.
## 🛠 సాంకేతిక ముఖ్యాంశాలు
* **ఆధునిక ఆండ్రాయిడ్ స్టాక్:** పూర్తిగా కోట్లిన్ మరియు జెట్ప్యాక్ కంపోజ్ (మెటీరియల్ 3) ఉపయోగించి నిర్మించబడింది.
* **రోబస్ట్ ఆర్కిటెక్చర్:** క్లీన్ ఆర్కిటెక్చర్ సూత్రాలను అనుసరిస్తుంది, MVVM నమూనాలను, డిపెండెన్సీ ఇంజెక్షన్ కోసం హిల్ట్ మరియు అసమకాలిక కార్యకలాపాల కోసం కొరౌటిన్లను ఉపయోగిస్తుంది.
* **కెమెరాఎక్స్:** ప్రత్యక్ష ప్రివ్యూ మరియు చిత్ర విశ్లేషణ కోసం స్థిరమైన మరియు సమర్థవంతమైన కెమెరా ఫౌండేషన్ను అమలు చేస్తుంది.
* **సీన్వ్యూ:** అధిక-పనితీరు గల 3D రెండరింగ్ కోసం సీన్వ్యూ లైబ్రరీని ఉపయోగిస్తుంది.
## 🐛 తెలిసిన సమస్యలు / TODOలు
* తీవ్రమైన లైటింగ్ పరిస్థితులను బాగా నిర్వహించడానికి రంగు గుర్తింపు థ్రెషోల్డ్లను ఆప్టిమైజ్ చేయండి.
* "min2phase" లైబ్రరీ (ప్రస్తుతం మాన్యువల్ సోర్స్ ఫైల్లుగా చేర్చబడింది) యొక్క ఇంటిగ్రేషన్ను ఆటోమేట్ చేయండి.
CubeEye అనేది Android కోసం ఒక అధునాతన రూబిక్స్ క్యూబ్ సాల్వర్ అప్లికేషన్.
అప్డేట్ అయినది
6 జన, 2026