~sotirisp/parallaxis

2f85768044cb91bdea322702ae224ef156cf1bff — Sotiris Papatheodorou 1 year, 8 months ago 6f509e3
Fix image table in README

Had to use plain HTML because sourcehut does not support Markdown table with
images. Also had to use absolute URLs because relative ones aren't interpreted
correctly.
1 files changed, 25 insertions(+), 10 deletions(-)

M README.md
M README.md => README.md +25 -10
@@ 1,11 1,8 @@
<!--
SPDX-FileCopyrightText: 2020 Sotiris Papatheodorou
SPDX-License-Identifier: GPL-3.0-or-later
-->


<!-- SPDX-FileCopyrightText: 2020 Sotiris Papatheodorou -->
<!-- SPDX-License-Identifier: GPL-3.0-or-later -->

# parallaxis

Parallaxis is a simple viewer for images captured by depth cameras like the
Microsoft Kinect and the Intel Realsense series. Depth images are normalized to
make them easier to inspect visually and can optionally be displayed using a


@@ 16,14 13,28 @@ compliant compiler and OpenCV 3.


## Screenshots
| | | | | |
| :-: | :-: | :-: | :-: | :-: |
| ![original depth](https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/original.jpg) | ![normalized depth](https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/normalized.jpg) | ![normalized depth with colormap](https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/colormap.jpg) | ![individually normalized images](https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/individual_normalization.jpg) | ![commonly normalized images](https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/common_normalization.jpg) |
| Original | Normalized | Colormap | Individual normalization | Common normalization |

<table style="text-align:center">
  <tr>
    <td><img src="https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/original.jpg" alt="original depth"></td>
    <td><img src="https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/normalized.jpg" alt="normalized depth"></td>
    <td><img src="https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/colormap.jpg" alt="normalized depth with colormap"></td>
    <td><img src="https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/individual_normalization.jpg" alt="individually normalized images"></td>
    <td><img src="https://git.sr.ht/~sotirisp/parallaxis/blob/master/resources/common_normalization.jpg" alt="commonly normalized images"></td>
  </tr>
  <tr>
    <th>Original</th>
    <th>Normalized</th>
    <th>Colormap</th>
    <th>Individual normalization</th>
    <th>Common normalization</th>
  </tr>
</table>



## Usage

`parallaxis` can show one or more images, all images in one or more directories
or a combination of images and directories. If no arguments are provided then
any images in the current working directory will be shown.


@@ 43,6 54,7 @@ Run `parallaxis --help` for more info about the command line arguments.


## Keybindings

| Action                      | Key(s)             |
|:--------------------        |:------------------:|
| Next image                  | `l`, `j`, `→`, `↓` |


@@ 57,6 69,7 @@ Run `parallaxis --help` for more info about the command line arguments.


## Installation

Tested on Ubuntu 18.04 and Debian 10 Buster. Install the dependencies:

- GCC 6+ or clang 6+ (for `std::filesystem` from C++17)


@@ 72,12 85,14 @@ sudo make install


## Resources

Bugs and feature requests can be submitted to
[todo.sr.ht/~sotirisp/parallaxis](https://todo.sr.ht/~sotirisp/parallaxis)



## License

Copyright © 2020 Sotiris Papatheodorou

This program is Free Software: You can use, study share and improve it at your