norama view_v0.3

Overview

The norama-view software is designed to offer an interface for equirectangular mapping image rectilinear view. It allows to navigate on the mapping as if it was projected on a sphere in order to remove mapping distortions. This viewer can be considered as a gnomonic viewer for equirectangular mappings.

Usage

The norama-view software expects the following arguments and parameters. Starting with the stream arguments and parameters :

--input -i

Path to the equirectangular mapping image to display.

Parallelization arguments and parameters :

--threads -t

This parameter is used to override the default thread count for
performance improvement.

The following optimization arguments and parameters can be considered :

--scale -s

This parameter allows to decrease, or increase, the size of the
display buffer. This can be used to decrease the computation
load.

--width -x, --height -y

Those parameters allow to manually specify the screen resolution
that imply the size of the display buffer.

Finally, the help switch is :

--help -h

Display minimal usage summary.

The screen resolution can be manually set because norama-view does not manage multi-screen platforms.

Demonstration

Considering the following equirectangular mapping (copyright (c) Didier Mouron under CC BY-SA license) captured using an Eyesis4Pi camera :

the viewer allows to navigates through mouse as if the mapping where projected on a sphere surrounding the point of view as illustrated on the following image :

In order to move the point of view, the mouse has to be moved maintaining the left click. Using the right click and moving the mouse vertically allows to change the field of view. The R key can be used to reset both point and field of view when F key only resets the field of view to its default value.

Compilation

The software binary can be build using its specific makefile by simply typing in its base directory :

$ make clean && make build [OPENMP=false]

The binary is placed in the local bin directory and is not copied in the main bin directory. To generate the documentation, use the command :

$ make clean-documentation && make documentation

To install or uninstall the binaries on the local computer, use the commands :

# make install
# make uninstall