Ascii Artist
An ascii art generator that's actually good. Does edge detection and selects the most appropriate characters.
Installing
Installing with pip:
pip install asciiartist
Installing from wheel:
Download the wheel file from this project's releases and run
pip install
Quick Start
from asciiartist import asciiartist, display_edges
from PIL import Image
img = Image.open("niko.png")
art, edges = asciiartist(
img, # The image!
30, # Number of lines of the output ascii art
noise_reduction=2, # Level of noise reduction (optional)
line_weight=1, # Weight of the lines to draw (optional)
text_ratio=2.2 # Height/width ratio of each character (optional)
)
print(art) # `art` is a string u can just print
# v Display the result of edge detection.
# Good for finetuning params.
display_edges(edges)
Build from Source
Run the script ./model/model-gen.py and build the wheel with poetry build -f wheel.
How it works
Roughly, how Ascii Artist generates the drawings:
- Run edge detection
- Segment the image for each char
- Pass each segment through a CNN to get the most appropriate character.
The CNN is trained with distorted images of characters (in font consolas), created in a way that emulates the output of the edge detection.
Bye
^-^
C<4@'C`'`"-[_,/ _,L-L ," -````` ```` _-' _ _ __~`` `` "<` _ `(V\_ `V(<_ _____,,~~<7oEE(@@_Eo@@Fo, ___,-~-^```` .-.__V) ,_ ">
__=E.L__
>#-=@>@F* `<_
_/`@o
C<4@'C`'`"-[_,/ _,L-L ,"
-````` ```` _-'
_ _ __~``
`` "<` _
`(V\_
`V(<_
_____,,~~<7oEE(@@_Eo@@Fo,
___,-~-^```` .-.__V) ,_
3 Mar 12, 2022
1 Jan 28, 2022
12 Nov 8, 2022
33 Jul 6, 2022
1.1k Dec 23, 2022
380 Dec 29, 2022
12 Jul 30, 2022
1 Nov 9, 2021
6 Dec 14, 2022
220 Dec 27, 2022
193 Dec 16, 2022
979 Dec 13, 2022
137 Dec 14, 2022
176 Jan 01, 2023
1.4k Dec 26, 2022
24 Dec 20, 2022
2 Jan 09, 2022
47 Dec 25, 2022
1 Oct 27, 2021
1 Jan 09, 2022
190 Dec 21, 2022
2 Nov 23, 2021
1 Dec 16, 2022
2 Jan 01, 2022
6 Mar 31, 2022
120 Dec 20, 2022
1.5k Jan 01, 2023
3 May 16, 2022