RASCII

image to ascii art fully created with rust 🦀 🚀

multiple language character lists -> ✔️

creatable custom char list -> ✔️

pixel art creaton -> ✔️

lots of customizations avaliable! ✔️

Installation

FOR ALL PLATFORMS! (Using Cargo): (Not suggested! try your distrubution first!)

cargo install rascii_art

‼️ -> but now you have to use rascii_art keyword to invoke the program! so all the subcommands etc. given at the bottom have to use rascii_art instead of rascii

FOR LINUX:

git clone https://github.com/KoBruhh/RASCII.git

cd RASCII

./INSTALL

If any error accurs please post it on issues section

FOR WİNDOWS:

git clone https://github.com/KoBruhh/RASCII.git

cd RASCII

cargo build --release

Usage:

Linux:

~This program allows you to create ASCII art from any image (.png, .jpeg, .jpg ...)~
SubCommands (rascii <SubCommand>):
-p, --path <path/to/image> // given path is the image path that you want to convert.
-i, --invert // to be able to create images without white background. (if your image has a white plain and you want to ignore it use this command)
-c, --colored // to make ASCII art colored
-h, --help // to access this window
-r, --ratio // to resize img, It could be higher than hundred! but cant be lower than zero!
-bg, --background // to paint background with the color of the pixel!
-wc, --with-color <R> <G> <B> // to create custom colored ASCII arts! you could mix these with -bg !
-px, --pixelated // to convert output to pixelart
-l <your_char_list_or `Available lists at bottom appendix I`> --list <your_char_list_or `Appendix I`> // allows you to create custom lists! and use builtin char_lists!

|If you dont understand, Just ask your mom|
||This project is rusty, so it is fast! really!||

Appendix I
Dont forget that you could enter your own list by:
rascii -p <path/to/path> -l <your_char_list_or || names below!>
Exmpl:
rascii -p <path/to/path> -l bruh // creats your image by using ['b', 'r', 'u', 'h']
rascii -p <path/to/path> -l emoji // creates your image by using emojis -> bcuz list below contains a list named: "emoji"!
Builtin_lists: [
"japanese",
"slight",
"emoji",
"chinese",
"ansi",
"russian",
]

of course you could mix these commands

Windows:

`cd target/release/` //to be able to 
`./rascii --help` // to get help
 REST IS SAME WITH LINUX! but you have to do `./rascii` instead of `rascii`

Samples:

Im on linux so: rascii -p /photos/ferris.jpeg -i -c -l japanese >> ferris.txt -> It just stores the output on ferris.txt,

If you want to see the results only (not store) you're gonna do: rascii -p /photos/ferris.jpeg -i -c -l japanese // both uses builtin japanese char list

Japanese

Emoji

Not that perfect, bcuz emojis are pretty complicated by look! thats why pictur is a bit noisy

Chinese

Custom ASCII list stored on environment variable!

I am using fish so I am using set <var> <value> to create an env var!

If you use bash or such you have to use export <var>=<value> set ANSI_CHAR_LIST ██▓▒░ -> to set an environment variable on terminal

Also dont forget that you could insert your list directly to -l ->

rascii -p <path/to/img> -l 0123456789 creates an img by using 0..10 nums!

rascii -p <path/to/img> -l $ANSI_CHAR_LIST -> to use the variable (ANSI_CHAR_LIST is just an example name of the variable could be anything!)

Ansi based ($ANSI_CHAR_LIST)

Custom colored images!

Pixelart Convertion!

Or I could do an amogus! LOL

Read Documentation / Code

Go inside the directory you entered ./INSTALL

cargo doc --open