.TH vgif "" "" "Command"
.PC "Display GIF files on the COHERENT console"
\fBvgif [\fIfilename\^\fB] [\fImode\^\fB] [\fIskip\^\fB]\fR
.PP
.HS
Options:
.IC \fIfilename\fR
Name of GIF file; \fBstdin\fR read by default
.IC \fImode\fR
Mode in which image is displayed; G320\(mu200\(mu256 used by default
 .IC \fIskip\fR
Skip factor to use; default is one.
.HE
.II "VGA graphics"
.II "GIF images"
.II "graphics^VGA"
.II "images^GIF"
Command
.B vgif
displays GIF images on the \*(CO console,
should that console consist of a VGA card and tube.
.PP
.I image
names the file that holds the GIF image.
By default,
.B vgif
reads the standard input.
.PP
.I mode
gives the graphics mode in which to display the image.
.B vgif
(actually, the graphics library
.BR libvga )
recognizes the following graphics modes:
.DM
	G320x200x256
	G320x240x256
	G360x480x256
	G640x200x16
	G640x350x16
	G640x480x16
.DE
.PP
where the first number gives the X factor, the second number the Y factor,
and the third gives the number of bits per pixel.
By default,
.B vgif
uses the mode G320\(mu200\(mu256.
.PP
.I skip
gives the skip factor.
The skip factor is the number of lines to skip when displaying the image.
A value of two reduces the size of the image to one half the
original size; three to one third; and so on.
.SH Commands
.B vgif
recognizes the following commands:
.DS
	\fBj\fR	Pan down a small amount
	\fBJ\fR	Pan down a large amount
	\fBk\fR	Pan up a small amount
	\fBK\fR	Pan up a large amount
	\fBh\fR	Pan left a small amount
	\fBH\fR	Pan left a large amount
	\fBl\fR	Pan right a small amount
	\fBL\fR	Pan right a large amount
	\fBR\fR	Make image more red
	\fBr\fR	Make image less red
	\fBG\fR	Make image more green
	\fBg\fR	Make image less green
	\fBB\fR	Make image more blue
	\fBb\fR	Make image less blue
	\fBo\fR	Restore original palette
	\fB=\fR	Equalize palette
	\fB+\fR	Make image brighter
	\fB-\fR	Make image darker
	\fBq\fR	Quit
.DE
.PP
If you press
.BR <esc> ,
.B vgif
returns the screen to character mode.
The screen remains in character mode until you press another key.
While the screen is in character mode, you can invoke another virtual
console and do work; then return to the virtual console from which you
invoked
.BR vgif ,
press a key, and return to graphics mode.
.B vgif
will automatically redisplay your image on the screen.
.SH "See Also"
.B
commands,
libvga
.R
.SH Notes
.B vgif
understands interlaced GIFs.
.PP
.B vgif
will not reduce palettes for you.
If you attempt to display a 256-color GIF in 16-color mode,
.B vgif
displays a warning message and exit.
.PP
.II "Pulley, Harry"
.B vgif
was written by Harry C. Pulley, IV (hcp@csx.cciw.ca).
.PP
.B vgif
with a scale factor does not work with interlaced GIFs, e.g.
.DM
	vgif challenger \fImode\fP 2
.DE
.PP
does not work.
This will be corrected in the next release..PP
GIF and ``Graphics Interchange Format'' are trademarks of
Compuserve, Incorporated, an H&R Block Company.
