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
5 Jan 22, 2022
6 Oct 20, 2021
3 Jun 02, 2022
1 Jan 03, 2022
4.1k Jan 08, 2023
5 Jul 13, 2022
199 Dec 08, 2022
5 Nov 13, 2022
5 Jan 24, 2022
419 Dec 26, 2022
30 Dec 24, 2022
53 Nov 15, 2022
6 Jul 21, 2022
10.4k Dec 31, 2022
1k Dec 29, 2022
114 Dec 29, 2022
12 Dec 15, 2021
1 Aug 09, 2022
1 Dec 23, 2021