A simple depth image viewer
1 year, 8 months ago

7c1f3b4 [WIP] Major restructuring

3 years ago


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 colormap. It is also possible to normalize all images to the same range so that there is no flickering when scrolling through them. Parallaxis requires a C++17 compliant compiler and OpenCV 3/4.


original depth normalized depth normalized depth with colormap individually normalized images commonly normalized images
Original Normalized Colormap Individual normalization Common normalization


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.

parallaxis depth1.png depth2.pgm  # multiple images
parallaxis dir/                   # images in directory
parallaxis                        # images in current directory
parallaxis -N dir/ depth/         # common normalization for images in 2 directories

Only grayscale images are normalized and shown using a colormap. RGB images are shown unchanged.

Run man parallaxis or parallaxis --help for more info about the program.


Action Key(s)
Next image l j
Previous image h k
Toggle normalization n
Toggle common normalization N
Toggle colormap c
Next colormap C
Invert colors i
Quit q


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

  • GCC 6+ or clang 6+ (for std::filesystem from C++17)
  • OpenCV 3/4

Compile the executable and install it along with the manpage:

sudo make install


Bugs and feature requests can be submitted to todo.sr.ht/~sotirisp/parallaxis


Copyright © 2020 Sotiris Papatheodorou

This program is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute 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.