iv

Langue: en

Version: 112006 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

iv - Image Viewer

SYNTAX

iv [files] [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.

OPTIONS

-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>
Set 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 on 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.
-k
Same as --auto_hide_iv_nonimage.
--simple_title
Displays a simple less-graphical title on startup (instead of the standard graphical one).
--help
Prints the help screen and then exits.
--version
Prints 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 absolute path to the user's home directory.
TMPDIR
Specifies the path to the tempory files directory.

WMCLASS NAMES

IV
Class name
imgview
Image Viewer Window name
fileview
File Viewer Window name
dialog
All Dialogs name
fileselection
File Selection Dialog name

RETURN VALUES

0
Success.
1
General error.
2
Bad value, corrupt/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

Viewing operations:

DragButton1
Translate.
DragButton2
Zoom.
Button3
Menu.
ALT + DragButton1
Zoom.
CTRL + ALT + Button1
Color probe.
CTRL + SHIFT + DragButton1
Crop rectangular.
SHIFT + DragButton1
Zoom to rectangular area.
ALT + Button2
Zoom one to one.
SHIFT + Button2
Zoom to fit in view window.

Grab operations:

Button1
Grab a single window.
DragButton2
Grab a rectangular area.
Button3
Abort the grab.

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

KEYBOARD

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/