img-print

Display images (text representation) in 24 bit color terminals

sample output

Dependencies

• c++17 compiler
• CMake > 3.15
• libvips
• Conan install instructions

Building

1. clone repository

git clone https://github.com/jdao55/img-print.git && cd img-print

2. Create build directory and Run Cmake

mkdir build && cd build
cmake ../ 

3. Compile program

make -j4

Executable is found in

build/bin/img-print

Docker (linux x86-64 only)

sample commands for building and runing with docker

sudo docker build -t img-print ./ 

sudo docker run --mount type=bind, \
                        source="$(pwd)", \
                        target=/img_print/mnt, \
                        readonly \
                   img-print ./relative_path_to_image

Usage

Usage:
  img-print [-g] <filename> [--filtertype=<algorithm>]
  img-print [-g] <filename> <output-width> [--filtertype=<algorithm>]
  img-print [-g] <filename> <output-width> <output-height> [--filtertype=<algorithm>]
  img-print [-g] <filename> <output-width> <output-height> <output-character> [--filtertype=<algorithm>]
  img-print (-h | --help)
Options:
   -h --help                   Show this screen.
   -g --greyscale              Output in greyscale
   --filtertype=<algorithm>    Specify scaling algorithm options are:
                                   lanczos
                                   cubic
                                   quadratic
                                   catrom
                                   sinc
                   

Options

-h --help Print help message

-g --greyscale Output in greyscale

Example

Tested with Konsole

Running Tests

test Executable is found in

build/bin/unittest