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
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!)
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