gif2epsn(1) [debian man page]
gif2bgi(1) General Commands Manual gif2bgi(1) NAME
gif2epsn - A program to dump images saved as GIF files on Epson type printers. USAGE
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. MEMORY REQUIRED
Screen. OPTIONS
[-q] Quiet mode. Default off on MSDOS, on under UNIX. Controls printout of running scan lines. Use -q- to invert. [-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. [-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%. [-m map] Select method to map colors to B&W. Mapping can be: 0 Every none background color is considered foreground (white color but is drawn as black by printer, unless -i is specified). 1 If 0.3 * RED 0.59 * GREEN 0.11 * YELLOW > BW the pixel is considered white color. 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. [-i] Invert the image, i.e. black -> white, white -> black. [-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. [-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. [-h] print one line of command line help, similar to Usage above. 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. AUTHOR
Gershon Elber Man page created by T.Gridel <tgridel@free.fr>, originally written by Eric S. Raymond <esr@thyrsus.com> giflib-tools gif2bgi(1)
Check Out this Related Man Page
icon2gif(1) General Commands Manual icon2gif(1) NAME
icon2gif - A program to convert a series of editable text GIF icon specifications and named GIF files into a multi-image GIF, usable as a graphic resource file. It can also dump existing GIFs in this format. USAGE
icon2gif [-q] [-a] [-d] [t TranslationTable] [-h] gif-file... If no gif-file is given, icon2gif will try to read a text input from stdin. Specification Syntax Here is a syntax summary in informal BNF. The token `NL' represents a required newline. <gif-spec> ::= <header-block> <image-block>... <header-block> ::= <header-declaration>... <header-declaration ::= | screen width <digits> NL | screen height <digits> NL | screen colors <digits> NL | screen background <digits> NL | screen map <color-table> NL <color-table> ::= <color-declaration>... end NL <color-declaration> ::= rgb <digits> <digits> <digits> is <key> NL <image-block> ::= include <file-name> NL | image NL <image-declaration>... <raster-picture> [ <extension> ] <image-declarations> ::= image top <digits> NL | image left <digits> NL | image interlaced NL | image map <color-table> NL | image bits <digits> by <digits> NL <raster-block> <extension> := <comment> NL <extension-block> NL end NL | <plaintext> NL <extension-block> NL end NL | extension <hex-digits> NL <exten- sion-block> NL end NL If the semantics of the `screen height', `screen width', `screen background', `image top', `image left' declarations aren't obvious to you, what are you doing with this software? A color table declares color indices (in ascending order from 0) and assiciates them with key characters. These characters can later be used in raster blocks. As these must be printable and non-whitespace, you can only specify 94 colors per icon. Life is like that some- times. A raster block is just a block of key characters. It should be sized correctly for the `image bits' declaration that leads it. The `comment' or `plaintext' keywords lead defined GIF89 extension record data (the other two GIF89 types, graphics control and application block, are not yet supported). You can also say `extension' followed by a hexadecimal record type. All of these extension declarations must be followed by an extension block, which is terminated by the keyword `end' on its own line. An extension block is a series of text lines, each interpreted as a string of bytes to fill an argument block (the terminating newline is stripped). Text may include standard C-style octal and hex escapes preceded by a backslash. All <digits> tokens are interpreted as decimal numerals; <hex-digits> tokens are interpreted as two hex digits (a byte). All coordinates are zero-origin with the top left corner (0,0). Range checking is weak and signedness checking nonexistent; caveat hacker! In general, the amount of whitespace and order of declarations within a header or image block is not significant, except that a raster pic- ture must immediately follow its `image bits' bits declaration. The `include' declaration includes a named GIF as the next image. The global color maps of included GIFs are merged with the base table defined by any `screen color' declaration. All images of an included multi-image GIF will be included in order. Comments may be preceded with `#' and will be ignored. MEMORY REQUIRED
For the compilation mode, proportional to the size of the input file. For dumping, proportional to the line size of the widest GIF. OPTIONS
[-q] Quiet mode. Defaults off on MSDOS, on under UNIX. Controls printout of running scan lines. Use -q- to invert. [-d] Dump the input GIF file(s) into the text form described above. [-t] Specify name characters to use when dumping raster blocks. Only valid with -d option. [-h] Print one line of command line help, similar to Usage above. BUGS
Because there are only 94 characters unambiguously usable for raster blocks, an attempt to dump a GIF with a larger color map will fail. Error checking is rudimentary. Example: A sample icon file called `sample.ico' is included in the pic directory. AUTHOR
Eric S. Raymond <esr@snark.thyrsus.com> Man page created by T.Gridel <tgridel@free.fr>, originally written by Eric S. Raymond <esr@thyrsus.com> giflib-tools icon2gif(1)