GitHub - clyde7/iv: A simple image viewer

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
.gitignore		.gitignore
LICENSE		LICENSE
Makefile		Makefile
README		README
action.c		action.c
action.h		action.h
array.c		array.c
array.h		array.h
bob_image.c		bob_image.c
box.c		box.c
box.h		box.h
color.c		color.c
color.h		color.h
debug.c		debug.c
debug.h		debug.h
error.c		error.c
error.h		error.h
exr_image.cc		exr_image.cc
extensions.txt		extensions.txt
file.c		file.c
file.h		file.h
file_image.c		file_image.c
file_image.h		file_image.h
font.c		font.c
font.h		font.h
gen_c.sh		gen_c.sh
gen_ext.c		gen_ext.c
gen_ext.h		gen_ext.h
gen_h.sh		gen_h.sh
geometry.c		geometry.c
geometry.h		geometry.h
gif_image.c		gif_image.c
glext.h		glext.h
glut.h		glut.h
half.c		half.c
half.h		half.h
image.c		image.c
image.h		image.h
image_process.c		image_process.c
image_process.h		image_process.h
iv.c		iv.c
jpeg_image.c		jpeg_image.c
kernel.c		kernel.c
kernel.h		kernel.h
list.c		list.c
list.h		list.h
math.c		math.c
math_.h		math_.h
matrix.c		matrix.c
matrix.h		matrix.h
memory.c		memory.c
memory.h		memory.h
mpo_image.c		mpo_image.c
opengl.h		opengl.h
palette.c		palette.c
palette.h		palette.h
parametric_curve.c		parametric_curve.c
parametric_curve.h		parametric_curve.h
pic_image.c		pic_image.c
pixel_map.c		pixel_map.c
pixel_map.h		pixel_map.h
pixel_transfer.c		pixel_transfer.c
pixel_transfer.h		pixel_transfer.h
png_image.c		png_image.c
pnm_image.c		pnm_image.c
primitives.h		primitives.h
print.c		print.c
print.h		print.h
property.c		property.c
property.h		property.h
quaternion.c		quaternion.c
quaternion.h		quaternion.h
raw_image.c		raw_image.c
screen.c		screen.c
screen.h		screen.h
size.c		size.c
size.h		size.h
sizes.c		sizes.c
string.c		string.c
string.h		string.h
svg_colors.c		svg_colors.c
system.c		system.c
system.h		system.h
test_image.c		test_image.c
texture.c		texture.c
texture.h		texture.h
tga_image.c		tga_image.c
tiff_image.c		tiff_image.c
time.c		time.c
time_.h		time_.h
utils.h		utils.h
variable.c		variable.c
variable.h		variable.h
vector.c		vector.c
vector.h		vector.h
viewport.c		viewport.c
viewport.h		viewport.h
volume.c		volume.c
volume.h		volume.h

Repository files navigation

iv -- Image Viewer

iv is a simple image viewer I developed during my PhD. iv belonged to a graphics library called cuboid, which was a kitchen sink for anything related to my research. Thus, most of the source code is research quality: no documentation or comments, plenty of dead code and bugs. Unaware of the internals, many students in my lab found the tool useful. As I will likely not have much time to maintain the source in the future, I decided to open source it. It is known to build under Ubuntu and Mac OS using MacPorts, the Cygwin port is out-of-date.

The main reason to develop this viewer was to create a usable image viewer which supports OpenEXR images. Besides EXR, iv supports GIF, JPEG, PNG, PNM/PGM/PPM, and TIFF. A key feature of this viewer is that it allows to load many images simultaneously and switch around, and zoom into an image down to the individual pixels. When pixels become large enough, it displays its content, namely coordinates and color values.


PREREQUISITES

    standard image libraries: OpenEXR, libpng, libgif, libjpeg, libtiff, ...
    on Ubuntu, install the microsoft fonts


BUILDING

    make


USAGE
 
    iv [options] <files>


OPTIONS

    -h, --help                   usage
    -v, --verbose                verbose output
    -bg, --background <color>    specify alternative background color
    -F, --fullscreen             start in fullscreen
    -fc, --false-colors          start in false colors mode (grayscale)
    -g, --gamma <gamma value>    specify a gamma value
    -c, --contrast <contrast>    scale pixel values by contrast value
    -s, --scale <scale>          zoom with scale factor
    -f, --filter                 start with bilinear pixel filter
    -p, --play                   play slideshow
    -d, --delay <delay>          slideshow delay between images in seconds
    -hl, --highlight <region>    mark a rectangular area in the image
    -pr, --precision <precision> specify number of digits for color values


MOUSE

    left button: panning
    mouse wheel: zoom by factor sqrt(2)


KEYBOARD

    Esc           quit the viewer
    Home          select first image
    End           select last image
    Left/Right    select previous/next image
    Page Down/Up  move forward/backward by 10 images
    1, 2, ... 0   select among first 10 images
    P             prints properties of current image
    D             computes a diff between current and next image
    C             center the image
    g             toggle false colors for grayscale images
    G             toggle gamma value between 1 and 2.2
    -, +/=        decrease/increase contrast by factor 2
    l, L          cycle through image layers
    c             cycle through color channels
    h, v          flip horizontaly or vertically
    w, W          zoom to fit width, height of window
    s, S          zoom by factor sqrt(2)
    f             toggle bilinear pixel filter
    F, F11        toggle fullscreen
    R             reset contrast, zoom, panning, and channel
   

Claude Knaus
claude.knaus@gmail.com