.\" Process this file with
.\" groff \-man \-Tascii foo.1
.\"
.TH gif2bgi 1 "giflib\-tools"

.SH NAME
gif2epsn \- 
A program to dump images saved as GIF files on Epson type printers.

.SH USAGE

.B gif2epsn [\-q] [\-d dither] [\-t bw] [\-m map] [\-i] [\-n] [\-p printer] [\-h] gif\-file


If no gif\-file is given, Gif2Epsn will try to read a GIF file from stdin.


.SH MEMORY REQUIRED

Screen.

.SH OPTIONS

.IP [\-q]

 Quiet mode.  Default off on MSDOS, on under UNIX. Controls printout
of running scan lines. Use \-q\- to invert.

.IP "[\-d dither]

 Sets size of dithering matrix, where DitherSize can be
2,3 or 4 only (for 2x2, 3x3 and 4x4 dithering matrices).  Default is 2.
Note image will be displayed in this mode only if the mapping
option (see \-m) selected this mode.

.IP "[\-t bw]

 Sets threshold level for B&W mapping in percent.
This threshold level is used in the different mappings as selected via \-m.
Default is 19%.

.IP "[\-m map]

 Select method to map colors to B&W.  Mapping can be:

.IP 0

Every none background color is considered foreground (white color but
is drawn as black by printer, unless \-i is specified).

.IP "1
 
If 0.3 * RED  0.59 * GREEN  0.11 * YELLOW > BW the pixel is
considered white color.

.IP 2

Colors are mapped as in 1, and use dithering of size as defined using
\-d option.  BWthreshold is used here as scaler.


The default is option 0.

.IP [\-i]

 Invert the image, i.e.  black \-> white, white \-> black.

.IP [\-n]

 Nicer image.  Uses double\-density feature of Epson printer.  This
takes more time (and kills your ink cartridge faster...) but results
are usually better.

.IP "[\-p printer]

 Under Unix, output goes to stdout by default; under DOS, the
default is LPT1:.  With this switch you can specify the output
target.

.IP [\-h]

 print one line of command line help, similar to Usage above.


.SH NOTES

The output has an aspect ratio of 1, so a square image will be square in
hardcopy as well.

The widest image can be printed is 640 pixels, on 8 inch paper.  You
probably will need to flip wider images, if height is less than that:
`<a href="gifflip.html">gifflip \-r x29.gif | gif2epsn'.  Wider
images will be clipped.

.SH AUTHOR

Gershon Elber


Man page created by T.Gridel <tgridel@free.fr>, originally written by Eric S. Raymond <esr@thyrsus.com>