wxyzv: yet another image viewer

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Where to find it

Source distribution: ftp://ftp.flaterco.com/wxyzv/
Copy of the README: http://www.flaterco.com/wxyzv.html

Requirements

X11R6 or equivalent
True color display at least 15 bits deep
libjpeg 6.0 or newer
libpng 0.96 or newer
C++ compiler

Features

Supports JPEG, PNG, and raw PPM with maxval=255
Provides rotation, gamma adjustment, sharpening, and nonlinear smoothing
Makes best effort on corrupted JPEGs and PNGs
Centers image on screen
Efficiently downscales oversized JPEGs

Limitations

Will not use anything but true color visual
Chokes on PNM other than raw PPM with maxval=255
PNGs with "clever" attributes will get one of the following:
- Flattened to 24-bit RGB
- Mangled
- Segmentation fault

Installation

./configure; make; make install

If necessary, you may embellish the compile and link lines by setting extracxxflags and extraldflags before running configure. For example, to search /mumble/foo/include for include files, you could do

extracxxflags="-I/mumble/foo/include" ./configure

under the Bourne shell.

Be sure to delete config.cache before rerunning configure to make sure that your changes are effective.

Usage

wxyzv file [file...]

space                            go to next image
p or P                           go back to previous image
q or Q                           quit
up arrow / mouse roller          adjust gamma (brighter)
down arrow / mouse roller        adjust gamma (darker)
left arrow / mouse button        smoother
right arrow / mouse button       sharper
r                                rotate clockwise
R                                rotate counterclockwise
f or F                           toggle JPEG scaling

Mouse roller micro-HOWTO

A typical PS/2 type mouse having a roller is made to work by putting the following in xorg.conf:

Section "InputDevice"
    Identifier	"Mouse1"
    Driver	"mouse"
    Option "Protocol"    "imps/2"
    Option "Device"      "/dev/psaux"
    Option "ZAxisMapping" "4 5"
EndSection

Under XFree86 version 3.x it used to be:

Section "Pointer"
    Protocol    "imps/2"
    Device      "/dev/psaux"
    ZAxisMapping 4 5
EndSection

For more information, see the Colas Nahaboo X mouse wheel scroll page http://www.inria.fr/koala/colas/mouse-wheel-scroll/ or check the Linux 3-Button-Mouse mini-HOWTO for updates.

Maintenance

Send bug reports to dave@flaterco.com.

There is no time budgeted to add features to this program since many full-featured alternatives already exist. In other words, "If you want xv, you know where to find it."

Change log

wxyzv 1.1 (2006-04-09)

Added rotation feature. Fixed miscellaneous code rot.

wxyzv 1.0 r2 (2005-06-16)

Documentation changes only: updated e-mail address, synced with web page.

wxyzv 1.0 (2000-01-02)

Home