A python library to convert text to laser. Single stroke fonts or ttf, control of position, typographic sizing, filling.
- Python 98.4%
- Makefile 1%
- Dockerfile 0.6%
| .forgejo/workflows | ||
| docs | ||
| fonts | ||
| src/pp_text2laser | ||
| tasks | ||
| tests | ||
| tools | ||
| .dockerignore | ||
| .gitignore | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| cliff.toml | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| Dockerfile.coverage | ||
| Dockerfile.lint | ||
| LICENSE | ||
| Makefile | ||
| pyproject.toml | ||
| README.md | ||
| ROADMAP.md | ||
| SECURITY.md | ||
| VERSION.txt | ||
pp-text2laser
A Python library that turns a text request into the points a laser draws.
pip install --extra-index-url https://git.interhacker.space/api/packages/protonphoton/pypi/simple pp-text2laser
from pp_text2laser import build_converter
converter = build_converter()
frame = converter.frame({"text": "Hello", "size": 120})
print(frame.code) # 200: drawn as asked
print(frame.as_dict()["body"][:3]) # [x, y, color] per point; color 0 moves with the laser off
Python 3.11 or newer. Two dependencies, pyphen and fonttools. Fonts are not included; see docs/10-START_HERE.md.
Try it
With Docker and Docker Compose:
git clone https://git.interhacker.space/protonphoton/pp-text2laser.git text2laser
cd text2laser
docker compose -f docs/examples/02-flask-redis/compose.yml up -d
Open http://localhost:20000/, type a text and press View: the page draws the points the library returns. Send writes them to Redis. To stop it:
docker compose -f docs/examples/02-flask-redis/compose.yml down
docs/examples/02-flask-redis says what it shows.
Documentation
| Page | For |
|---|---|
| 10-START_HERE | installing, a first request, the glossary |
| 20-HOW_TO_USE | every request field, the strategies, the frame and its codes |
| 30-EXTEND | how it is built; your own sink, filling, font or strategy |
| 40-TESTING | the tests, the review cases, the playground |
| 50-LIMITATIONS | what does not work |
| ADR/ | why each decision was taken |
| examples/ | runnable examples, each in its own container |
| ROADMAP, CHANGELOG | what is planned, what changed |
| CONTRIBUTING, SECURITY | contributing, reporting a vulnerability |
Working on it
Docker is the only prerequisite.
make test # the test suite
make review # the review pictures
make help # every target
Packages: https://git.interhacker.space/protonphoton/-/packages. License: GPL-3.0-or-later, see LICENSE.