|
| 1 | +# 3D Hand Tracking Demo [Shape Creator] |
| 2 | + |
| 3 | +A threejs / WebGL / MediaPipe-powered interactive demo that allows you to control create and move 3D shapes using hand gestures. |
| 4 | + |
| 5 | +<img src="demo.png"> |
| 6 | + |
| 7 | +## Demo |
| 8 | + |
| 9 | +Try the live demo: [https://collidingscopes.github.io/shape-creator-tutorial/](https://collidingscopes.github.io/shape-creator-tutorial/) |
| 10 | + |
| 11 | +## Features |
| 12 | + |
| 13 | +- **Real-time hand tracking** using MediaPipe Hands |
| 14 | +- **Left hand gesture control:** Pinch thumb and index finger to resize the 3D sphere |
| 15 | +- **Right hand interaction:** Touch the sphere with your index finger to change its color |
| 16 | +- **Responsive design** that works on desktop and mobile browsers |
| 17 | +- **Visual feedback** with color-coded hand tracking |
| 18 | + |
| 19 | +## Requirements |
| 20 | + |
| 21 | +- Modern web browser with WebGL support |
| 22 | +- Camera access |
| 23 | +- No additional software or downloads needed |
| 24 | + |
| 25 | +## Technologies |
| 26 | + |
| 27 | +- **Three.js** for 3D rendering |
| 28 | +- **MediaPipe** for hand tracking and gesture recognition |
| 29 | +- **HTML5 Canvas** for visual feedback |
| 30 | +- **JavaScript** for real-time interaction |
| 31 | + |
| 32 | +## Setup for Development |
| 33 | + |
| 34 | +```bash |
| 35 | +# Clone this repository |
| 36 | +git clone https://github.com/collidingScopes/shape-creator-tutorial |
| 37 | + |
| 38 | +# Navigate to the project directory |
| 39 | +cd shape-creator-tutorial |
| 40 | +# Serve with your preferred method (example using Python) |
| 41 | +python -m http.server |
| 42 | +``` |
| 43 | + |
| 44 | +Then navigate to `http://localhost:8000` in your browser. |
| 45 | + |
| 46 | +## License |
| 47 | + |
| 48 | +MIT License |
| 49 | + |
| 50 | +## Credits |
| 51 | + |
| 52 | +- Three.js - https://threejs.org/ |
| 53 | +- MediaPipe - https://mediapipe.dev/ |
| 54 | + |
| 55 | +## Related Projects |
| 56 | + |
| 57 | +You might also like some of my other open source projects: |
| 58 | + |
| 59 | +- [Threejs hand tracking tutorial](https://collidingScopes.github.io/threejs-handtracking-101) - Basic hand tracking setup with threejs and MediaPipe computer vision |
| 60 | +- [Particular Drift](https://collidingScopes.github.io/particular-drift) - Turn photos into flowing particle animations |
| 61 | +- [Liquid Logo](https://collidingScopes.github.io/liquid-logo) - Transform logos and icons into liquid metal animations |
| 62 | +- [Video-to-ASCII](https://collidingScopes.github.io/ascii) - Convert videos into ASCII pixel art |
| 63 | + |
| 64 | +## Contact |
| 65 | + |
| 66 | +- Instagram: [@stereo.drift](https://www.instagram.com/stereo.drift/) |
| 67 | +- Twitter/X: [@measure_plan](https://x.com/measure_plan) |
| 68 | +- Email: [stereodriftvisuals@gmail.com](mailto:stereodriftvisuals@gmail.com) |
| 69 | +- GitHub: [collidingScopes](https://github.com/collidingScopes) |
| 70 | + |
| 71 | +## Donations |
| 72 | + |
| 73 | +If you found this tool useful, feel free to buy me a coffee. |
| 74 | + |
| 75 | +My name is Alan, and I enjoy building open source software for art, animation, games, and more. This would be much appreciated during late-night coding sessions! |
| 76 | + |
| 77 | +[](https://www.buymeacoffee.com/stereoDrift) |
0 commit comments