README.md

3D Image Vectorizer

🚀 3D Image Vectorizer is an open-source tool that transforms raster images into scalable 3D vector graphics using Three.js and Vite. This project demonstrates real-time image processing, depth mapping, and smooth vectorization in a browser.

🔗 Read the full article: JSDev Space

✨ Features

• 📂 Upload raster images (PNG, JPG, etc.).
• 🎨 Convert images into 3D vector graphics using WebGL.
• 💾 Download vectorized images as PNG.
• ⚡ Fast and efficient rendering with Three.js.
• 🎯 Built with TypeScript, Vite, and Tailwind CSS.

📦 Installation

1️⃣ Clone the repository

git clone https://github.com/yourusername/3d-image-vectorizer.git
cd 3d-image-vectorizer

2️⃣ Install dependencies

npm install

3️⃣ Run the development server

npm run dev

Open http://localhost:5173 in your browser.

🚀 Build for Production

To create an optimized build, run:

npm run build

Then serve the production build with:

npm run preview

📜 Usage

1. Click the "Upload Image" button to select an image.
2. The image will be vectorized into a 3D representation.
3. Use the mouse to rotate and zoom the vectorized model.
4. Click "Download" to save the processed image.

🛠️ Technologies Used

• Three.js – 3D rendering engine.
• Vite – Fast development server.
• TypeScript – Type-safe JavaScript.
• Tailwind CSS – Utility-first styling.

📄 License

This project is licensed under the MIT License.

👨‍💻 Contributions are welcome! Feel free to submit issues and pull requests.

🔥 Star this repo if you find it useful! ⭐