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.1k Jan 08, 2023
9.6k Jan 09, 2023
1 Dec 31, 2021
2 Feb 19, 2022
26 Nov 17, 2022
0 Jul 15, 2021
190 Dec 21, 2022
1.4k Dec 29, 2022
1 Dec 09, 2021
199 Nov 19, 2022
8 Sep 21, 2022
1.8k Jan 02, 2023
1 Dec 27, 2021
2 Mar 07, 2022
1 Feb 13, 2022
1 Jan 09, 2022
0 Aug 16, 2022
719 Jan 05, 2023
141 Oct 09, 2022
205 Oct 17, 2022