Code Monkey home page Code Monkey logo

simple-viewer-gl's Introduction

Simple Viewer GL

GitHub License GitHub Release GitHub commits since latest release (development)

GitHub language count GitHub top language GitHub code size in bytes GitHub commit activity

Branch Build status
master Build status: master GitHub last commit (branch)
development Build status: development GitHub last commit (branch)

Simple Viewer GL is a simple and tiny image viewer based on OpenGL.

The primary goal for writing Simple Viewer GL is to create an image viewer, which only has the most basic features required for fast image viewing. It has some vi-like key bindings and works nicely with tiling window managers (such as Ion3 and Notion).

Supported formats: PNG, JPEG, JPEG 2000, PSD, AI, EPS, XCF (GIMP image format), GIF, SVG, TIFF, TARGA, ICO, ICNS (Apple Icon Image), BMP, PNM, DDS, XWD, SCR (ZX-Spectrum screen), XPM, WebP, OpenEXR.


Screenshots

Simple Viewer GL on macOS with Pixel Info Simple Viewer GL on macOS with EXIF


Features

  • Lightweight and fast: utilize hardware-accelerated video card;
  • Support embedded ICC profiles;
  • GIF animation support;
  • GIMP XCF support;
  • Adobe PSD format support;
  • Adobe AI, EPS formats preview support;
  • SVG format support;
  • Exif support;
  • Very simple interface;
  • Suitable for default image viewer for the desktops and laptops;
  • Minimal lib dependency: look library requirements below;
  • Desktop independent: doesn't require any specific desktop environment;
  • Open source, licensed under GNU GPL;

Usage

Simple Viewer GL has two modes of operation: image viewer and image info mode. The default is image mode, in which only the current image is shown. In image info mode pixel info and rectangular selection available. This mode useful for brief resource description.


Key bindings

Hotkey Action
<esc> exit
<space> next image
<backspace> previous image
<home> first file in list
<end> last file in list
<+> / <-> scale image
<1>...<0> set scale from 100% to 1000%
<enter> switch fullscreen / windowed mode
<h> / <l> pan left / right in pixels
<j> / <k> pan down / up in pixels
<shift> + <h> / <l> pan left / right in percents
<shift> + <j> / <k> pan down / up in percents
<del> toggle deletion mark
<ctrl> + <del> delete marked images from disk
<r> rotate clockwise
<shift> + <r> rotate counterclockwise
<pgup> / <bgdn> previous /next subimage
<s> fit image to window
<shift> + <s> toggle 'keep scale' on image load
<c> hide / show chequerboard
<i> hide / show on-screen info
<e> hide / show exif
<p> hide / show pixel info
<b> hide / show border around image
<g> hide / show image grid
<?> hide / show keybindings popup

Download and build from sources

You can browse the source code repository on GitHub or get a copy using git with the following command:

$ git clone https://github.com/andreyugolnik/simple-viewer-gl.git
$ cd simple-viewer-gl
$ make release

On success sviewgl binary produced in current directory. Just symlink it ln -s /path/to/sviewgl /usr/bin/sviewgl or copy it cp /path/to/sviewgl /usr/bin/.

Slackbuild by saahriktu. Gentoo ebuild by imul


Make DEB package

Update and install required dependencies:

$ sudo apt-get update
$ sudo apt-get install g++ make build-essential debhelper cmake pkg-config libgl1-mesa-dev
$ sudo apt-get install libxrandr-dev libxcursor-dev libfreetype6-dev libjpeg-dev
$ sudo apt-get install libtiff-dev libgif-dev liblcms2-dev libimlib2-dev libwebp-dev
$ sudo apt-get install libglfw3-dev libexif-dev libilmbase-dev libopenexr-dev

Clone and make DEB:

$ git clone https://github.com/andreyugolnik/simple-viewer-gl.git
$ cd simple-viewer-gl
$ make deb

You can purge installed packages with apt-get purge PACKAGE_NAME && apt-get autoremove


Make RPM package

Update and install required dependencies:

$ sudo dnf install gcc-c++ make cmake mesa-libGL-devel glfw-devel freetype-devel
$ sudo dnf install libpng-devel libjpeg-turbo-devel libtiff-devel giflib-devel lcms2-devel
$ sudo dnf install libwebp-devel libexif-devel imlib2-devel zlib-devel ilmbase-devel OpenEXR-devel

Clone and make source for RPM:

$ git clone https://github.com/andreyugolnik/simple-viewer-gl.git
$ cd simple-viewer-gl
$ sudo make rpm

Dependencies

Name Debian package Description / Notes
CMake cmake Cross-platform family of tools designed to build, test and package software.
GLFW3 libglfw3-dev Multi-platform library for creating windows with OpenGL contexts and receiving input and events.
JPEG libjpeg-dev JPEG format support.
PNG libpng12-dev PNG format support.
Little CMS 2 liblcms2-dev Color management engine supporting ICC profiles.
Zlib zlib1g-dev Compression support.
Exif libexif-dev Exif support.
X11 libxrandr-dev, libxcursor-dev X11 related libraries (Linux only)
GIF libgif-dev (Optional) GIF format support.
TIFF libtiff5-dev (Optional) TIFF format support.
WebP libwebp-dev (Optional) WebP format support.
OpenEXR libilmbase-dev, libopenexr-dev (Optional) OpenEXR is a high dynamic-range (HDR) image file format developed by Industrial Light & Magic for use in computer imaging applications.
OpenJPEG libopenjpeg-dev, (Optional) JPEG 2000 support.
ImLib2 libimlib2-dev (Optional) Common formats support.
curl libcurl-dev (Optional) Support loading via http/https/ftp protocols.
Copyright © 2008-2024 Andrey A. Ugolnik. All Rights Reserved.
https://www.ugolnik.info
[email protected]

Icon was created by
Iryna Poliakova ([email protected]).

simple-viewer-gl's People

Contributors

andreyugolnik avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.