pqiv

Langue: en

Autres versions - même langue

Version: 07 December 2008 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

pqiv - quick image viewer

SYNOPSIS

pqiv [options] <file(s) or folder(s)>

DESCRIPTION

pqiv is a simple image viewer inspired by qiv.

OPTIONS

-i
Suppress the yellow info box in pqiv
-f
Start pqiv in fullscreen mode
-F
Make "pqiv" fade between images. Currently this does only work for images of equal size.
-s
Auto start slide show
-S
Follow symlinks. pqiv will not traverse into symlinked directories by default as this tends to lead to recursion and other problems. If this option is active, pqiv will follow symlinks. An algorithm to prevent recursion is implemented. Checking for if a symlink points out of the current node (For example symlinks to /) is not.
-n
Sort the file list using natsort. Use twice to shuffle the list.
-d n
Interval for the slideshow function, in seconds
-t
If used once: Scale small images up to fill the whole screen
If used twice: Do not shrink image(s) larger than the screen to fit
-r
Read filename(s) from STDIN.
-c
pqiv will draw this well-known chessboard background for transparent images per default. Use this option to deactivate this behaviour. If you use this option twice (and your wm supports it), it will cause the window to be transparent. Use it three times to make the window stay in the background and use it for times to also disable controls. You can make pqiv behave like a desktop widget this way.
-w
Watch open files for changes and reload them if necessary
-z n
Set initial zoom level in percent. This is only useful in conjunction with -t.
-p n
Select interpolation type for resizing operations. Valid values for n:
1: GDK_INTERP_NEAREST, copy the nearest pixel value
2: GDK_INTERP_TILES, tile the image
3: GDK_INTERP_BILINEAR, use bilinear interpolation
4: GDK_INTERP_HYPER, use hyper interpolation
-P
Set window position.
left,top: Set initial window position
off: Deactivate positioning
Defaults to center of screen.
-a <key><new-key>
Maps <key> to <new-key>. For example, "-a=+" will make "=" an alias for zooming in.
-R
Reverse the meaning of the cursor and Page Up/Down keys. For example, pressing the "down" cursor key will normally make the image move up. With this option, the image will instead move down.
-<n>
Use those options (n in 0..9) to define a command, which will be executed when you press the corresponding key in pqiv. The last occurance of "$1" will be replaced by the current file's name.
Prepend the command with > to show the command's output in a dialog window.
Prepend the command with | to let pqiv pipe the displayed image to your command and read/reload it from the command's output.
-q
Behave (mostly) like the original qiv. With this option "pqiv" will call pqiv-command n file when you press a number key n, where n will be replaced by the key you pressed and file by the name of the current image.

The contents of ~/.pqivrc will be prepended to pqiv's argv. So if you want to make an slideshow interval of 1 second the default for pqiv, put

 -d1
 
into that file.

pqiv will display all files you specified on the command line. Directories will be searched recursively for files supported by gtk+ (for example: bmp, gif, jpeg, png, wbmp, xpm, svg). Unless you specified -r the special file - will cause pqiv to read a file from stdin.

USAGE

In pqiv, you can use both mouse and keyboard to navigate through the images. Execute pqiv -h to get more information on the key bindings.

If you call pqiv without a TTY on stdin (ie. from GUI) without parameters, pqiv will pop up an "open file" dialog.

AUTHOR

 Phillip Berndt (mail at pberndt dot com)
 
The original qiv authors are listed on http://www.klografx.net/qiv/index2.html