## 🚀 ਸੰਖੇਪ ਜਾਣਕਾਰੀ
**CubeEye** ਇੱਕ ਉੱਨਤ ਐਂਡਰਾਇਡ ਐਪਲੀਕੇਸ਼ਨ ਹੈ ਜੋ 3x3 ਰੂਬਿਕਸ ਕਿਊਬਸ ਨੂੰ ਹੱਲ ਕਰਨ ਲਈ ਤਿਆਰ ਕੀਤੀ ਗਈ ਹੈ। ਇਹ ਇੱਕ ਭੌਤਿਕ ਕਿਊਬ ਨੂੰ ਸਕੈਨ ਕਰਨ ਲਈ ਕੰਪਿਊਟਰ ਵਿਜ਼ਨ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ ਅਤੇ ਲਗਭਗ ਅਨੁਕੂਲ ਚਾਲਾਂ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਇਸਨੂੰ ਹੱਲ ਕਰਨ ਲਈ ਇੱਕ ਇੰਟਰਐਕਟਿਵ, ਐਨੀਮੇਟਡ 3D ਗਾਈਡ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ।
## ✨ ਮੁੱਖ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ
### 📷 ਸਮਾਰਟ ਸਕੈਨਿੰਗ ਸਿਸਟਮ
* **ਰੀਅਲ-ਟਾਈਮ ਰੰਗ ਖੋਜ:** ਕਸਟਮ `ਕਲਰ ਐਨਾਲਾਈਜ਼ਰ` ਰਾਹੀਂ ਕੈਮਰੇ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਘਣ ਚਿਹਰੇ ਦੇ ਰੰਗਾਂ ਦੀ ਸਵੈਚਲਿਤ ਤੌਰ 'ਤੇ ਪਛਾਣ ਕਰਦਾ ਹੈ।
* **ਗਾਈਡਡ ਸਕੈਨਿੰਗ:** ਇੱਕ ਅਨੁਭਵੀ UI ਓਵਰਲੇਅ ਉਪਭੋਗਤਾਵਾਂ ਨੂੰ ਸਾਰੇ 6 ਚਿਹਰਿਆਂ ਨੂੰ ਸਹੀ ਢੰਗ ਨਾਲ ਕੈਪਚਰ ਕਰਨ ਦੀ ਪ੍ਰਕਿਰਿਆ ਵਿੱਚ ਮਾਰਗਦਰਸ਼ਨ ਕਰਦਾ ਹੈ।
* **ਵੈਲੀਡੇਸ਼ਨ ਲਾਜਿਕ:** ਬਿਲਟ-ਇਨ `ਕਿਊਬਵੈਲੀਡੇਟਰ` ਇਹ ਯਕੀਨੀ ਬਣਾਉਂਦਾ ਹੈ ਕਿ ਸਕੈਨ ਕੀਤੀ ਸਥਿਤੀ ਅੱਗੇ ਵਧਣ ਤੋਂ ਪਹਿਲਾਂ ਭੌਤਿਕ ਤੌਰ 'ਤੇ ਹੱਲ ਕਰਨ ਯੋਗ ਹੈ।
* **ਮੈਨੂਅਲ ਸੁਧਾਰ:** ਇੱਕ `ਕਲਰਪਿਕਰਡਾਇਆਲੌਗ` ਸ਼ਾਮਲ ਹੈ ਜੋ ਉਪਭੋਗਤਾਵਾਂ ਨੂੰ ਰੰਗਾਂ ਨੂੰ ਹੱਥੀਂ ਐਡਜਸਟ ਕਰਨ ਦੀ ਆਗਿਆ ਦਿੰਦਾ ਹੈ ਜੇਕਰ ਰੋਸ਼ਨੀ ਦੀਆਂ ਸਥਿਤੀਆਂ ਆਟੋਮੈਟਿਕ ਖੋਜ ਨੂੰ ਪ੍ਰਭਾਵਤ ਕਰਦੀਆਂ ਹਨ।
### 🧩 ਬੁੱਧੀਮਾਨ ਹੱਲਕਰਤਾ
* **ਕੋਸੀਂਬਾ ਐਲਗੋਰਿਦਮ:** ਨੇੜੇ-ਅਨੁਕੂਲ ਹੱਲ ਲੱਭਣ ਲਈ ਮਸ਼ਹੂਰ ਦੋ-ਪੜਾਅ ਐਲਗੋਰਿਦਮ (*min2phase* ਲਾਇਬ੍ਰੇਰੀ ਰਾਹੀਂ) ਨੂੰ ਏਕੀਕ੍ਰਿਤ ਕਰਦਾ ਹੈ, ਜਿਸ ਲਈ ਅਕਸਰ 20 ਤੋਂ ਘੱਟ ਚਾਲਾਂ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।
* **ਤੇਜ਼ ਸਥਾਨਕ ਗਣਨਾ:** ਬਿਨਾਂ ਨੈੱਟਵਰਕ ਕਨੈਕਸ਼ਨ ਦੀ ਲੋੜ ਦੇ ਡਿਵਾਈਸ 'ਤੇ ਸਿੱਧੇ ਸਕਿੰਟਾਂ ਵਿੱਚ ਗੁੰਝਲਦਾਰ ਸਕ੍ਰੈਂਬਲਾਂ ਨੂੰ ਹੱਲ ਕਰਦਾ ਹੈ।
### 🎥 ਇੰਟਰਐਕਟਿਵ 3D ਗਾਈਡ
* **3D ਵਿਜ਼ੂਅਲਾਈਜ਼ੇਸ਼ਨ:** ਇੱਕ ਪੂਰੀ ਤਰ੍ਹਾਂ ਇੰਟਰਐਕਟਿਵ 3D ਰੈਂਡਰ (`Cube3DView`) ਦੀ ਵਿਸ਼ੇਸ਼ਤਾ ਹੈ ਜੋ ਅਸਲ ਘਣ ਦੀ ਸਥਿਤੀ ਦੀ ਸਹੀ ਨਕਲ ਕਰਦਾ ਹੈ।
* **ਕਦਮ-ਦਰ-ਕਦਮ ਐਨੀਮੇਸ਼ਨ:** ਉਪਭੋਗਤਾ ਆਪਣੀ ਗਤੀ ਨਾਲ ਹੱਲ ਚਾਲਾਂ ਨੂੰ ਚਲਾ ਸਕਦੇ ਹਨ, ਰੋਕ ਸਕਦੇ ਹਨ ਅਤੇ ਸਕ੍ਰਬ ਕਰ ਸਕਦੇ ਹਨ।
## 🛠 ਤਕਨੀਕੀ ਹਾਈਲਾਈਟਸ
* **ਆਧੁਨਿਕ ਐਂਡਰਾਇਡ ਸਟੈਕ:** ਪੂਰੀ ਤਰ੍ਹਾਂ ਕੋਟਲਿਨ ਅਤੇ ਜੈਟਪੈਕ ਕੰਪੋਜ਼ (ਮਟੀਰੀਅਲ 3) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਬਣਾਇਆ ਗਿਆ।
* **ਮਜ਼ਬੂਤ ਆਰਕੀਟੈਕਚਰ:** ਸਾਫ਼ ਆਰਕੀਟੈਕਚਰ ਸਿਧਾਂਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੈ, MVVM ਪੈਟਰਨਾਂ, ਨਿਰਭਰਤਾ ਟੀਕੇ ਲਈ Hilt, ਅਤੇ ਅਸਿੰਕ੍ਰੋਨਸ ਓਪਰੇਸ਼ਨਾਂ ਲਈ Coroutines ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ।
* **CameraX:** ਲਾਈਵ ਪ੍ਰੀਵਿਊ ਅਤੇ ਚਿੱਤਰ ਵਿਸ਼ਲੇਸ਼ਣ ਲਈ ਇੱਕ ਸਥਿਰ ਅਤੇ ਕੁਸ਼ਲ ਕੈਮਰਾ ਫਾਊਂਡੇਸ਼ਨ ਲਾਗੂ ਕਰਦਾ ਹੈ।
* **SceneView:** ਉੱਚ-ਪ੍ਰਦਰਸ਼ਨ ਵਾਲੇ 3D ਰੈਂਡਰਿੰਗ ਲਈ SceneView ਲਾਇਬ੍ਰੇਰੀ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ।
## 🐛 ਜਾਣੇ-ਪਛਾਣੇ ਮੁੱਦੇ / TODOs
* ਅਤਿਅੰਤ ਰੋਸ਼ਨੀ ਦੀਆਂ ਸਥਿਤੀਆਂ ਨੂੰ ਬਿਹਤਰ ਢੰਗ ਨਾਲ ਸੰਭਾਲਣ ਲਈ ਰੰਗ ਖੋਜ ਥ੍ਰੈਸ਼ਹੋਲਡ ਨੂੰ ਅਨੁਕੂਲ ਬਣਾਓ।
* "min2phase" ਲਾਇਬ੍ਰੇਰੀ ਦੇ ਏਕੀਕਰਨ ਨੂੰ ਸਵੈਚਾਲਤ ਕਰੋ (ਵਰਤਮਾਨ ਵਿੱਚ ਮੈਨੂਅਲ ਸਰੋਤ ਫਾਈਲਾਂ ਵਜੋਂ ਸ਼ਾਮਲ ਹੈ)।
ਅੱਪਡੇਟ ਕਰਨ ਦੀ ਤਾਰੀਖ
6 ਜਨ 2026