*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> stmkfont (1)              


 STMKFONT(1)                    X Version 11                     STMKFONT(1)
                                  Release 5

 NAME    [Toc]    [Back]
      stmkfont - Scalable Typeface font compiler to create X and PCL fonts

 SYNOPSIS    [Toc]    [Back]
      stmkfont [options] xlfdname

 DESCRIPTION    [Toc]    [Back]
      The stmkfont utility is obsolete and will not be supported in future
      releases.  It has been replaced by the fstobdf utility.

      The stmkfont utility is a bit-mapped font generator for creating X and
      PCL fonts from Intellifont scalable typeface data.  By specifying
      desired font characteristics via an X Logical Font Description (XLFD)
      name, the user can instruct stmkfont to generate an almost limitless
      variety of font flavors from one or more Agfa Compugraphic Intellifont
      typeface libraries.  Possible output formats are BDF, and PCL for
      various HP printers.

              The last argument on the command line is always assumed to be
              the required XLFD name.  The XLFD name is the means by which
              you specify the typeface, font size, and additional treatments
              for the final font.  (See xlfd(3) for information on XLFD
              construction).  The XLFD name should begin with a fielddelimiter
 hyphen and specify from one to fourteen contiguous
              fields.  If less than 14 fields are given, stmkfont will
              automatically append wildcard fields to fill the name out to
              fourteen. Stmkfont then attempts to qualify the XLFD name by
              looking for a matching scalable typeface descriptor in
              fonts.dir, and upon finding a one, proceeds to build the font.

 SWITCH OPTIONS    [Toc]    [Back]
      -C      Output a catalog of typeface/character set combinations on
              stderr.  For the given XLFD specification, stmkfont will
              generate a list of fully qualified XLFD names that reflect the
              various typefaces and character sets that could be used to
              construct a final font.  No font is generated when this option
              is used.

      -I      Send additional status information to stderr, such as the
              requested and final XLFD names, return status of the
              underlying stmkfont() call, and a list of characters that
              either failed font generation or were not in the symbol set.

      -P      Send ``one-percent progress dots'' to stderr.  As stmkfont
              constructs the final font, it will output a stream of period
              characters at regular time intervals.  Exactly 100 periods
              will be output; when the 100th dot has been sent, the font is

 Hewlett-Packard Company            - 1 -               HP-UX 10.0 July 1994

 STMKFONT(1)                    X Version 11                     STMKFONT(1)
                                  Release 5

      -S      If one of the PCL output formats is requested, this option
              causes stmkfont to output to stderr the PCL selection string
              required to select the resulting font on the PCL printer.

      -T      Suppress temporary output file.  In its normal mode of
              operation, stmkfont takes time to ``dribble'' output into a
              /tmp tempfile, and then quickly ``burst'' copy the complete
              tempfile to the actual output file or device.  While this file
              re-copy does cause stmkfont to take somewhat longer to produce
              results, it minimizes the amount of time that a parent process
              must spend ``listening'' to stmkfont's output.  If overall
              speed is more critical than time spent actually writing the
              final output, this switch can be used to bypass the tempfile
              and ``dribble'' output directly to the final destination.

      -V      Requests that a fully qualified XLFD name be sent to stderr
              without continuing to generate final output.

      -cf CharsetFile
          -cp CharsetPath
              These options allow you to specify the subdirectory (under one
              of the database directories) and/or filename of a symbol set
              mapping file.  Once stmkfont has determined the name of the
              scalable typeface library it will use, it extracts the
              filename extension from the library's name, and uses it in
              conjunction with CharsetPath, CharsetFile, and the database
              directory trees Primary and Alternate to locate an appropriate
              character set map.  Stmkfont will look for CharsetFile (or
              charsets.dir) in several directories, in the following order:

                   1.  Primary/TypefaceExtension/CharsetPath
                   2.  Alternate/TypefaceExtension/CharsetPath
                   3.  {STPATH}/TypefaceExtension/CharsetPath

              If left unspecified, the default CharsetPath is charsets, and
              the default CharsetFile is determined by scanning the above
              directories for charsets.dir, then using the Charset Registry
              and Charset Encoding properties of the XLFD name to extract
              from it a charset map filename.  Note:  In the above directory
              search hierarchy there should normally exist only one
              charsets.dir file.  Stmkfont will stop searching when the
              first charsets.dir is encountered.  If that charsets.dir does
              not contain an appropriate registry/encoding to match the XLFD
              name, stmkfont will be unable to generate the requested font.

              In practice, the character sets are usually found in the
              Alternate directory's CharsetPath subdirectory.  When this
              product is installed, for example, the character sets are
              placed in the /usr/lib/X11/fonts/stadmin/ifo/charsets
              directory, where stmkfont finds them with the default
              Alternate and CharsetPath values.

 Hewlett-Packard Company            - 2 -               HP-UX 10.0 July 1994

 STMKFONT(1)                    X Version 11                     STMKFONT(1)
                                  Release 5

              The Alternate directory is also the customary home of the
              misc/st.dev file used by stmkfont to determine PCL printer

              Because the Alternate directory is the customary home of many
              important typeface-independent files, it is usually
              inadvisable to use the -d2 option.

      -d1 Primary
          -d2 Alternate
              Whenever stmkfont must open a typeface library, a character
              set map, or a *.dir control file, it searches through several
              directories in a specific order until either the required file
              is found, or the list of search directories are exhausted.
              These database directories and the order in which they are
              searched are as follows:

                   1.  Primary (default /usr/lib/X11/fonts/ifo.st)
                   2.  Alternate (default /usr/lib/X11/fonts/stadmin)
                   3.  {STPATH} (environment variable)

              The -d1 and -d2 options let you change the Primary and
              Alternate database directories.  If a requested file cannot be
              found based on either of these two paths, additional places to
              look can be specified by using the STPATH environment

              In practice, typefaces are usually found in the Primary
              directory, and character sets are found in the Alternate
              directory's CharsetPath directory (see below).

      -dv device
              Specifies the device for which a font is to be made, in the
              format host:device.  If not specified or partly specified
              (host: or :device), host defaults to the executing machine's
              hostname, and device defaults to PRINTERS or DISPLAYS
              (depending on the output format specified).  See stlicense(1)
              for further information on the format of the device parameter.

      -f format
              Specifies the output format for the requested font, which must
              be one of the following:  BDF or one of the supported PCL
              printer formats.  Output formats currently supported are:
              LJPLUS, LJII, LJ2000, LJIIP, LJIII (bitmapped fonts for
              various models of LaserJet), PJXL (bitmapped fonts for the
              PaintJet XL), and PCLEO (scalable fonts for the LaserJet III).
              Bitmapped fonts reflect any transformations (such as
              emboldening and obliqueing) requested in the xlfdname
              argument; scalable fonts (PCLEO format) do not.

              If left unspecified, output format is BDF.

 Hewlett-Packard Company            - 3 -               HP-UX 10.0 July 1994

 STMKFONT(1)                    X Version 11                     STMKFONT(1)
                                  Release 5

      -h      There is no -h option.  For online help, run stmkfont without
              any parameters.

      -nf fonts.dir
          -ns charsets.dir
          -nt typefaces.dir
              These three options allow you to specify alternate names for
              the three control files that may be used by stmkfont.
              fonts.dir contains a list of typeface library files and the
              XLFD ``outline'' name descriptions of those typefaces.
              charsets.dir contains associates character set registry,
              encoding, and requirements with particular character set map
              files.  typefaces.dir assigns ``official'' names to individual
              Agfa Compugraphic typeface IDs.

      -nv name
              Specifies an alternate environment variable name to use
              instead of STPATH.

      -o outfile
              This option specifies the output file.  Default is stdout.

      -q      Run quietly (suppress error messages).

      -v      Similar to the -V option, -v requests that a fully qualified
              XLFD name be sent to stderr before stmkfont begins generating
              glyphs.  The string will be terminated with a newline
              character and stderr will be flushed before any glyph output

      -w      This option causes all bitmap output data to be suppressed,
              resulting in only header and trailer information being
              generated.  Header metrics will accurately reflect the entire
              font that would have been emitted, but the character count
              will show zero.

 ENVIRONMENT    [Toc]    [Back]
      STPATH  STPATH specifies the last-resort paths to be searched when
              looking for typeface libraries, character set mapping files,
              and *.dir files.  Searching STPATH is only considered if
              requested files are not found in the Primary or Alternate
              paths (normally, /usr/lib/X11/fonts/ifo.st and
              /usr/lib/X11/fonts/stadmin).  STPATH has a format similar to
              the PATH variable, consisting of one or more paths
              concatenated together with colons.

 ABOUT XLFD NAMES    [Toc]    [Back]
      If the xlfdname argument contains any embedded blanks the entire XLFD
      name should be enclosed in quotes.  Also, while it is good practice to
      always specify something in all XLFD fields, null fields (double
      dashes) are permissible and will be treated as though they contain

 Hewlett-Packard Company            - 4 -               HP-UX 10.0 July 1994

 STMKFONT(1)                    X Version 11                     STMKFONT(1)
                                  Release 5

      asterisk wildcards.  Certain fields of the XLFD name will ``default''
      if specified as zero or wild:

          Point Size (field 8) - default value is 120 (12 point)
          X resolution (field 9) - default value is 100 dots per inch (BDF)
                                   default value is printer resolution (PCL)
          Y resolution (field 10) - default value is 100 dots per inch (BDF)
                                    default value is printer resolution (PCL)

      Resolution of other fields containing wildcards depends wholly on the
      contents and ordering of data in fonts.dir and charsets.dir.

      The PCL bitmapped output formats for the various LaserJet printers are
      identical.  Stmkfont uses the format specified with the -f option to
      ensure that the font will work within the restrictions imposed by the
      target printer.  For example, the LJPLUS printer cannot handle the
      large glyphs allowed by the other models, nor can it handle character
      sets that define glyphs for the control characters.

 EXAMPLES    [Toc]    [Back]
      To generate a BDF file for a 14-point/110 DPI ``cg times'' font using
      the iso8859-1 character set:

          stmkfont "-agfa-cg times-normal-r-normal-*-*-140-110-110-*-*-iso8859-1"

      To generate the same font for a LaserJet II:
          stmkfont -f LJII "-agfa-cg times-normal-r-normal-*-*-140-*-*-*-*-iso8859-1"

      Note that the resolution fields will default to the printer's 300 DPI
      resolution.  The output will be a LaserJet II font without the font
      management sequences for assigning font ID and for making the font
      temporary or permanent.

      To search for fonts in a directory ``$HOME/fonts'' containing scalable
      fonts and a fonts.dir directory:
          stmkfont -d1 "$HOME/fonts" "-agfa-cg times-normal-r----140-----hp-roman8"

      Note here that empty fields are simply run together as a string of
      dashes.  While this is an unrecommended departure from the XLFD format
      standard, stmkfont will allow such a specification and treats the
      empty fields as though they contain asterisk wildcards.

 FILES    [Toc]    [Back]

 NOTE    [Toc]    [Back]
      Stmkfont supports only Intellifont scalable fonts; it cannot be used
      to generate fonts from Type 1 or any other format of scalable

 Hewlett-Packard Company            - 5 -               HP-UX 10.0 July 1994

 STMKFONT(1)                    X Version 11                     STMKFONT(1)
                                  Release 5


 ERRORS    [Toc]    [Back]
      Typeface does not contain an HP alias
              The typeface file does not contain sufficient information to
              construct a PCL font.

      LJPLUS printer does not support this charset    [Toc]    [Back]
              A character set was requested that cannot be used on the
              LaserJet Plus printer.  Any character set that defines glyphs
              for characters 0-31 or 128-159 cannot be used on the LaserJet
              Plus printer.

      Font too large for printer    [Toc]    [Back]
              The requested font size is larger than can be handled by the
              target printer.

 SEE ALSO    [Toc]    [Back]
      mkfontdir(1), stmkdirs(1), stlicense(1M), stload(1M)

 COPYRIGHT    [Toc]    [Back]
      (C) Copyright 1990 Hewlett-Packard Company

 Hewlett-Packard Company            - 6 -               HP-UX 10.0 July 1994
[ Back ]
 Similar pages
Name OS Title
stmkdirs HP-UX Utility to build Scalable Type fonts.dir and charsets.dir files
XmFontListGetNextFont IRIX A font list function that allows applications to access the fonts and character sets in a font list
XmFontListGetNextFont Tru64 A font list function that allows applications to access the fonts and character sets in a font list
XmFontListGetNextFont HP-UX A font list function that allows applications to access the fonts and character sets in a font list
glcfontface IRIX set the face of a font or of all current fonts
glcfont IRIX replace fonts in the font list
fslsfonts Tru64 list fonts served by X font server
fslsfonts IRIX list fonts served by X font server
installpcfonts IRIX Install POSTSCRIPT fonts from Adobe IBM PC font packages
cidxfonts IRIX build X style font directory for CID-keyed fonts
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service