bionic (1) gifview.1.gz

NAME

       gifview - displays GIF images and animations on the X window system

SYNOPSIS

       gifview [--display display] [options] [filenames and frames]...

DESCRIPTION

       gifview  displays  GIF  image  files  on workstations and terminals running the X Window System.  gifview
       understands multi-image GIFs, which can be displayed either as slideshows or as animations.

INTERACTION

       gifview windows recognize several keystrokes and button commands. Many of them are only useful for multi-
       image GIFs.

       Space or n  Go to the next frame.

       b or p      Go to the previous frame.

       r or <      Go to the first frame.

       >           Go to the last frame.

       ESC         Stop the animation.

       s or a      Toggle between animation and slideshow mode.

       u           Toggle between normal and unoptimized mode.

       Backspace   Delete this window.

       q           Quit gifview.

       Left-clicking on a window goes to the next frame; right-clicking on a window deletes that window.

COMMAND LINE

       gifview's  command  line  consists of GIF input files and options.  Most options start with a dash (-) or
       plus (+); frame selections, a kind of option, start with a number sign (#). Anything else is a GIF  input
       file.

       gifview  displays  one  window for each GIF input file you specify. If no GIF input file is given, or you
       give the special filename `-', it reads from the standard input.

OPTIONS

       --animate, -a
            Animate multi-image GIFs by default. Normally, multi-image GIFs first appear in slideshow mode.  You
            can always use the `a' keystroke to toggle between modes. This option has a converse, `--no-animate'
            or `+a'.

       --unoptimize, -U
            Display multi-image GIFs as ``unoptimized'', which shows a faithful representation of  what  a  user
            will  see  at  each  frame  of  an  animation.  See  gifsicle(1)  for a more detailed description of
            unoptimization. This option has a converse, `--no-unoptimize' or `+U'.  GIFs  are  always  displayed
            unoptimized in animation mode.

       -d display
       --display display
            Sets the X display to display.  This option must come before any GIF files.

       --name name
            Sets  the  application  name  under which resources are found, rather than the default of "gifview".
            Since gifview itself does not use the resource database, this is  mostly  useful  for  communication
            with your window manager.

       --geometry geometry
            Set  the size and position of gifview's windows. This is a standard X option. At most one --geometry
            option can be given per window (that is, per input GIF file).

       --title title
            Sets the gifview window's title. The  default  is  "gifview",  followed  by  information  about  the
            currently displayed file and frame.

       -w window
       --window window
            Display  the  next GIF input in an existing X window, instead of making a new top-level window. This
            way, you can use gifview to display animated GIFs in a window you created with another program.  The
            window  argument  should be an integer (gifview will use that window ID) or `root' (gifview will use
            the root window).

       --new-window window
            Display the next GIF input in a new child of an existing X window. This child window will  disappear
            when  gifview  exits.  The window argument should be an integer (gifview will use that window ID) or
            `root' (gifview will use the root window).

       --install-colormap, -i
            Use a private colormap for each window (if  you  are  using  a  PseudoColor  display).  This  avoids
            polluting the existing colormap, and may produce better results if your colormap is full, but causes
            annoying colormap flashing.

       --background color
       --bg color
            Set the background color, which is used for transparent pixels.

       --min-delay delay
            Set the minimum delay between frames to delay, which is measured in hundredths of a second.  Default
            is 0.

       --fallback-delay delay
            Set the frame delay of GIFs that do not specify a delay value or have a delay of 0.  The final value
            is still subject to the value of --min-delay.  Like --min-delay, delay is measured in hundredths  of
            a second. Default is 0.

       --no-interactive, +e
            Don't pay attention to mouse buttons or keystrokes.

       --memory-limitlim
            Cache at most lim megabytes of images in memory when animating. Default is 40.

       --help
            Print usage information and exit.

       --version
            Print the version number and some quickie warranty information and exit.

   Frame Selections
       A  frame  selection  tells gifview which frame to initially display from the current input file. They are
       useful only for animations, as non-animated GIFs only have  one  frame.  Frame  selections  can  only  be
       displayed in slideshow mode.

       #num         Select  frame num. (The first frame is `#0'.  Negative numbers count backwards from the last
                    frame, which is `#-1'.)
       #name        Select the frame named name.

       If you give two or more frame selections, you will get one window per frame selection.

SEE ALSO

       gifsicle(1)

BUGS

       Please email suggestions, additions, patches and bugs to ekohler@gmail.com.

AUTHORS

       Eddie Kohler, ekohler@gmail.com
       http://www.read.seas.harvard.edu/~kohler/

       http://www.lcdf.org/gifsicle/
       The gifsicle home page.