Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tom94/tev
High dynamic range (HDR) image viewer for graphics people
https://github.com/tom94/tev
exr hdr image image-comparison macos openexr openexr-images rendering screenshot tev
Last synced: 29 days ago
JSON representation
High dynamic range (HDR) image viewer for graphics people
- Host: GitHub
- URL: https://github.com/tom94/tev
- Owner: Tom94
- License: bsd-3-clause
- Created: 2017-08-26T10:28:43.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-10-03T12:38:03.000Z (about 1 month ago)
- Last Synced: 2024-10-15T09:01:10.255Z (29 days ago)
- Topics: exr, hdr, image, image-comparison, macos, openexr, openexr-images, rendering, screenshot, tev
- Language: C++
- Homepage:
- Size: 4.41 MB
- Stars: 1,085
- Watchers: 20
- Forks: 86
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Citation: CITATION.cff
Awesome Lists containing this project
README
# tev — The EXR Viewer 
Image viewer and comparison tool for graphics people.
- __Lightning fast:__ starts up instantly, loads hundreds of images in seconds.
- __Versatile:__ supports many [file formats](#file-formats), tonemapping operators, error metrics, histograms, and pixel peeping.
- __HDR:__ displays true HDR on Apple EDR displays.
_A false-color comparison of two multi-layer OpenEXR images of a beach ball. Image courtesy of [openexr-images](https://github.com/openexr/openexr-images)._
## Installation
### Windows
Download the __tev__ executable (.exe) from the [releases page](https://github.com/Tom94/tev/releases).
### macOS
Download the __tev__ application (.dmg) from the [releases page](https://github.com/Tom94/tev/releases) or install it via homebrew.
```bash
brew install --cask tev
```
### Linux
Download the __tev__ application (.appimage) from the [releases page](https://github.com/Tom94/tev/releases). See [how to run AppImages](https://appimage.org/).
On Arch Linux you can also install __tev__ from the [Arch User Repository](https://aur.archlinux.org/packages/tev/).
## Usage
### Graphical User Interface
Images can be opened via a file dialog or 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 click the little "?" icon at the top (or press "h") or view [this online visualization](https://keycombiner.com/collecting/collections/shared/f050cc02-f23a-425c-b032-b4c3659c7ef4).
If the interface seems overwhelming, you can hover any controls to view an explanatory tooltip.
### Command Line
__tev__ takes images as positional command-line arguments:
```sh
$ 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.
```sh
$ tev :depth foo.exr :r,g,b foo.exr bar.exr
```
Other command-line arguments exist (e.g. for starting __tev__ with a pre-set exposure value). For a list of all arguments simply invoke
```sh
$ tev -h
```
### Over the Network
__tev__ can also be controlled remotely over the network using a simple TCP-based protocol.
The `--host` argument specifies the IP and port __tev__ is listening to. By default, __tev__ only accepts connections from localhost (`127.0.0.1:14158`), which is useful, for example, as frontend for a supported renderer like [pbrt version 4](https://github.com/mmp/pbrt-v4).
The following operations exist:
| Operation | Function
| :--- | :----------
| `OpenImage` | Opens an image from a specified path on the machine __tev__ is running on.
| `CreateImage` | Creates a blank image with a specified name, size, and set of channels. If an image with the specified name already exists, it is overwritten.
| `UpdateImage` | Updates the pixels in a rectangular region.
| `CloseImage` | Closes a specified image.
| `ReloadImage` | Reloads an image from a specified path on the machine __tev__ is running on.
| `VectorGraphics` | Draws vector graphics over a specified image.
__tev__'s network protocol is already implemented in the following languages:
- [Python](src/python/tev.py) by Tomáš Iser
- [Rust](https://crates.io/crates/tev_client) by Karel Peeters
If using these implementations is not an option, it's easy to write your own one. Each packet has the simple form
```
[uint32_t total_length_in_bytes][byte operation_type][byte[] operation_specific_payload]
```
where integers are encoded in little endian.
There are helper functions in [Ipc.cpp](src/Ipc.cpp) (`IpcPacket::set*`) that show exactly how each packet has to be assembled. These functions do not rely on external dependencies, so it is recommended to copy and paste them into your project for interfacing with __tev__.
## Building tev
All that is required for building __tev__ is [CMake](https://cmake.org/) and a C++20-compatible compiler. On Windows, that's Visual Studio 2019 and newer. On Linux and macOS, your system's GCC or Clang compiler is likely sufficient.
Most Linux distributions additionally require _xorg_, _gl_, _zlib_, and _zenity_. On Ubuntu/Debian simply call
```sh
$ apt-get install cmake xorg-dev libglu1-mesa-dev zlib1g-dev zenity
```
Once all dependencies are installed, begin by cloning this repository and all its submodules using the following command:
```sh
$ git clone --recursive https://github.com/Tom94/tev
```
Then, use [CMake](https://cmake.org/) as follows:
```sh
$ cmake . -B build
$ cmake --build build --config Release -j
```
Afterwards, __tev__ can be installed via
```sh
$ cmake --install build
```
or you can create a standalone installer (Windows, macOS) / [AppImage](https://appimage.org/) (Linux) with
```sh
$ cpack --config build/CPackConfig.cmake
```
## File Formats
- __EXR__ (via [OpenEXR](https://github.com/wjakob/openexr))
- __HDR__, __PNG__, __JPEG__, BMP, GIF, PIC, PNM, PSD, TGA (via [stb_image](https://github.com/wjakob/nanovg/blob/master/src/stb_image.h))
- __PFM__ (compatible with [Netbpm](http://www.pauldebevec.com/Research/HDR/PFM/))
- __QOI__ (via [qoi](https://github.com/phoboslab/qoi). Shoutout to [Tiago Chaves](https://github.com/laurelkeys) for adding support!)
- __DDS__ (via [DirectXTex](https://github.com/microsoft/DirectXTex); Windows only. Shoutout to [Craig Kolb](https://github.com/cek) for adding support!)
- Supports BC1-BC7 compressed formats.
## License
__tev__ is available under the BSD 3-clause license, which you can find in the `LICENSE.txt` file. [TL;DR](https://tldrlegal.com/license/bsd-3-clause-license-(revised)).