93 lines
2.1 KiB
Markdown
93 lines
2.1 KiB
Markdown
# tview
|
|
> A (relatively) fast, lightweight, and useful image viewer.
|
|
|
|
![[main.png]]
|
|
|
|
# Features
|
|
- Supports most common image formats
|
|
- EXIF Viewing
|
|
- Histogram Calculation
|
|
- Toggle image filtering
|
|
- Pixel level details
|
|
- Color tooltip
|
|
# Gallery
|
|
## Tooltip
|
|
Toggle the tooltip by pressing `t`
|
|
![[tooltip.png]]
|
|
## Detail Views
|
|
Toggle detail modes by pressing `d`
|
|
|
|
| Normal Arrow | Hex Color | RGB 255 Color | RGB Float Color |
|
|
| --------------------- | ------------------- | ----------------------- | ------------------------- |
|
|
| ![[detail_arrow.png]] | ![[detail_hex.png]] | ![[detail_rgb_int.png]] | ![[detail_rgb_float.png]] |
|
|
## Image Filtering
|
|
Toggle Filtering by pressing
|
|
|
|
| Filtering Off | Filtering On |
|
|
| ---------------------- | --------------------- |
|
|
| ![[filtering_off.png]] | ![[filtering_on.png]] |
|
|
# Usage
|
|
`tview PATH/TO/IMAGE`
|
|
|
|
Press `h` to show the help dialog within the program.
|
|
## Mouse
|
|
Scroll to zoom.
|
|
Click and drag to pan.
|
|
|
|
## Keyboard
|
|
- `h` - Show help
|
|
- `c`- Toggle Histogram
|
|
- `e`- Toggle EXIF data
|
|
- `d`- Cycle [[#Detail Views]] (default off)
|
|
- `a` - Toggle image filtering (default off)
|
|
- `g` - Toggle grid (only visible at pixel level)
|
|
- `r`- Rotate image 90 degrees clockwise
|
|
- `q` - Quit
|
|
|
|
# Installing
|
|
## Requirements to Run
|
|
- SDL2
|
|
- OpenGL
|
|
- Libexiv2
|
|
|
|
## Requirements to build
|
|
In addition to the run requirements
|
|
- CMake
|
|
- C++ Compiler (g++/clang++)
|
|
### On Ubuntu
|
|
```
|
|
apt install --no-install-recommends build-essential cmake libsdl2-dev libexiv2-dev mesa-utils
|
|
```
|
|
### On Debian
|
|
```
|
|
apt install --no-install-recommends build-essential cmake libsdl2-dev libexiv2-dev mesa-utils
|
|
```
|
|
### On Arch
|
|
```
|
|
pacman -Sy sdl2 mesa-utils exiv2 cmake base-devel
|
|
```
|
|
|
|
## Building
|
|
Clone the repository
|
|
```
|
|
git clone https://git.dws.rip/dubey/tview.git
|
|
```
|
|
|
|
Change directory into the repository
|
|
```
|
|
cd tview
|
|
```
|
|
|
|
Generate build files and trigger build
|
|
```
|
|
cmake .
|
|
cmake --build .
|
|
```
|
|
|
|
You will now have a file called `tview` in the repository root, you can copy this into your path:
|
|
```
|
|
sudo mv ./tview /usr/local/bin/tview
|
|
```
|
|
|
|
`tview` is now installed on your system
|