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
4 Feb 10, 2022
1 Jan 03, 2022
141 Dec 13, 2022
1 Nov 06, 2021
137 Dec 14, 2022
38 Dec 24, 2022
4 Oct 17, 2022
3 Dec 29, 2021
1 Jan 02, 2022
12 Dec 11, 2022
1 Nov 01, 2021
18 Nov 13, 2022
1 Mar 11, 2022
2 Oct 11, 2021
5 Jan 22, 2022
149 Dec 25, 2022
11 Apr 02, 2022
28 Dec 15, 2022
53 Dec 29, 2022
2 Nov 02, 2021