openimageviewer / openimageviewer

Open image viewer is a hardware accelerated open code c++20 compliant cross platform 'C' library and application for viewing and manipulating images.

Open Image Viewer

Open Image Viewer is a hardware accelerated blazingly fast open code c++20 compliant cross-platform application for accurately viewing and analyzing image files.

It provides accurate representation of the image being viewed, unlike the vast majority of the current viewers that shows the monitor color space data.

Emphasis on ergonomics and performance is thoroughly weighed to suit every type of user, the starting novice or the hardcore power user.

Currenlty there's virtually no GUI, keyboard key bindings is used for fast workflow, press F1 to list all keybindings.

For more information visit our website at: www.openimageviewer.com

A Word from the author
Highlights and features

Build your copy from source / Start developing

Instructions

1. Clone the repository and update the submodules recursivly.
2. Use CMake to generate project files or open the root CMake file in visual studio as a CMake project.
3. Compile and run.

Notes

• PNG codec is disabled by deafult due to ci/cd issues
• FreeImage codec is supplied in the official releases as a fallback but disabled by deafult due to its low performance, see below how to build the project with FreeImage
• 64 bit is only officialy supported, though last checked 32 bit compiles and runs fluently

Windows

Windows requirements

• Windows 7/8/8.1/10/11
• Microsoft build tools 2022 or higher

When using Windows 7 SP1, make sure the following are installed

• KB2670838 - Windows 7 platform update
• KB4019990 - D3DCompiler_47
• Universal C runtime

Linux

Linux requirements

coming soon ...

MacOS

MacOS requirements

coming soon ...

Extra Codec Library dependecies (optional)

Name	Link
CodecFreeImage	http://freeimage.sourceforge.net/

---

License

OIV uses the OpenImageViewer License license.

openimageviewer's Issues

Cache text bitmap glyphs for faster text rendering

Add support for viewing 3D images in VR devices

Add rocker gestures for browsing files in folder

Export keybindings to an external settings file

Add asynchronous downscale using super-sampling

Add a GUI generator plugin for creating file save dialogs

Open the first image once a folder is being dragged into the app main window

Open the first image once a folder is being dragged into the app main window.
Currently this shows an error.

Export mouse control to the json configuration file

Keyboard mapping is already exported to configuration file, add also the ability to remap mouse actions

Extend the frame limiter capabilities

Currently the frame limiter is doing its job in keeping framerates at or below the monitor frequency.
But sometimes on a weak GPUs when using 4K or 8K monitors, the PC can't keep up with rendering.
That makes the software non-interactive, like playing a game in 10 FPS.

Suggestion:

Extend the frame limiter to limit frame rates according to the moving average of the render time or any other suitable technique.

Also add a frame limiter mode two configuration entries.

1. Frame limiter max FPS mode

• No Limit - Frame rates are not capped, may reduce perceived latency on low frequency monitors.
• Monitor frequency (default) - Maximum FPS would match the currently active monitor frequency.
• Custom - set maximum frame rate to a specific value. e.g. 30 FPS

2. Frame limiter dynamic capping (this suggestion)

• Off - Maximum frame rates are according to the Frame limiter max FPS mode above
• On - Maximum frame rates are according to the Frame limiter max FPS mode above but may be capped on slow GPUs.

Add support for 10 bit per channel images with compatibility to 10 bit monitors

Under Windows:
Please refer to DXGI_FORMAT_R10G10B10A2_UNORM on how to support 10 bit per channel

Add an error message when a file can't be displayed

When trying to open an unsupported file nothing happens.

Steps to reproduce:

1. Open an unsupported file(e.g. JSON file) from "file explorer" in Windows using "Open With"

Expected Behavior:
An error message is shown

Actual Behavior:
Nothing happens

Doesn't work on Windows 7 SP1

Both the provided binary file and the successfully built CMake project failed to run. Error: The program can't start because api-ms-win-shcore-scaling-l1-1-1.dll is missing from your computer. Try reinstalling the program to fix this problem.

OS: Windows 7 SP1 64-bit
Built using Microsoft Visual Studio Community 2019

UPD. Shcore is not available on Windows 7, and Windows 8.1+ is required: https://docs.microsoft.com/en-us/windows/win32/api/shellscalingapi/nf-shellscalingapi-getdpiformonitor
You should probably update the requirements: https://github.com/OpenImageViewer/OpenImageViewer#requirements

Add single key shortcuts to change the size of the window

e.g.

key '1' will change the window size to small.
key '2' will change the window size to medium.
etc...

Possible implementation:
Create a general command for changing the window size in percentage relative to the active monitor and add a customizable key bindings in the settings file.

note: the largest axis (vertical /horizontal) should be taken into consideration when determining the new window size

Create an Open Image Viewer forum

Looking for a volunteer to taking the wheel to establish, host and maintain a forum for the benefit of the project.
The forum will serve developers and users.

Our current inclination goes with NodeBB.

Add wider EXIF and XMP support

Keyboard is already exported, add also option the ability to remap mouse actions

Add option to read ahead images in the current folder

Read ahead images in the current folder and upload them to the GPU for a better experience.

Since in Open Image Viewer we have full control over the image generation pipeline, switching an image no matter how big it is would execute in less than a millisecond, or in practice immediately at the next presented frame.

Add support for cross platform GTK windowing system

Add lister plugin

Add support for Lister plugin for total commander and double commander

Replace low-level input system for better handling keyboard and mouse events

Low level Input system could be improved.
I recommend checking out the input library LInput.
It could provide coherent abstraction for keyboard mouse and even Gamepads.

Add an option to reload/ auto reload a file if it was changed.

Probably should be implemented (under windows) using file watchers.
See related issue #41

Error when opening a tiff file

When trying to open a tif file the following error occured:

