High dynamic range (HDR) image comparison tool for graphics people with an emphasis on OpenEXR images.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode Update c_cpp_properties.json to v4 May 17, 2018
dependencies Support compilation with emscripten Sep 10, 2018
include/tev Make gamma configurable Jun 26, 2018
resources
scripts
src Support compilation with emscripten Sep 10, 2018
.appveyor.yml Require Visual Studio 2017 Apr 23, 2018
.editorconfig
.gitignore Add MSVC-specific build artifact subfolder to gitignore Aug 28, 2017
.gitmodules Add tinylogger submodule May 17, 2018
.travis.yml Only run travis CI on master branch and pull requests Sep 11, 2017
CMakeLists.txt Support compilation with emscripten Sep 10, 2018
LICENSE Update copyright for 2018 Feb 14, 2018
README.md Use master appveyor build status rather than overall status May 20, 2018

README.md

tev — The EXR Viewer

Travis Build Status Appveyor Build Status

A high dynamic range (HDR) image comparison tool for graphics people. tev allows viewing images through various tonemapping operators and inspecting the values of individual pixels. Often, it is important to find exact differences between pairs of images. For this purpose, tev allows rapidly switching between opened images and visualizing various error metrics (L1, L2, and relative versions thereof). To avoid clutter, opened images and their layers can be filtered by keywords.

While the predominantly supported file format is OpenEXR certain other types of images can also be loaded. The following file formats are currently supported:

  • EXR (via OpenEXR)
  • PFM (compatible with Netbpm)
  • HDR, BMP, GIF, JPEG, PIC, PNG, PNM, PSD, TGA (via stb_image)
    • stb_image only supports subsets of each of the aforementioned file formats.
    • Low-dynamic-range (LDR) images are "promoted" to HDR through the reverse sRGB transformation.

Screenshot

Screenshot A false-color comparison of two multi-layer OpenEXR images of a beach ball. Image courtesy of openexr-images.

Usage

Graphical User Interface

Images can be opened via a file dialog or simply by dragging them into tev. They can be reloaded, closed, or filtered at any time, so don't worry about opening more images than exactly needed.

Select an image by left-clicking it, and optionally select a reference image to compare the current selection to by right-clicking. For convenience, the current selection can be moved with the Up/Down or the 1-9 keys. For a comprehensive list of keyboard shortcuts simply click the little "?" icon at the top (or press "h").

If the interface seems overwhelming, simply hover any controls to view an explanatory tooltip.

Command Line

Simply supply images as positional command-line arguments.

$ tev foo.exr bar.exr

By default, all layers and channels are loaded, but individual layers or channels can also be specified. In the following example, the depth layer of foo.exr and the r, g, and b channels of foo.exr and bar.exr are loaded.

$ tev :depth foo.exr :r,g,b foo.exr bar.exr

Other command-line arguments also exist (e.g. for starting tev with a pre-set exposure value). For a list of all valid arguments simply invoke

$ tev -h

Obtaining tev

macOS / Windows

Pre-built binaries for Windows (32-bit and 64-bit) and macOS (64-bit) are available on the releases page.

Linux

Building tev

All that is required for building tev is a C++11-compatible compiler. Begin by cloning this repository and all its submodules using the following command:

$ git clone --recursive https://github.com/Tom94/tev

If you accidentally omitted the --recursive flag when cloning this repository you can initialize the submodules like so:

$ git submodule update --init --recursive

tev uses CMake as its build system. The following sections detail how it should be used on various operating systems.

macOS / Linux

On macOS and most Linux distributions CMake can be obtained via a package manager (Homebrew on macOS, apt on Ubuntu/Debian, etc.). Most Linux distributions additionally require xorg, gl, and zlib development packages and zenity. On Ubuntu/Debian simply call

$ apt-get install cmake xorg-dev libglu1-mesa-dev zlib1g-dev zenity

Once all dependencies are installed, create a new directory to contain build artifacts, enter it, and then invoke CMake with the root tev folder as argument as shown in the following example:

$ mkdir build
$ cd build
$ cmake ..

Afterwards, tev can be built and installed via

$ make -j
$ make install

Windows

On Windows, install CMake, open the included GUI application, and point it to the root directory of tev. CMake will then generate Visual Studio project files for compiling tev. Make sure you select at least Visual Studio 2017 or higher!

License

tev is available under the BSD 3-clause license, which you can find in the LICENSE.md file. TL;DR you can do almost whatever you want as long as you include the original copyright and license notice in any copy of the software and the source code.