From 4aca62ba76d5d0687d175d286bea175f46b2e9e6 Mon Sep 17 00:00:00 2001 From: Stefan Haustein Date: Tue, 11 Jul 2017 23:53:40 +0200 Subject: [PATCH] Update README.md --- README.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 0b2d254..fbabb3a 100644 --- a/README.md +++ b/README.md @@ -2,17 +2,16 @@ Small C++ program to display images in a (modern) terminal using RGB ANSI codes and unicode block graphic characters. -The main difference to various existing similar tools is that instead of having two fixed pixels per character -cell utilizing the unicode half block character, this program enhances the resolution using the following algorithm: +There are various similar (pre)existing tools such as timg using the unicode half block character to display two 24bit pixels per character cell. This program enhances the resolution by mapping 4x8 pixel cells to different unicode characters, using the following algorithm: -For each 4x8 pixel cell mapped to a unicode block graphics character: +For each 4x8 pixel cell of the (potentially downscaled) image: 1. Find the color channel (R, G or B) that has the biggest range of values for the current cell 2. Split this range in the middle and create a corresponding bitmap for the cell 4. Compare the bitmap to the assumed bitmaps for various unicode block graphics characters 5. Re-calculate the foregound and background colors for the chosen character. -Please find a comparsion image at the end of this file. +See the difference by disabling this optimization using the `-0` option. Or just take a look at the comparsion image at the end of this text. ## Installation @@ -23,7 +22,9 @@ Please find a comparsion image at the end of this file. ## Usage - tiv + tiv [options] + +The shell will expand wildcards. By default, thumbnails and file names will be displayed if more than one image is provided. To display a list of options, just run the command without any parameters. ## Common problems @@ -40,5 +41,7 @@ If multiple images match the filename spec, thumbnails are shown. ## Comparison to Using Half-Block Characters Only +The top image was generated with the character optization diabled via the `-0` option. + ![Comparison](http://i.imgur.com/OzdCeh6.png)