https://github.com/lemonyte/turtle-drawer
Draw SVG images with Python's Turtle library.
https://github.com/lemonyte/turtle-drawer
draw drawing pyinstaller python svg turtle
Last synced: about 1 year ago
JSON representation
Draw SVG images with Python's Turtle library.
- Host: GitHub
- URL: https://github.com/lemonyte/turtle-drawer
- Owner: lemonyte
- License: mit
- Created: 2022-03-14T01:48:06.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-14T05:10:43.000Z (over 3 years ago)
- Last Synced: 2025-02-02T08:27:43.916Z (over 1 year ago)
- Topics: draw, drawing, pyinstaller, python, svg, turtle
- Language: Python
- Homepage:
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license.txt
Awesome Lists containing this project
README
# Turtle Drawer
Draw SVG images using Python's Turtle library.
## Requirements
### Python File
- [Python 3.9](https://www.python.org/downloads/) or higher
- Packages listed in [`requirements.txt`](requirements.txt)
### Windows Systems
Optional executable file for Windows users. Python and the required packages are included in the executable.
- 36 MB of free space for the executable
- 45 MB of free space for temporary files
## Usage
Download the executable file `turtle_drawer.exe` from the [latest release](https://github.com/lemonyte/turtle-drawer/releases/latest). If you are not using Windows, download the source code and use the Python file.
### Preparing an Image
First, choose a regular image to draw. Simple 2D images like clipart vectorize best. Once you have an image, go to and convert it to an SVG image. Save the SVG image on your computer. You may also use an SVG image from another source, but keep in mind this program is meant to be used with SVG images in the format provided by , and not all SVG images are in this format. To start drawing, run the program from a terminal.
Command syntax:
```bash
./turtle_drawer.exe [-h] [-l] [-q QUALITY] [-n N] image_path
```
### Options
Option|Parameters|Default|Description
--|--|--|--
`-h`, `--help`|None|None|Show this help message
`-l`, `--loop`|None|`False`|Continuously draw and erase the image on repeat
`-q`, `--quality`|Integer|`1`|Set the quality of the drawing, lower value equals higher quality
`-n`|Integer|`1`|Number of actions before a screen update is called, higher value equals faster drawing. Set to `0` for instant drawing. See the [Turtle docs](https://docs.python.org/3/library/turtle.html#turtle.tracer)
Example:
```bash
./turtle_drawer.exe -l -q 8 -n 1000 path/to/image.svg
```
If you are using the Python file, replace `./turtle_drawer.exe` with `python turtle_drawer.py`. When run, the program will take some time to first unpack all the necessary resources if the `.exe` file is being used, and then parse the SVG image. The time it takes to parse and draw the image depends on the complexity of the image and the performance of your system. Experiment with the `-n` option to find a value that works well. For complex images a value of `100` or greater is recommended.
## License
[MIT License](license.txt)