1GIFVIEW(1)                  General Commands Manual                 GIFVIEW(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

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

INTERACTION

17       gifview  windows recognize several keystrokes and button commands. Many
18       of them are only useful for multi-image GIFs.
19
20       Space or n  Go to the next frame.
21
22       b or p      Go to the previous frame.
23
24       r or <      Go to the first frame.
25
26       >           Go to the last frame.
27
28       ESC         Stop the animation.
29
30       s or a      Toggle between animation and slideshow mode.
31
32       u           Toggle between normal and unoptimized mode.
33
34       Backspace   Delete this window.
35
36       q           Quit gifview.
37
38       Left-clicking on a window goes to the next frame; right-clicking  on  a
39       window deletes that window.
40

COMMAND LINE

42       gifview's  command  line consists of GIF input files and options.  Most
43       options start with a dash (-) or plus (+); frame selections, a kind  of
44       option,  start  with  a  number  sign (#). Anything else is a GIF input
45       file.
46
47       gifview displays one window for each GIF input file you specify. If  no
48       GIF input file is given, or you give the special filename `-', it reads
49       from the standard input.
50

OPTIONS

52       --animate, -a
53            Animate multi-image GIFs by default.  Normally,  multi-image  GIFs
54            first  appear  in  slideshow mode. You can always use the `a' key‐
55            stroke to toggle  between  modes.  This  option  has  a  converse,
56            `--no-animate' or `+a'.
57
58       --unoptimize, -U
59            Display  multi-image GIFs as ``unoptimized'', which shows a faith‐
60            ful representation of what a user will see at each frame of an an‐
61            imation.  See gifsicle(1) for a more detailed description of unop‐
62            timization. This option has a converse, `--no-unoptimize' or `+U'.
63            GIFs are always displayed unoptimized in animation mode.
64
65       -d display
66       --display display
67            Sets  the  X display to display.  This option must come before any
68            GIF files.
69
70       --name name
71            Sets the application name under which resources are found,  rather
72            than  the  default of "gifview". Since gifview itself does not use
73            the resource database, this is  mostly  useful  for  communication
74            with your window manager.
75
76       --geometry geometry
77            Set the size and position of gifview's windows. This is a standard
78            X option. At most one --geometry option can be  given  per  window
79            (that is, per input GIF file).
80
81       --title title
82            Sets  the  gifview  window's title. The default is "gifview", fol‐
83            lowed by information about the currently displayed file and frame.
84
85       -w window
86       --window window
87            Display the next GIF input in an existing  X  window,  instead  of
88            making  a  new  top-level window. This way, you can use gifview to
89            display animated GIFs in a window you created  with  another  pro‐
90            gram.  The  window argument should be an integer (gifview will use
91            that window ID) or `root' (gifview will use the root window).
92
93       --new-window window
94            Display the next GIF input in a new child of an existing X window.
95            This  child  window  will disappear when gifview exits. The window
96            argument should be an integer (gifview will use that window ID) or
97            `root' (gifview will use the root window).
98
99       --install-colormap, -i
100            Use a private colormap for each window (if you are using a Pseudo‐
101            Color display). This avoids polluting the existing  colormap,  and
102            may  produce  better  results if your colormap is full, but causes
103            annoying colormap flashing.
104
105       --background color
106       --bg color
107            Set the background color, which is used for transparent pixels.
108
109       --min-delay delay
110            Set the minimum delay between frames to delay, which  is  measured
111            in hundredths of a second. Default is 0.
112
113       --fallback-delay delay
114            Set  the  frame delay of GIFs that do not specify a delay value or
115            have a delay of 0.  The final value is still subject to the  value
116            of --min-delay.  Like --min-delay, delay is measured in hundredths
117            of a second. Default is 0.
118
119       --no-interactive, +e
120            Don't pay attention to mouse buttons or keystrokes.
121
122       --memory-limitlim
123            Cache at most lim megabytes of images in  memory  when  animating.
124            Default is 40.
125
126       --help
127            Print usage information and exit.
128
129       --version
130            Print the version number and some quickie warranty information and
131            exit.
132
133   Frame Selections
134       A frame selection tells gifview which frame to initially  display  from
135       the current input file. They are useful only for animations, as non-an‐
136       imated GIFs only have one frame. Frame selections can only be displayed
137       in slideshow mode.
138
139       #num         Select frame num. (The first frame is `#0'.  Negative num‐
140                    bers count backwards from the last frame, which is `#-1'.)
141       #name        Select the frame named name.
142
143       If you give two or more frame selections, you will get one  window  per
144       frame selection.
145

SEE ALSO

147       gifsicle(1)
148

BUGS

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

AUTHORS

154       Eddie Kohler, ekohler@gmail.com
155       http://www.read.seas.harvard.edu/~kohler/
156
157       http://www.lcdf.org/gifsicle/
158       The gifsicle home page.
159
160
161
162Version 1.94                     11 July 2017                       GIFVIEW(1)
Impressum