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
47 Dec 22, 2022
238 Dec 30, 2022
881 Jan 06, 2023
24 Aug 13, 2022
7 May 26, 2022
3 May 01, 2022
199 Dec 08, 2022
1 Feb 02, 2022
3 May 16, 2022
1.4k Jan 01, 2023
4 Nov 03, 2021
24 Dec 20, 2022
6 Sep 06, 2022
13 Mar 07, 2022
138 Dec 14, 2022
2 Sep 28, 2022
136 Jan 02, 2023
14 Jan 04, 2023
294 Jan 08, 2023
1 Dec 29, 2021