https://github.com/myint/image-view

Displays images (PNM, PNG, JPEG, etc.) conveniently from the terminal
https://github.com/myint/image-view

Last synced: 3 days ago
JSON representation

Displays images (PNM, PNG, JPEG, etc.) conveniently from the terminal

• Host: GitHub
• URL: https://github.com/myint/image-view
• Owner: myint
• Created: 2014-04-04T14:02:15.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2014-09-06T15:07:05.000Z (about 10 years ago)
• Last Synced: 2024-10-31T21:35:46.482Z (13 days ago)
• Language: Python
• Homepage: https://pypi.python.org/pypi/image-view
• Size: 570 KB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
==========

image-view

==========

.. image:: https://travis-ci.org/myint/image-view.png?branch=master

    :target: https://travis-ci.org/myint/image-view

    :alt: Build status

``image-view`` displays images (PNM, PNG, JPEG, etc.) using ``pygame``.

The primary motivation is to support viewing PNM images on OS X. Particularly,

it is useful if there are a series of images captured from a camera

(``captured-00*.pgm``), and you want to display a subset of them.

Installation

============

First install the ``pygame`` dependency somehow. One option is to use this

fork, which avoids X11 on OS X::

    $ pip install --upgrade git+https://github.com/myint/pygame

Then install the actual program::

    $ pip install --upgrade image-view

Usage

=====

Typical usage::

    $ image-view captured-070*.pgm

1. Use the left and right arrow keys to navigate through images.

2. Use ``+``/``-`` keys to scale the image. Press ``0`` to reset.

Options::

    usage: image-view [-h] [--colorize] [--little-endian] [--version]

                      files [files ...]

    positional arguments:

      files            paths to images

    optional arguments:

      -h, --help       show this help message and exit

      --colorize       color 16-bit PGM images with a rainbow gradient

      --little-endian  interpret 16-bit PGM images as little endian; this is the

                       opposite of Netpbm (and ImageMagick)

      --version        show program's version number and exit

Example screenshot

==================

.. image:: https://raw.githubusercontent.com/myint/image-view/master/screenshot.png

    :alt: screenshot

    :align: center