Linux Manpages Online - man.cx manual pages

NAME

gFONT -- Create GIF image rendered with TeX−available Font

SYNOPSIS

gfont [−b RRGGBB] [−f RRGGBB] [−F NAME] [−G PATH] [−a NUM] [−c] [−s SPEC] [−i] [−o FILE] [−v] [STRING]

gfont [−V]

gFONT creates a GIF image for the given ASCII STRING by the use of an arbitrary TeX−available font (originating either from Postscript or METAFONT font descriptions). The used font is converted from TeX’s PK format to gFONT’s own GdF format (Gd Font) and rendered into the resulting GIF image by the use of its own enhanced Gd library. The result is intended to be included into HTML pages with an <img> tag.

The highlight is the fact that it makes use of TeX’s PK files, i.e. you can use any TeX−available font which is accessible on your system through the programs mf (METAFONT) or gsftopk (Ghostscript-Font-to-TeX−PK).

OPTIONS

−b RRGGBB , --background= RRGGBB

Sets the background color. Default is no color, i.e. transparent background.

−f RRGGBB , --foreground= RRGGBB

Sets the foreground color. Default is ’000000’ which is black.

−F NAME , --fontname= NAME

Sets the font face to name. Default is ’CMBoldface-V’ (Computer Modern Boldface). The NAME is either a METAFONT fontname or a Postscript fontname plus the point size appended with a dash. Additionally the fontname can be an alias from the file Fontmap.

Typical examples for fontnames are:

  Computer Modern Family
  (add ’F’,’T’,’S’,’L’,’H’,’V’ or nothing after dash for size):
      CMBoldface
      CMItalic
      CMRoman
      CMSansSerif
      CMTeleType

  Adobe Type Basics:
  (add ’20’, ’40’, etc. after dash for size):
      Courier
      CourierBold
      CourierOblique
      CourierBoldOblique
      Helvetica
      HelveticaBold
      HelveticaOblique
      Times
      TimesBold
      TimesItalic
      TimesBoldItalic

−G PATH , --gdf-path= PATH

Set the GdF path where gFONT should search for .gdf files.

−a NUM , --anti-alias= NUM

Applies an anti-alias filter with NUM intermediate colors. This is currently still experimental!

−c, --crop

Crops the image to its physical content edges, i.e. strip off all surrounding background pixels.

−r SPEC , --resize= SPEC

Adjusts the image to a particular result size. The parameters are given in SPEC and are of the form

   SPEC    ::= x-spec ’x’ y-spec
   x-spec  ::= [+] x-size [x-align]
   x-align ::= L⎪C⎪R
   y-spec  ::= [+] y-size [y-align]
   y-align ::= T⎪M⎪B

−i, --interlace

This enables the GIF Interlacing feature which leads to a blending effect in most Webbrowsers when the image is loaded.

−o FILE , --output-file= FILE

Forces the output to be written to FILE instead of the default output file out.gif.

−v, --verbose

Enables verbose mode.

−V, --version

Displays version identification string.

ENVIRONMENT

GFONT_BASE

The directory containing all gFONT related files, except the gfont binary and documentation (default is /usr/lib/gfont).

GDFPATH

The path variable to the GdF format files (default is /var/lib/gfont/gdf).

FILES

$ GFONT_BASE/ etc/Fontmap

File containing the correspondance between fontnames and the real font names, with the right mf: or ps: prefix.

$ GFONT_BASE/ gdf

Default location where gFONT searches for GdF files. Should usually be read-only when the next directory is not the same.

$ GDFPATH

Location where gFONT’s gfont_mkgdf utility puts on-the-fly generated GdF files. This per default is the same as the directory but has not to be.

RESTRICTIONS

To render 8-bit characters, gFONT can use EC fonts. Unfortunately, TeX and isolatin encodings differ for some characters. So output will be wrong when including those characters.

Moreover, the German sz ligature is ugly and should be replaced by the one in the CM fonts.

AUTHORS

  Ralf S. Engelschall
  rse [AT] engelschall.com
  www.engelschall.com
  Denis Barbier
  barbier [AT] imacs.fr

Manpages