hatkidchan / yaitaa Goto Github PK

View Code? Open in Web Editor NEW

8.0 1.0 0.0 111 KB

yummy-yummy ANSI art

License: GNU General Public License v3.0

Makefile 1.29% C 98.71%

linux cli c terminal command-line ascii ansi image-processing ascii-art ansi-art c99 braille-patterns command-line-tool

yaitaa's Introduction

YAITAA - Yet Another Image To A(NSI) Art (converter)

Yes, very original. Old name is asciify-reborn for reasons stated bellow

Reasons for reimplementation

Everything is already described in hatkidchan/asciify, but just as recap:

I'm not happy with old project structure
Some new features may be pain in the ass to add
Spaghetti code
Literally dublication
Separate binaries for each mode
Git submodules. Yay.

Build instructions

1. Make sure that you have C compiler and make

cc --version && make --version && echo 'ok'

Both of commands should succeed.

2. Clone repo

git clone --recursive https://github.com/hatkidchan/yaitaa
cd yaitaa

2. Build it

make

3. Run it

./yaitaa -M braille -S 256 -W 80 -H 24 ~/images/kitty.png

Build end notes

1. It is preferred to use `clang` as your compiler

Main reason being that it is more strict, so any issues I've missed may be reported on that step. Feel free to send them to me!

CC=clang make

2. Strip binary to reduce size (saves ~100KiB)

strip ./yaitaa

3. Installation

# as root
make install # Will install it to /bin/

Alternatively, you can install it to your local user directory, if it's in your $PATH:

make install PREFIX=$HOME/.local/ # will install it to $HOME/.local/bin/

License

yaitaa - Yet Another Image To A(NSI) Art (converter)
Copyright (C) 2022 hatkidchan <hatkidchan at gmail dot com>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

yaitaa's People

Contributors

Stargazers

Watchers

yaitaa's Issues

overtake ascii-image-converter

post yaitaa on r/unixporn for reddit updoots and instant 9000 stars :)
https://github.com/TheZoraiz/ascii-image-converter

make it pretty, duh

current codebase looks like total crap, you shoudl work on it soemday maybe (i hope youw ill)

Make better README with examples and stuff

Issue created mostly to separate images from main repo. Yeah.

Can't build the binary using clang

Did I Do Everything Right?

Yes, probably? Cloned recursively, then used a plain make command.

Platform With The Issue

M1 Pro on macOS 12.1 with make version 4.3

`Make` Output on a Mac

cc -Wall -Wextra -Werror -pedantic -std=c99 -ggdb src/mod_blocks.c -Isrc -c -o obj/mod_blocks.o
src/mod_blocks.c:202:11: error: variable 'pal' is used uninitialized whenever switch default is taken [-Werror,-Wsometimes-uninitialized]
          default: break;
          ^~~~~~~
src/mod_blocks.c:204:39: note: uninitialized use occurs here
        int index_top = closest_color(pal, top),
                                      ^~~
src/mod_blocks.c:196:9: note: variable 'pal' is declared here
        palette_t pal;
        ^
1 error generated.
make: *** [Makefile:19: obj/mod_blocks.o] Error 1

Am I Sure that It's Only on a Mac?

Pretty sure. But IDK why, though.
The build completes fine on a regular Linux machine.

when transparen

@hatkidchan @hatkidchan @hatkidchan @hatkidchan when transparen

Add tests

TODO: add test target to Makefile, as well as test scripts (in Python, Bash or even in C itself?).

Test scripts should download sample images from this issue (TODO: add images) into obj/ folder.

Test scripts should run after running testbuild target or as last step of it. Test scripts should depend on all target.

help wanted label is set, because I need some sample images, if possible. SFW-only, public domain and/or royalty-free only. Self-made content also allowed. Images should be in either PNG or BMP (i.e. lossless compression only) to reduce ambiguity caused by (de-)compression.