Compare commits
25 Commits
0d369de1d7
...
main
Author | SHA1 | Date | |
---|---|---|---|
8daae426e6 | |||
b8811449cf | |||
db780a76ed | |||
bfff88824e | |||
ac16e0431d | |||
fa1548ccc7 | |||
7fb2c40213 | |||
b29b376414 | |||
1dc7b58212 | |||
702214e20c | |||
686d68ce27 | |||
a4459af174 | |||
66b8e56fd6 | |||
1635528802 | |||
fe259c80e9 | |||
1a28004dd0 | |||
9e33c72484 | |||
498f209287 | |||
ac1eb1eed8 | |||
3dd8f101a9 | |||
01e85f5dc8 | |||
6f1f82889e | |||
dd6c006a34 | |||
eb3e093998 | |||
a8873627b8 |
43
.gitea/workflows/run_build.yaml
Normal file
@ -0,0 +1,43 @@
|
||||
name: Run Build
|
||||
run-name: ${{ gitea.actor }} is building tview
|
||||
on: [push]
|
||||
|
||||
jobs:
|
||||
run-build-arch:
|
||||
container:
|
||||
image: archlinux:multilib-devel
|
||||
steps:
|
||||
- name: Install dependencies
|
||||
run: pacman -Sy --noconfirm sdl2 mesa-utils exiv2 cmake nodejs git && pacman -Syu --noconfirm
|
||||
- name: Check out repository code
|
||||
uses: actions/checkout@v4
|
||||
- name: Run ls
|
||||
run: ls
|
||||
- name: Generate build files
|
||||
run: cmake .
|
||||
- name: Build
|
||||
run: cmake --build .
|
||||
run-build-ubuntu:
|
||||
container:
|
||||
image: ubuntu:24.04
|
||||
steps:
|
||||
- name: Install dependencies
|
||||
run: apt update && apt install --no-install-recommends -y build-essential cmake libsdl2-dev libexiv2-dev mesa-utils nodejs ca-certificates git
|
||||
- name: Check out repository code
|
||||
uses: actions/checkout@v4
|
||||
- name: Generate build files
|
||||
run: cmake .
|
||||
- name: Build
|
||||
run: cmake --build .
|
||||
run-build-debian:
|
||||
container:
|
||||
image: debian:bookworm
|
||||
steps:
|
||||
- name: Install dependencies
|
||||
run: apt update && apt install --no-install-recommends -y build-essential cmake libsdl2-dev libexiv2-dev mesa-utils nodejs ca-certificates git
|
||||
- name: Check out repository code
|
||||
uses: actions/checkout@v4
|
||||
- name: Generate build files
|
||||
run: cmake .
|
||||
- name: Build
|
||||
run: cmake --build .
|
15
.gitignore
vendored
@ -34,3 +34,18 @@
|
||||
imgui.ini
|
||||
|
||||
tview
|
||||
|
||||
#CMake
|
||||
CMakeLists.txt.user
|
||||
CMakeCache.txt
|
||||
CMakeFiles
|
||||
CMakeScripts
|
||||
Testing
|
||||
Makefile
|
||||
cmake_install.cmake
|
||||
install_manifest.txt
|
||||
compile_commands.json
|
||||
CTestTestfile.cmake
|
||||
_deps
|
||||
CMakeUserPresets.json
|
||||
|
||||
|
58
CMakeLists.txt
Normal file
@ -0,0 +1,58 @@
|
||||
cmake_minimum_required(VERSION 3.10)
|
||||
|
||||
if(NOT CMAKE_BUILD_TYPE)
|
||||
set(CMAKE_BUILD_TYPE Release)
|
||||
endif()
|
||||
|
||||
set(CMAKE_CXX_STANDARD 20)
|
||||
set(CMAKE_CXX_STANDARD_REQUIRED True)
|
||||
|
||||
project(tview)
|
||||
|
||||
set (SOURCES
|
||||
lib/backends/imgui_impl_opengl3.cpp
|
||||
lib/backends/imgui_impl_opengl3.h
|
||||
lib/backends/imgui_impl_opengl3_loader.h
|
||||
lib/backends/imgui_impl_sdl2.cpp
|
||||
lib/backends/imgui_impl_sdl2.h
|
||||
lib/backends/tex_inspect_opengl.h
|
||||
lib/backends/tex_inspect_opengl.cpp
|
||||
lib/context_wrapper.h
|
||||
lib/image_model.h
|
||||
lib/imconfig.h
|
||||
lib/imfilebrowser.h
|
||||
lib/imgui.cpp
|
||||
lib/imgui.h
|
||||
lib/imgui_bezier_math.h
|
||||
lib/imgui_bezier_math.inl
|
||||
lib/imgui_demo.cpp
|
||||
lib/imgui_draw.cpp
|
||||
lib/imgui_extra_math.h
|
||||
lib/imgui_extra_math.inl
|
||||
lib/imgui_internal.h
|
||||
lib/imgui_tables.cpp
|
||||
lib/imgui_widgets.cpp
|
||||
lib/imstb_rectpack.h
|
||||
lib/imstb_textedit.h
|
||||
lib/imstb_truetype.h
|
||||
lib/stb_image.h
|
||||
lib/imgui_tex_inspect.h
|
||||
lib/imgui_tex_inspect_internal.h
|
||||
lib/imgui_tex_inspect.cpp
|
||||
lib/argparse.hpp
|
||||
lib/histogram.h
|
||||
main.cpp
|
||||
)
|
||||
|
||||
set(OpenGL_GL_PREFERENCE GLVND)
|
||||
find_package(SDL2 REQUIRED)
|
||||
find_package(OpenGL REQUIRED)
|
||||
find_package(exiv2 REQUIRED)
|
||||
include_directories(${SDL2_INCLUDE_DIRS} ${OPENGL_INCLUDE_DIRS})
|
||||
|
||||
set(CMAKE_CXX_FLAGS "-Wall -Wextra")
|
||||
set(CMAKE_CXX_FLAGS_DEBUG "-g")
|
||||
set(CMAKE_CXX_FLAGS_RELEASE "-O2")
|
||||
|
||||
add_executable(tview ${SOURCES})
|
||||
target_link_libraries(tview ${SDL2_LIBRARIES} ${OPENGL_LIBRARIES} exiv2lib)
|
91
Makefile
@ -1,91 +0,0 @@
|
||||
#
|
||||
# Cross Platform Makefile
|
||||
# Compatible with MSYS2/MINGW, Ubuntu 14.04.1 and Mac OS X
|
||||
#
|
||||
# You will need SDL2 (http://www.libsdl.org):
|
||||
# Linux:
|
||||
# apt-get install libsdl2-dev
|
||||
# Mac OS X:
|
||||
# brew install sdl2
|
||||
# MSYS2:
|
||||
# pacman -S mingw-w64-i686-SDL2
|
||||
#
|
||||
|
||||
#CXX = g++
|
||||
#CXX = clang++
|
||||
|
||||
EXE = tview
|
||||
IMGUI_DIR = lib
|
||||
SOURCES = main.cpp
|
||||
SOURCES += $(wildcard $(IMGUI_DIR)/*.cpp)
|
||||
SOURCES += $(wildcard $(IMGUI_DIR)/backends/*.cpp)
|
||||
OBJS = $(addsuffix .o, $(basename $(notdir $(SOURCES))))
|
||||
UNAME_S := $(shell uname -s)
|
||||
LINUX_GL_LIBS = -lGL
|
||||
|
||||
CXXFLAGS = -std=c++20 -I$(IMGUI_DIR) -I$(IMGUI_DIR)/backends
|
||||
CXXFLAGS += -DIMGUI_DEFINE_MATH_OPERATORS -O3 -DGL_SILENCE_DEPRECATION
|
||||
LIBS = -lexiv2
|
||||
|
||||
##---------------------------------------------------------------------
|
||||
## OPENGL ES
|
||||
##---------------------------------------------------------------------
|
||||
|
||||
## This assumes a GL ES library available in the system, e.g. libGLESv2.so
|
||||
# CXXFLAGS += -DIMGUI_IMPL_OPENGL_ES2
|
||||
# LINUX_GL_LIBS = -lGLESv2
|
||||
## If you're on a Raspberry Pi and want to use the legacy drivers,
|
||||
## use the following instead:
|
||||
# LINUX_GL_LIBS = -L/opt/vc/lib -lbrcmGLESv2
|
||||
|
||||
##---------------------------------------------------------------------
|
||||
## BUILD FLAGS PER PLATFORM
|
||||
##---------------------------------------------------------------------
|
||||
|
||||
ifeq ($(UNAME_S), Linux) #LINUX
|
||||
ECHO_MESSAGE = "Linux"
|
||||
LIBS += $(LINUX_GL_LIBS) -ldl -L/usr/lib -lSDL2
|
||||
|
||||
CXXFLAGS += -I/usr/include/SDL2 -D_REENTRANT
|
||||
CFLAGS = $(CXXFLAGS)
|
||||
endif
|
||||
|
||||
ifeq ($(UNAME_S), Darwin) #APPLE
|
||||
ECHO_MESSAGE = "Mac OS X"
|
||||
LIBS += -framework OpenGL -framework Cocoa -framework IOKit -framework CoreVideo `sdl2-config --libs`
|
||||
LIBS += -L/usr/local/lib -L/opt/local/lib
|
||||
|
||||
CXXFLAGS += `sdl2-config --cflags`
|
||||
CXXFLAGS += -I/usr/local/include -I/opt/local/include
|
||||
CFLAGS = $(CXXFLAGS)
|
||||
endif
|
||||
|
||||
ifeq ($(OS), Windows_NT)
|
||||
ECHO_MESSAGE = "MinGW"
|
||||
LIBS += -lgdi32 -lopengl32 -limm32 `pkg-config --static --libs sdl2`
|
||||
|
||||
CXXFLAGS += `pkg-config --cflags sdl2`
|
||||
CFLAGS = $(CXXFLAGS)
|
||||
endif
|
||||
|
||||
##---------------------------------------------------------------------
|
||||
## BUILD RULES
|
||||
##---------------------------------------------------------------------
|
||||
|
||||
%.o:%.cpp
|
||||
$(CXX) $(CXXFLAGS) -c -o $@ $<
|
||||
|
||||
%.o:$(IMGUI_DIR)/%.cpp
|
||||
$(CXX) $(CXXFLAGS) -c -o $@ $<
|
||||
|
||||
%.o:$(IMGUI_DIR)/backends/%.cpp
|
||||
$(CXX) $(CXXFLAGS) -c -o $@ $<
|
||||
|
||||
all: $(EXE)
|
||||
@echo Build complete for $(ECHO_MESSAGE)
|
||||
|
||||
$(EXE): $(OBJS)
|
||||
$(CXX) -o $@ $^ $(CXXFLAGS) $(LIBS)
|
||||
|
||||
clean:
|
||||
rm -f $(EXE) $(OBJS)
|
118
README.md
@ -1,57 +1,93 @@
|
||||
# tview
|
||||
> A (relatively) fast, lightweight, and useful image viewer.
|
||||
|
||||
# How to Build
|
||||

|
||||
|
||||
## Windows with Visual Studio's IDE
|
||||
# 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`
|
||||

|
||||
|
||||
Use the provided project file (.vcxproj). Add to solution (imgui_examples.sln) if necessary.
|
||||
## Detail Views
|
||||
Toggle detail modes by pressing `d`
|
||||
|
||||
## Windows with Visual Studio's CLI
|
||||
| Normal Arrow | Hex Color | RGB 255 Color | RGB Float Color |
|
||||
| --------------------- | ------------------- | ----------------------- | ------------------------- |
|
||||
|  |  |  |  |
|
||||
## Image Filtering
|
||||
Toggle Filtering by pressing
|
||||
|
||||
Use build_win32.bat or directly:
|
||||
| Filtering Off | Filtering On |
|
||||
| ---------------------- | --------------------- |
|
||||
|  |  |
|
||||
# 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
|
||||
```
|
||||
set SDL2_DIR=path_to_your_sdl2_folder
|
||||
cl /Zi /MD /utf-8 /I.. /I..\.. /I%SDL2_DIR%\include main.cpp ..\..\backends\imgui_impl_sdl2.cpp ..\..\backends\imgui_impl_opengl3.cpp ..\..\imgui*.cpp /FeDebug/example_sdl2_opengl3.exe /FoDebug/ /link /libpath:%SDL2_DIR%\lib\x86 SDL2.lib SDL2main.lib opengl32.lib /subsystem:console
|
||||
# ^^ include paths ^^ source files ^^ output exe ^^ output dir ^^ libraries
|
||||
# or for 64-bit:
|
||||
cl /Zi /MD /utf-8 /I.. /I..\.. /I%SDL2_DIR%\include main.cpp ..\..\backends\imgui_impl_sdl2.cpp ..\..\backends\imgui_impl_opengl3.cpp ..\..\imgui*.cpp /FeDebug/example_sdl2_opengl3.exe /FoDebug/ /link /libpath:%SDL2_DIR%\lib\x64 SDL2.lib SDL2main.lib opengl32.lib /subsystem:console
|
||||
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
|
||||
```
|
||||
|
||||
## Linux and similar Unixes
|
||||
|
||||
Use our Makefile or directly:
|
||||
## Building
|
||||
Clone the repository
|
||||
```
|
||||
c++ `sdl2-config --cflags` -I .. -I ../.. -I ../../backends
|
||||
main.cpp ../../backends/imgui_impl_sdl2.cpp ../../backends/imgui_impl_opengl3.cpp ../../imgui*.cpp
|
||||
`sdl2-config --libs` -lGL -ldl
|
||||
git clone https://git.dws.rip/dubey/tview.git
|
||||
```
|
||||
|
||||
## macOS
|
||||
|
||||
Use our Makefile or directly:
|
||||
Change directory into the repository
|
||||
```
|
||||
brew install sdl2
|
||||
c++ `sdl2-config --cflags` -I .. -I ../.. -I ../../backends
|
||||
main.cpp ../../backends/imgui_impl_sdl2.cpp ../../backends/imgui_impl_opengl3.cpp ../../imgui*.cpp
|
||||
`sdl2-config --libs` -framework OpenGl -framework CoreFoundation
|
||||
cd tview
|
||||
```
|
||||
|
||||
## Emscripten
|
||||
Generate build files and trigger build
|
||||
```
|
||||
cmake .
|
||||
cmake --build .
|
||||
```
|
||||
|
||||
**Building**
|
||||
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
|
||||
```
|
||||
|
||||
You need to install Emscripten from https://emscripten.org/docs/getting_started/downloads.html, and have the environment variables set, as described in https://emscripten.org/docs/getting_started/downloads.html#installation-instructions
|
||||
|
||||
- Depending on your configuration, in Windows you may need to run `emsdk/emsdk_env.bat` in your console to access the Emscripten command-line tools.
|
||||
- You may also refer to our [Continuous Integration setup](https://github.com/ocornut/imgui/tree/master/.github/workflows) for Emscripten setup.
|
||||
- Then build using `make -f Makefile.emscripten` while in the current directory.
|
||||
|
||||
**Running an Emscripten project**
|
||||
|
||||
To run on a local machine:
|
||||
- `make -f Makefile.emscripten serve` will use Python3 to spawn a local webserver, you can then browse http://localhost:8000 to access your build.
|
||||
- Otherwise, generally you will need a local webserver. Quoting [https://emscripten.org/docs/getting_started](https://emscripten.org/docs/getting_started/Tutorial.html#generating-html):<br>
|
||||
_"Unfortunately several browsers (including Chrome, Safari, and Internet Explorer) do not support file:// [XHR](https://emscripten.org/docs/site/glossary.html#term-xhr) requests, and can’t load extra files needed by the HTML (like a .wasm file, or packaged file data as mentioned lower down). For these browsers you’ll need to serve the files using a [local webserver](https://emscripten.org/docs/getting_started/FAQ.html#faq-local-webserver) and then open http://localhost:8000/hello.html."_
|
||||
- Emscripten SDK has a handy `emrun` command: `emrun web/index.html --browser firefox` which will spawn a temporary local webserver (in Firefox). See https://emscripten.org/docs/compiling/Running-html-files-with-emrun.html for details.
|
||||
- You may use Python 3 builtin webserver: `python -m http.server -d web` (this is what `make serve` uses).
|
||||
- You may use Python 2 builtin webserver: `cd web && python -m SimpleHTTPServer`.
|
||||
- If you are accessing the files over a network, certain browsers, such as Firefox, will restrict Gamepad API access to secure contexts only (e.g. https only).
|
||||
`tview` is now installed on your system
|
||||
|
7
main.cpp
@ -8,6 +8,7 @@
|
||||
#include "lib/imgui_internal.h"
|
||||
#include <cstdint>
|
||||
#include <exiv2/tags.hpp>
|
||||
#include <exiv2/version.hpp>
|
||||
#include <iostream>
|
||||
#include <stdexcept>
|
||||
#include <stdio.h>
|
||||
@ -39,6 +40,8 @@
|
||||
|
||||
#include "lib/histogram.h"
|
||||
|
||||
|
||||
|
||||
struct Args : public argparse::Args {
|
||||
std::string &fpath = arg("path to the image");
|
||||
};
|
||||
@ -83,7 +86,11 @@ EXIFData printExifData(const std::string& imagePath) {
|
||||
d.CameraMake = "NULL";
|
||||
try {
|
||||
// Load the image
|
||||
#if EXIV2_TEST_VERSION(0,28,0)
|
||||
Exiv2::Image::UniquePtr img = Exiv2::ImageFactory::open(imagePath);
|
||||
#else
|
||||
Exiv2::Image::AutoPtr img = Exiv2::ImageFactory::open(imagePath);
|
||||
#endif
|
||||
if (img.get() == 0) {
|
||||
std::cerr << "Error: Could not open image file " << imagePath << std::endl;
|
||||
return d;
|
||||
|
BIN
screenshots/detail_arrow.png
Normal file
After Width: | Height: | Size: 60 KiB |
BIN
screenshots/detail_hex.png
Normal file
After Width: | Height: | Size: 44 KiB |
BIN
screenshots/detail_rgb_float.png
Normal file
After Width: | Height: | Size: 83 KiB |
BIN
screenshots/detail_rgb_int.png
Normal file
After Width: | Height: | Size: 88 KiB |
BIN
screenshots/filtering_off.png
Normal file
After Width: | Height: | Size: 60 KiB |
BIN
screenshots/filtering_on.png
Normal file
After Width: | Height: | Size: 565 KiB |
BIN
screenshots/main.png
Normal file
After Width: | Height: | Size: 712 KiB |
BIN
screenshots/tooltip.png
Normal file
After Width: | Height: | Size: 1.6 MiB |