Redundant redraw on initial image load

When the first image is being loaded by passing its path via the command line there's an initial redraw, then the image is being fitted to screen and centered (default behavior) follow by a second redraw.

The first redraw in this case is redundant.

Add support for multi-image Tiff

Add support for animated images such as GIF and APNG

Add more information when using the selection rectangle

Please refer the red highlights in the following image:

Add the ability to save images

Add option to hide / toggle the virtual status bar at the bottom of the window

Requests arrived for hiding the status bar as for some users it's helpful seldomly.

Add geolocation support using configurable command

Add the option to open an external application / website or other using a user configurable command to open the coordinates of where the image took place when geolocation metadata is available.

e.g. open google maps in the location where the photo took place

First page is shown upside down

Open the file attached. It shows upside down.
https://www.leadtools.com/support/forum/resource.ashx?a=544&b=1

The attached TIFF file contains 6 pages, each of which is 24 bits per pixel encoded using LZW compression.

Unsupported TIFF file

The file attached shows as not supported:
https://www.leadtools.com/support/forum/resource.ashx?a=545&b=1

The attached TIFF file contains 11 pages, each of which is encoded differently from all the other pages. The pages are, in order:
1- Uncompressed RGB
2- Uncompressed CMYK
3- JPEG 2000 compression
4- JPEG 4:1:1 compression
5- JBIG compression
6- RLE Packbits compression
7- CMYK with RLE Packbits compression
8- YCC with RLE Packbits compression
9- LZW compression
10- CCITT Group 4 compression
11- CCITT Group 3 2-D compression

Fix warnings in the project and its sub-projects

Recommended flags to use:

MSVC

use the compiler flag/W4

CLang

Enable the following warnings groups: -Wextra -Wpedantic -Wall -Wpessimizing-move

Disable the following specific warnings: -Wno-c++98-compat -Wno-c++11-compat -Wno-c++14-compat -Wno-c++98-compat-pedantic -Wno-reserved-id-macro -Wno-newline-eof -Wno-global-constructors -Wno-exit-time-destructors -Wno-float-equal -Wno-covered-switch-default -Wno-unreachable-code-break

Specific false positive warnings should be disabled locally using the precompiler macros

Add option to snap selection rectangle to pixel grid

The selection rectangle is currently in a "free flow" mode and can be placed between pixels.
it would be logical and more convenient to snap the selection area to a discrete pixel or more precisely to a discrete pixel when zoom is above 100% and to a discrete texel when zoom is less than 100%

Add multi-line user notification messages

User notification messages are being displayed in the upper left corner of the window.
When a new message arrived it replaces the currently displayed message and in many times there is not enough time to read the message before it being replaced.

The proposed solution is to push messages downwards instead of replacing them.

One point to consider is to not replace similar messages, otherwise the window will be flooded with messages and message notification would lose its purpose

Add option to register the application as the default image viewer

Improve text rendering

Text rendering is currently using standard anti-aliasing.

Suggestion
Integrate the subpixel antialiasing capabilities of FreeType

Added dedicated codec for bitmap image files

Build the embedded codecs as shared dll and have them delay loaded

Add Vulkan renderer

Refactor out Win32 windowing implementation to an external library

Add it as a sub-module to the super project

Source is incomplete / cannot build

• Source assumes the existence of LLUtils, which is not included.
• oivlib\oiv\Source\ImageUtil.h can't find Image.h, or ExoticNumbers*.h*
• CMake files assume that easyexif, FreeTypeWrapper, and ImageCode folders are all populated. I had to edit oivlib\oiv\CMakeLists.txt heavily to get CMake to be happy.

Can't Build

So many build / readme problems.

• requires GLEW, which was not mentioned
• the codecs "buildconfig.h" has been reworked, readme not updated
• git clone "OpenImageViewer", not "oiv"
• u8string - ambiguous symbol [possibly requires FreeType?]
• undefined class std::experimental::filesystem::v1::path
• the command line is "msbuild oiv.sln", and the full path isn't required if you use the
  "developer command prompt for visual studio"

So far, but I'm giving up here.

Create an installer

Create A Windows installer

Add option to sort files in the directory by date

Currently when opening a file, the rest of the files in the directory are loaded and sorted by name for browsing.

Suggestion: add the option to sort the files by date

Add build support for all codecs

Windows halts when changing to full-screen

The system halts when changing to full-screen not on the primary monitor.
HARD-RESET seems the only way for getting back to a working state.

How to reproduce:

1. Drag the window (no need to load an image) to one of the secondary monitors.
2. Press and hold Alt-Enter.

This will rapidly toggle full-screen mode and will halt the system in a very short time.

After preliminary debugging, these are my findings:

It appears to be a vulnerability in the DWM (desktop window manager) when using DXGI_SWAP_EFFECT_FLIP_DISCARD.

The bug was reproduced with the following setup:

OS:

Windows 10 2004 19041.388

Active GPUs

Primary: Geforce GTX660 TI
Secondary: Intel HD Graphics 4000

Active monitors - (all connected to the primary GPU)

Monitor 1: Display Port 2560x1440x59.94Hz (secondary monitor)
Monitor 2: DVI dual link 1920x1080x144Hz (primary monitor)
Monitor 3: HDMI 1280x1024x60Hz(secondary monitor)

• When changing the frequency of the primary monitor to 60HZ the Bug doesn't reproduce

Add an option to update the active folder file list once it's changed.

See related issue #40

Add support for images with width or height larger than 16384

Add the ability to change settings via GUI

Currently to change settings one needs to edit the json file manually.

Suggestion
Add an optional pluginable GUI subsystem for changing settings.
Since it's not an integral part of the program, writing it in C++ is not mandatory

Add support for multi-size icons (ico) files

Add Direct3D12 renderer