---
name: "gif2herc"
section: "1"
platform: "linux"
package: "libungif-bin"
version: "4.1.3-2sarge1"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/gif2herc"
---

# gif2herc(1)

Program to GIF images on an IBM PC Hercules graphic card.

## NAME

gif2herc - Program to GIF images on an IBM PC Hercules graphic card.

## SYNOPSIS

gif2herc \[-q\] \[-d dither\] \[-z zoom\] \[-t bw\] \[-m map\] \[-i\] \[-b\] \[-h\] gif-file

## DESCRIPTION

A program to display images saved as GIF files on an IBM PC Hercules graphic card.  The program operates as follows:\

-

  Read GIF file header and determine size of the image.\

-

  Dynamically allocate enough memory to hold all the image internally.  One byte per pixel is always allocated, so a little bit more than width\*height (of screen, not image) bytes are required.\

-

  Reads the image in.  Interlaced images are read correctly, although they are displayed sequentially.\

-

  Display first image using the defaults as set by the command line option.\

-

  Goes to interactive mode. For full description of the interactive mode see below.

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

## OPTIONS

- **-q**

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

- **-d dither**

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

- **-z zoom**

  Sets zoom factor of the image.  Zoom factor should be power of 2 up to 256. Default is 1 (no zoom).\

- **-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 non-background color is considered foreground (white).\

  - **1**

    0\.3 \* RED + 0.59 \* GREEN + 0.11 \* YELLOW \> BWThreshold is considered white.\

  - **2**

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

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

  - **-b** Disable beeps. Every time the image is complete, or a wrong key was presses, sound is generated. The -b option disables that.

  - **-h** Print one line of command line help, similar to Usage above.

  ## Interactive mode

Once the image is displayed, the program goes into an interactive mode which recognizes the following commands:\

- **C** - get Color and position

  In this submenu, a cursor appears and the location and color of the pixel underneath it are printed. The 4 arrows may be used (shifted for faster movement) to move the cursor. Any other key will abort this submode.\

- **D** - zoom Down

  Zoom down by factor of 2 unless current zoom factor is 1.\

- **H** - Increase dither matrix size

  ...unless current size is maximum (4), in which case size is set to minimum (2).\

- **I** - Invert

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

- **M** - Method

  Increment color -\> BW mapping method, unless current method is maximum (2), in which case method is set to minimum (0).\

- **R** - Redraw

  Redraw the image.\

- **S** - print Status

  Print status of image and program.\

- **U** - zoom Up

  Zoom up by factor of 2 unless current zoom factor is 256.\

- **arrow keys**

  The 4 arrow keys can be used to pan in the desired direction, if the image overflows in that direction.  If the image fits into the screen, arrow keys are ignored.  The panning steps are 1/2 screen if not on image end.\

- **SPC** - abort

  Space bar may be used to abort current image drawing.\

- **ESC** - abort

  Escape may be used to abort current image drawing.

## SEE ALSO

[*gif2bgi*(1)](/gif2bgi/1.md), [*gif2epsn*(1)](/gif2epsn/1.md), [*gif2iris*(1)](/gif2iris/1.md), [*gif2ps*(1)](/gif2ps/1.md), [*gif2rgb*(1)](/gif2rgb/1.md), [*gif2rle*(1)](/gif2rle/1.md), [*gif2x11*(1)](/gif2x11/1.md), [*gifasm*(1)](/gifasm/1.md), [*gifbg*(1)](/gifbg/1.md), [*gifburst*(1)](/gifburst/1.md), [*gifclip*(1)](/gifclip/1.md), [*gifclrmp*(1)](/gifclrmp/1.md), [*gifcolor*(1)](/gifcolor/1.md), [*gifcomb*(1)](/gifcomb/1.md), [*gifcompose*(1)](/gifcompose/1.md), [*giffix*(1)](/giffix/1.md), [*giffiltr*(1)](/giffiltr/1.md), [*gifflip*(1)](/gifflip/1.md), [*gifhisto*(1)](/gifhisto/1.md), [*gifinter*(1)](/gifinter/1.md), [*gifinto*(1)](/gifinto/1.md), [*gifovly*(1)](/gifovly/1.md), [*gifpos*(1)](/gifpos/1.md), [*gifrotat*(1)](/gifrotat/1.md), [*gifrsize*(1)](/gifrsize/1.md), [*gifspnge*(1)](/gifspnge/1.md), [*giftext*(1)](/giftext/1.md), [*gifwedge*(1)](/gifwedge/1.md), [*icon2gif*(1)](/icon2gif/1.md), [*raw2gif*(1)](/raw2gif/1.md), [*rgb2gif*(1)](/rgb2gif/1.md), [*rle2gif*(1)](/rle2gif/1.md), [*text2gif*(1)](/text2gif/1.md)

## COPYRIGHT

The GIFLIB distribution is Copyright (c) 1997  Eric S. Raymond

## AUTHORS

Gershon Elber

Eric S. Raymond \<esr@snark.thyrsus.com\>