README.md

# Create 3D Icon

This is a small cli tool to generate 3D icons using Blender.

> I use this side project to learn Blender with Python.

## Examples

```bash
python create-3d-icon.py examples/LogosGithubIcon.svg
```

|                         from                         |                          to                          |
| :--------------------------------------------------: | :--------------------------------------------------: |
| ![LogosGithubIcon.svg](examples/LogosGithubIcon.svg) | ![LogosGithubIcon.png](examples/LogosGithubIcon.png) |

---

```bash
python create-3d-icon.py --light-x 1 --light-strength 2 examples/LogosBlender.svg
```

|                      from                      |                       to                       |
| :--------------------------------------------: | :--------------------------------------------: |
| ![LogosBlender.svg](examples/LogosBlender.svg) | ![LogosBlender.png](examples/LogosBlender.png) |

---

```bash
python create-3d-icon.py --r 0 --g 0.1 --b 0.3 --rx 5 --rz 5 --light-x 1 --light-z -1 --light-strength 100 --thickness 2 --distance 0.6 examples/LogosGithub.svg
```

|                     from                     |                      to                      |
| :------------------------------------------: | :------------------------------------------: |
| ![LogosGithub.svg](examples/LogosGithub.svg) | ![LogosGithub.png](examples/LogosGithub.png) |

> Icons are from [SVG Logos](https://github.com/gilbarbara/logos) (CC0)

## Install

I use poetry to manage dependencies.

```bash
poetry env use 3.10
poetry install
```

You may need to install [Blender](https://www.blender.org/download/) and add it to your path.