iv(1)

NAME

IV - Image Viewer

SYNTAX

iv [file(s)...] [options] [GUI_options]

DESCRIPTION

An image viewer using the GIMP Toolkit (GTK) and Image Library (Imlib).

Image Viewer (also known as IV) allows you to; view any image supported by Imlib, view text files, view binary files, save images (convert formats), grab (screenshot), print, rotate, crop, resize, display on desktop, add text (annotate), add/edit/remove comments (and other embedded content), and open/edit/save animated images.

Additional viewing features include pan & zoom with just a click and a drag.

Warning, this program may be used to view material considered "indecent" or "immoral" by some cultures or religions, keep out of the reach of children being conditioned in such cultures and religions.

The [file(s)...] specifies the paths to the file(s) to open at startup.

OPTIONS

--frame=<n>
    Display frame index <n> at startup (disables playing at startup).

-f=<n>
    Same as --frame.

-r  Do not resize window when a new image is loaded.

-m  Disable Tooltips.

-t  Hide the Tool Bar.

-v  Hide value labels.

-s  Hide the Status Bar.

-i  Show the current image on the Window Manager icon (does not work properly with some Window Managers).

-q=<n>
    Set display quality to <n>. Valid values are 0=poor/fastest 1=standard/optimul and 2=best/slowest, default value is 1.

-bg=<color>
    Sets the background color to <color>.

-b=<n>
    Sets the Imlib fallback code to <n>. Valid values are 0=no fallback and 1=use Image Magick & NETPBM, default value is 1.

--screenshot
    Map the Screenshot Dialog at startup (may not be combined with opening images at startup).

-g  Same as --screenshot.

--fullscreen=<file>
    Displays the image <file> fullscreen, waits for user response, and then exits.

-fs=<file>
    Same as --fullscreen.

--root-centered=<file>
    Displays the image <file> on the desktop centered and then exits.

--root-tofit=<file>
    Displays the image <file> on the desktop to fit and then exits.

--root-tocover=<file>
    Displays the image <file> on the desktop to cover and then exits.

--root-tiled=<file>
    Displays the image <file> on the desktop tiled and then exits.

--auto_hide_iv_nonimage
    Hide the Image Viewer window when a non-image file is opened in the File Viewer.

--print=<file>
    Map the Print Dialog to query the user to print the image <file> and then exit.

-k  Same as --auto_hide_iv_nonimage.

--simple_title
    Displays a simple less-graphical title at startup (instead of the standard graphical one).

--help
    Prints the help screen and then exits.

--version
    Prints the version information and then exits.

GUI OPTIONS

--geometry <WxH+X+Y>
    Specifies the window's geometry.

--font <fontname>
    Specifies the font to be used for value labels.

--name <name>
    Specifies the Window Manager window name.

--class <class>
    Specifies the Window Manager window class.

--title <title>
    Specifies the window's title.

FILES

/usr/bin/iv
    Program.

/usr/man/man1/iv.1.bz2
    Manual page.

/usr/shared/icons/iv.xpm
    Icon.

ENVIRONMENT VARIABLES

DISPLAY
    Specifies the host address, display number, and screen number to connect to the X server.

USERNAME
    Specifies the user's name.

USER
    Fallback for USERNAME.

HOME
    Specifies the full path to the user's home directory.

TMPDIR
    Specifies the full path to the temporary files directory.

PRINTCOMMAND
    Specifies the print command (if using lpr).

PRINTCMD
    Fallback for PRINTCOMMAND.

PRINT
    Fallback for PRINTCMD.

PRINTER
    Specifies the name of the prefered printer.

XPSERVERLIST
    Specifies the display address to the X Print server in the format of "<host>:<port>" or ":<port>" (if using X Print).

WMCLASS NAMES

IV  Class name.

imgview
    Image Viewer Window name.

dataview
    Data Viewer Window name.

dialog
    All Dialogs name.

fileselection
    File Selection Dialog name.

WIDGET NAMES

iv-imgview
    IV Image Viewer toplevel GtkWindow.

iv-dataview
    IV Data Viewer toplevel GtkWindow.

iv-dataview-text-view
    IV Data Viewer text view GtkText.

iv-dataview-hex-view
    IV Data Viewer hex view GtkWidget.

RETURN VALUES

0   Success.

1   General error.

2   Invalid value, corrupt or unsupported format, or no such file.

3   Systems error (out of memory or out of device space).

4   User aborted.

EXAMPLES

To run this program the standard way, type:

# iv &

To open an image at startup, type:

# iv myimage.png &

To open an image, display it on the Window Manager icon, and hide the toolbar, type:

# iv myimage.png -i -t &

To open an image and display it fullscreen with best quality, type:

# iv -q=2 --fullscreen=myimage.png &

To open an image directly to the desktop, resize it to cover the desktop with best quality, and then exit, type:

# iv -q=2 --root-tocover=myimage.png &

To start up with the screenshot dialog:

# iv --screenshot

POINTER OPERATIONS

Viewing operations:

Button1 Drag
    Translate.

ALT + Button1 Drag
    Zoom.

SHIFT + Button1 Drag
    Zoom to rectangular area.

CTRL + ALT + Button1
    Color probe.

CTRL + SHIFT + Button1 Drag
    Crop rectangular.

Button2 Drag
    Zoom.

ALT + Button2
    Zoom one to one.

SHIFT + Button2
    Zoom to fit in view window.

Button3
    Menu.

Button4
    Zoom Out.

Button5
    Zoom in.

Grab operations:

Button1
    Grab a single window.

Button2 Drag
    Grab a rectangular area.

Button3
    Abort the grab.

To grab the entire desktop, press Button1 over the desktop.

KEYBOARD OPERATIONS

Viewing keys:

PLUS
    Zoom in.

MINUS
    Zoom out.

PGUP
    Zoom in 4 times the increment.

PGDN
    Zoom out 4 times the increment.

HOME
    Zoom one to one.

END Zoom to fit in view window.

LEFT
    Translate left.

Right
    Translate right.

UP  Translate up.

DOWN
    Translate down.

1   Set zoom to 100%.

2   Set zoom to 200%.

3   Set zoom to 300%.

4   Set zoom to 400%.

5   Set zoom to 500%.

6   Set zoom to 600%.

7   Set zoom to 700%.

8   Set zoom to 800%.

9   Set zoom to 900%.

P   Play/pause.

S   Pause.

[   Previous frame.

B   Same as [.

]   Next frame.

N   Same as ].

Operation keys:

CTRL + B
    Set background color.

CTRL + R
    Resize image.

CTRL + T
    Add text.

CTRL + H
    Edit header.

CTRL + F
    Edit frames.

CTRL + O
    Open image.

F3  Same as CTRL + O.

SHIFT + F3
    Open file to a new File Viewer.

CTRL + S
    Save image as.

CTRL + A
    Same as CTRL + S.

CTRL + G
    Screenshot.

CTRL + I
    Image information.

CTRL + F11
    Display image fullscreen.

CTRL + D
    Display image on desktop, centered.

CTRL + ALT + D
    Display image on desktop, to fit.

CTRL + SHIFT + D
    Display image on desktop, to cover.

CTRL + T
    Display image on desktop, tiled.

CTRL + K
    Clear.

CTRL + P
    Print.

CTRL + 1
    New Image Viewer.

CTRL + W
    Close.

ESCAPE
    Same as CTRL + W.

CTRL + Q
    Close all windows.

REPORTING BUGS

http://wolfpack.twu.net/contacts.html

AUTHORS

Tara Milana
    Head programmer and graphics artist.

SEE ALSO

http://wolfpack.twu.net/IV/