https://github.com/nathanielfernandes/imagetext-py
A blazing fast text drawing library
https://github.com/nathanielfernandes/imagetext-py
drawing emoji-support emojis font fonts image pyo3 rust-bindings text text-drawing
Last synced: 5 months ago
JSON representation
A blazing fast text drawing library
- Host: GitHub
- URL: https://github.com/nathanielfernandes/imagetext-py
- Owner: nathanielfernandes
- License: mit
- Created: 2023-01-18T22:28:55.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T17:25:37.000Z (about 2 years ago)
- Last Synced: 2025-12-31T10:31:30.074Z (6 months ago)
- Topics: drawing, emoji-support, emojis, font, fonts, image, pyo3, rust-bindings, text, text-drawing
- Language: Rust
- Homepage: https://pypi.org/project/imagetext-py/
- Size: 335 KB
- Stars: 82
- Watchers: 2
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
### A blazing fast text drawing library
###### imagetext-py is python bindings for [imagetext](https://github.com/nathanielfernandes/imagetext)
[](https://pypi.org/project/imagetext-py/)
[](https://pepy.tech/project/imagetext-py)
[](https://discord.gg/e4T2qycHJz)
---
> if you found this library useful, consider leaving a star ⭐
## About
imagetext makes use of [rusttype](https://github.com/redox-os/rusttype) for font parsing and [tiny-skia](https://github.com/RazrFalcon/tiny-skia) for drawing. It has a simple API that allows you to draw text with ease.
Currently imagetext-py does beat out Pillow for most of the cases I've tested, but I will setup some benchmarks soon.
## Features
- Multi-line text
- Text wrapping
- Text alignment
- Font fallbacks
- Text stroke
- Gradient fills
- Emojis! (almost every platform supported, including discord)
- Global Font Database with css-like font querying
> Note: emojis are fetched and cached from the internet during runtime, so you will need an internet connection to use them. The ability to use local emoji images will be added soon.
## Installation
```bash
pip install imagetext-py
```
## Example Usage
```python
from PIL import Image
from imagetext_py import *
# supports fonts with fallbacks
FontDB.LoadFromDir(".")
font = FontDB.Query("coolvetica japanese")
# create a canvas to draw on
cv = Canvas(512, 512, (255, 255, 255, 255))
# paints are used to fill and stroke text
black = Paint.Color((0, 0, 0, 255))
rainbow = Paint.Rainbow((0.0,0.0), (256.0,256.0))
# if a font doesn't have a glyph for a character, it will use the fallbacks
text = "hello my 😓 n🐢ame i☕s 会のすべ aての構成員 nathan and i drink soup boop coop, the quick brown fox jumps over the lazy dog"
draw_text_wrapped(canvas=cv, # the canvas to draw on
text=text,
x=256, y=256, # the position of the text
ax=0.5, ay=0.5, # the anchor of the text
size=67, # the size of the text
width=500, # the width of the text
font=font,
fill=black,
align=TextAlign.Center,
stroke=2.0, # the stroke width (optional)
stroke_color=rainbow,
draw_emojis=True) # the stroke color (optional)
# you can convert the canvas to a PIL image
im: Image.Image = cv.to_image()
im.save("test.png")
# or you can just get the raw bytes
dimensions, bytes = cv.to_bytes()
# you can also save directly to a file
cv.save("test.png")
```
produces this image:
## Pillow and FontDB Usage
```python
from PIL import Image
from imagetext_py import *
FontDB.SetDefaultEmojiOptions(EmojiOptions(parse_discord_emojis=True))
FontDB.LoadFromDir(".")
font = FontDB.Query("coolvetica japanese")
with Image.new("RGBA", (512, 512), "white") as im:
with Writer(im) as w:
w.draw_text_wrapped(
text="hello from python 😓 lol, <:blobpain:739614945045643447> " \
"ほまみ <:chad:682819256173461522><:bigbrain:744344773229543495> " \
"emojis workin",
x=256, y=256,
ax=0.5, ay=0.5,
width=500,
size=90,
font=font,
fill=Paint.Color((0, 0, 0, 255)),
align=TextAlign.Center,
stroke=2.0,
stroke_color=Paint.Rainbow((0.0,0.0), (256.0,256.0)),
draw_emojis=True
)
im.save("test.png")
```
produces this image:
