text2gif(1)						      General Commands Manual						       text2gif(1)

NAME

       text2gif  -  A program to generate GIF images out of regular text.  Text can be one line or multi-line, and is converted using 8 by 8 fixed
       font.

USAGE

       text2gif [-q] [-s ClrMapSize] [-f FGClr] [-c R G B] [-t Text ] [-h]

       This program reads stdin if no text is provided on the command line (-t), and will dump the created GIF file to stdout.

MEMORY REQUIRED

       Line.

OPTIONS

       [-q]

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

       [-s ClrMapSize]

	      Explicitly defines the size of the color map of the resulting gif image.	Usually the image will be bicolor  with  fg  as  color	1,
	      unless [-f] is explicitly given in case the color map size will be big enough to hold it.  However it is sometimes convenient to set
	      the color map size to certain size while the fg color is small mainly so this image may be merged with another  (images  must  match
	      color map size).

       [-f FG]

	       Select  foreground index (background is always 0).  By default it is one and therefore the image result is bicolored.  if FG is set
	      to n then color map will be created with 2^k entries where 2^k > n for minimum k, assuming k <= 8.  This color map will be all zeros
	      except  this  forground  index.  This option is useful if this text image should be integrated into other image colormap using their
	      colors.

       [-c R G B]

	       The color to use as the foreground color.  White by default.

       [-t "Text"]

	       One line of text can be provided on the command line.  Note you must encapsulate the Text within  quotes  if  it  has  spaces  (The
	      quotes themselves are not treated as part of the text).  If no -t option is provided, stdin is read until end of file.

       [-h]

	       Print one line command line help, similar to Usage above.

NOTES

       There is a hardcoded limit of 100 the number of lines.

AUTHOR

       Gershon Elber

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

								   giflib-tools 						       text2gif(1)