packages icon



 qiv(1)                     qiv version 2.1-pre11                     qiv(1)
 X Tools                                                             X Tools

                                 23 Apr 2007



 NAME
      qiv - a fast gdk/imlib image viewer for X.  Version: 2.1-pre11,
      released on 25.04.2007 by Adam Kopacz / KLOGRAFX.DE Network
      http://www.klografx.net/qiv/ - adam.k@klografx.de

 SYNOPSIS
      qiv [options] file ...

 DESCRIPTION
      qiv is an image viewer developed with gdk/imlib. As a result, qiv is
      faster than traditional image viewers such as xv or xli.

 OPTIONS
      -h, --help
           Print out a brief help message.

      --display disp
           Open qiv window on display disp.

      -F, --file file | stdin
           Read file names from file or stdin, one name per line. This
           option can be specified multiple times to read from several
           files, and will not affect other file names passed on the
           command-line.

      -u, --recursivedir dir
           Recursively include all files from dir. This option can be
           specified multiple times to include from several directories, and
           will not affect other file names passed on the command-line.

      -e, --center
           Disable window centering.

      -w, --fixed_width x
           Window with fixed width x.

      -W, --fixed_zoom x.
           Window with fixed zoom factor (percentage x).

      -x, --root file
           Set file as the current desktop background (centered) and exit.

      -y, --root_t file
           Set file as the current desktop background (tiled) and exit.

      -z, --root_s file
           Set file as the current desktop background (stretched) and exit.

      -m, --maxpect



                                    - 1 -           Formatted:  July 7, 2022






 qiv(1)                     qiv version 2.1-pre11                     qiv(1)
 X Tools                                                             X Tools

                                 23 Apr 2007



           Expand image(s) to fit screen size while preserving aspect ratio.

      -t, --scale_down
           Shrink image(s) which are larger than screen size to fit.

      -b, --brightness x
           Set brightness to x (-32..32).

      -c, --contrast x
           Set contrast to x (-32..32).

      -g, --gamma x
           Set gamma to x (-32..32).

      -n, --no_filter
           Disable filtering of images by extension. Normally, qiv will only
           load images with an image extension such as .jpg, .png, .gif ...
           This option lets you load any file as an image.

      -i, --no_statusbar
           Disable statusbar.

      -I, --statusbar
           Enable statusbar.

      -p, --transparency
           Enable transparency for transparent images.

      -a, --do_grab
           Grab the pointer in windowed mode.

      -G, --disable_grab
           Disable grabbing the pointer/kbd in fullscreen mode. Useful e.g.
           if qiv displays images on a display other than where it was
           invoked from. Use with caution!

      -v, --version
           Print version information.

      -o, --bg_color x
           Set root background color to named color x or 24 bit hex RGB
           triple in the format #RRGGBB.

      -s, --slide
           Start slideshow immediately. This can also be used for the
           desktop background (x/y/z).

      -r, --random
           Randomize slideshow.



                                    - 2 -           Formatted:  July 7, 2022






 qiv(1)                     qiv version 2.1-pre11                     qiv(1)
 X Tools                                                             X Tools

                                 23 Apr 2007



      -R, --readonly
           Disable the deletion feature.

      -S, --shuffle
           Shuffle images (random order with next/previous functionality).

      -d, --delay x
           Set slideshow delay to x seconds.

      -f, --fullscreen
           Use fullscreen window on start-up.

      -P, --ignore_path_sort
           Sort all the image files by just their filename, ignoring the
           path.

      -M, --merged_case_sort
           Sort all the image files in merged-case order (AaBbCc...).

      -N, --numeric_sort
           A "smart" numeric sort that attempts to sort filenames with
           numbers in a logical manner.  For instance: 2.jpg sorts before
           10.jpg; 1foo.jpg through 10foo.jpg sorts after 1bar.jpg through
           15bar.jpg (because "foo" comes after "bar"); and baz0001.jpg
           through baz0010.jpg sorts after baz01.jpg through baz99.jpg
           (because the longer group of zero-padded digits indicates that
           they shouldn't be intermingled).

      -D, --no_sort
           Do not apply any sorting to the list of files.

      -T, --watch
           Reload the image if it has changed on disk.

      -A, --select_dir dir
           Store the selected files in dir (default is .qiv-select).

      -X, --xineramascreen x
           Use screen x as preferred Xinerama screen

 EXAMPLES
      qiv -atsd2 *.jpg
      qiv --maxpect --root image.png
      qiv --maxpect --slide --random --delay=2 *
      qiv --maxpect --scale_down --slide --delay=2 `find / *`
      qiv --bg_color 0000FF --root image.png
      qiv --bg_color blue --root image.png

 KEYS



                                    - 3 -           Formatted:  July 7, 2022






 qiv(1)                     qiv version 2.1-pre11                     qiv(1)
 X Tools                                                             X Tools

                                 23 Apr 2007



      space/left mouse/wheel down        next picture
      backspace/right mouse/wheel up     previous picture
      PgDn                               5 pictures forward
      PgUp                               5 pictures backward
      q/ESC/middle mouse                 exit

      0-9                run 'qiv-command <key> <current-img>'
      ^...<return>       run 'qiv-command ^... <current-img>' where ... can be any string
      ?/F1               show keys
      F11/F12            in/decrease slideshow delay (1 second)
      a/A                copy picture to .qiv-select
      d/D/del            move picture to .qiv-trash (-R disables this feature)
      u                  undelete the previously trashed image
      +/=                zoom in (10%)
      -                  zoom out (10%)
      e                  center mode on/off
      f                  fullscreen mode on/off
      m                  scale to screen size on/off
      t                  scale down on/off
      X                  cycle through xinerama screens
      s                  slide show on/off
      p                  transparency on/off
      r                  random order on/off
      b                  - brightness
      B                  + brightness
      c                  - contrast
      C                  + contrast
      g                  - gamma
      G                  + gamma
      o                  reset brightness, contrast, gamma
      h                  flip horizontal
      v                  flip vertical
      k                  rotate right
      l                  rotate left
      jtx<return>        jump to image number x
      jfx<return>        jump forward x images
      jbx<return>        jump backward x images
      enter/return       reset zoom and color settings
      i                  statusbar on/off
      I                  iconify window
      w                  watch file on/off
      x                  center image on background
      y                  tile image on background
      z                  stretch image on background
      <                  turn on/off magnifying window
      arrow keys                 move image (in fullscreen mode)
      arrow keys+Shift           move image faster (in fullscreen mode)
      NumPad-arrow keys+NumLock  move image faster (in fullscreen mode)




                                    - 4 -           Formatted:  July 7, 2022






 qiv(1)                     qiv version 2.1-pre11                     qiv(1)
 X Tools                                                             X Tools

                                 23 Apr 2007



 MOUSE CONTROLS
      Button 1                            next picture
      Button 1 (hold down) & Mouse-Move   moving picture
      Button 2                            quit
      Button 3                            previous picture
      Wheel Up                            next picture
      Wheel Dn                            previous picture

 DELETING
      qiv doesn't actually delete files. It creates a directory named
      ".qiv-trash" and moves the images to that directory. qiv maintains the
      directory structure of your "deleted" images.  You can also undelete
      the most recently trashed images in reverse order, which moves each
      file back into its original directory.  There is a limit to how many
      deletions can be undone, but it should be pretty large (currently 1024
      items).  Sometimes this feature might be unwanted. To prevent
      accidents you can specify the "-R" option to disable this feature.

 IMWHEEL SUPPORT
      With XFree86 3.3.2+ server, using the wheel is seen as button 4 and 5
      pressed. You only have to use "IMPS/2" or "Intellimouse" for protocol
      and add "ZAxisMapping    4 5 " in the "Pointer" section of XF86Config.
      If imwheel (a program used to emulate key pressed when wheel is used
      for program not supporting wheel), the following two lines must be add
      to imwheel config file :

      "qiv"
      @Exclude

 USER-DEFINED KEYBOARD ACTIONS
      Keys 0-9 will invoke qiv-command with the key pressed as the first
      argument and the current image filename as the second argument.  qiv-
      command is not distributed with qiv; it is to be supplied by the user.
      Thus, this feature could be enabled by placing a simple shell script
      such as the following in the command search path (for example, in the
      user's ~/bin directory):

      #!/bin/sh
      # Argument sanity checking eliminated for brevity
      case $1 in
        0|1|2|3|4|5|6|7|8|9) mkdir -f dir$1; mv "$fname" dir$1 ;;
        *) echo "unrecognized command"; exit ;;
      esac


      If the first line of the output is like "NEWNAME=xxxxxxx" then qiv
      thinks that the filename of the currently displayed image has changed
      to this new name and updates its internal filelist.  This is very
      useful when using qiv-command to rename files.



                                    - 5 -           Formatted:  July 7, 2022






 qiv(1)                     qiv version 2.1-pre11                     qiv(1)
 X Tools                                                             X Tools

                                 23 Apr 2007



      Please also see the example that came together with qiv.

 XSCREENSAVER SUPPORT
      To use qiv with xscreensaver, either type "make install-xscreensaver"
      or add the following to your ~/.Xresources:

      xscreensaver.programs: \
         /usr/bin/qiv -srfid 5 your_pix/\* \n\
         /usr/bin/qiv -srfid 5 your_other_pix/\* \n\

 AUTHORS
      Adam Kopacz             (adam.k@klografx.de)
      Andy Spiegl             (qiv.andy@spiegl.de)
      Darren Smith            (darren.smith@juno.com)
      Pavel Andreev           (paxvel@vumsoft.cz)
      Decklin Foster          (decklin@red-bean.com)
      Holger Mueller          (hmueller@hrzpub.tu-darmstadt.de)
      Scott Sams              (sbsams@eos.ncsu.edu)
      Serge Winitzki          (winitzki@geocities.com)
      Frederic Crozat         (fcrozat@mail.dotcom.fr)
      Rutger Nijlunsing       (rutger@wingding.demon.nl)
      John Knottenbelt        (jak97@doc.ic.ac.uk)
      Danny                   (dannys@mail.com)
      Tomas Ogren             (stric@ing.umu.se)
      Erik Jacobsen           (erik@openix.com)
      Alfred Weyers           (alfred@otto.gia.RWTH-Aachen.DE)
      Daniel                  (danad157@student.liu.se)
      Henning Kulander        (hennikul@ifi.uio.no)
      Ask Bjoern Hansen       (ask@valueclick.com)
      Adrian Lopez            (adrian2@caribe.net)
      Y Furuhashi             (y_furuhashi@ot.olympus.co.jp)
      Wayne Davison           (wayned@users.sourceforge.net)
      Johannes Stezenbach     (js@convergence.de)
      OEyvind Kolaas          (pippin@users.sourceforge.net)
      Matthieu Castet         (castet.matthieu@free.fr)


 MISC
      qiv homepage: http://www.klografx.net/qiv/

      Mail bug, reports and comments to Adam Kopacz <adam.k@klografx.de>

      Sending a SIGUSR1 to qiv will cause the program to flip to next
      picture. SIGUSR2 will move to previous.

      This program is covered by the GNU GPL; see the file COPYING for
      details.





                                    - 6 -           Formatted:  July 7, 2022