STLOAD(1M) STLOAD(1M)
NAME
stload - Utility to load Scalable Type outlines
SYNOPSIS
stload [options] directory|filespec...
DESCRIPTION
Intellifont font technology has been obsoleted on HP's X Window System. Support for it will be removed in a future release. This utility
will be removed at that time.
The stload utility creates scalable typeface libraries (.ifo files) from Agfa Compugraphic Font Access and Interchange Standard (CG/FAIS)
data. (An FAIS library on floppy disk or CD-ROM media is the common means of distribution for scalable typeface products that is compati-
ble with the HP Font Server and Scalable Typeface subsystem implementation. It is also is the distribution format used by HP Type Direc-
tor/DOS and the HP MasterType library of scalable typeface floppy disks.) Stload also simplifies the installation of new symbol sets and
existing .ifo files from an archive repository, creates Tagged Font Metric .tfm files, and establishes new product entries in the Scalable
Typeface licensing structure. Stload should generally be run interactively by the system font administrator to load new scalable typefaces
into a Scalable Typeface directory.
Several typefaces come bundled with the Scalable Typeface system and are automatically installed with the product; additional typefaces may
be acquired separately. Since new typefaces are generally distributed on MS-DOS floppy media, the system administrator may need to use
utilities such as doscp or cp to transfer the typeface files from the distribution media to a temporary location on the target system.
CG/FAIS file naming conventions prohibit multiple CG/FAIS diskettes from being copied into a common repository, so you should create a
unique directory on the host system to contain each CG/FAIS diskette you load. Once all of the CG/FAIS typeface files have been loaded
onto the target system, stload is used to compile them into .ifo scalable typeface libraries and install the libraries in an appropriate
typefaces directory.
Stload does not grant licensed access to newly-installed typefaces. Font administrators must use the stlicense utility to give devices
access to new typefaces.
OPTIONS
There are several command line options which are described below.
directory|filespec
This is a required parameter specifying the name of the directory or filespec of the data to be loaded. You may specify one or
more directories containing the FAIS data extracted from a typeface distribution diskette, or one or more repositories containing
.ifo and/or .sym files, or explicit or wildcarded filespecs of existing .ifo and/or .sym files.
-d mapdir
Specifies the directory containing the symbol list map required by the -to format option. This directory must contain the file
ACG-HPMSL, plus any optional additional symbol list maps. If left unspecified, stload assumes the symbol list maps can be found in
/usr/lib/X11/fonts/stadmin/ifo/charsets.
-dos Specifies that the typeface library should be written as a TypeDirector/DOS .typ file. Typefaces libraries written in this format
cannot be used by the HP-UX Scalable Type subsystem, but have the feature of being expandable -- you can add new typefaces to an
existing DOS format library. (See ``EXAMPLES'' below for more details.)
-f libname
Specifies the name of the scalable typeface library into which FAIS data should be loaded. Normally, loading from FAIS data gener-
ates a separate .ifo or .typ library file for each typeface, and each library file's name indicates that particular typeface's ID
and character complement code. The -f option overrides this automatic naming convention and lets you add typefaces into a single
library with any arbitrary name.
-fp path
Specifies the name of the base directory under which typefaces, metrics, and products directories should be used as the target
directories for typeface, metric, and product definition files. These directories will be created as necessary if they don't
already exist. Any attempt to load typeface, metric, and product definition files elsewhere by using the -o option will be
ignored. (If neither the -fp nor -o options are specified, the default base directory is /usr/lib/X11/fonts/ifo.st. See -o below
for more option information.)
Note that -fp does not affect where .sym files will be loaded. Unless you use the -o option to direct them elsewhere, symbol sets
will still be installed into /usr/lib/X11/fonts/stadmin/ifo/charsets.
-h Requests help. Stload will print out a command line syntax summary and a list of command line switch options. No other processing
will take place.
-id[,id...]
Identifies one or more specific typefaces to be loaded from CG/FAIS data. Normally, stload installs all of the typefaces it can
find, loading each typeface into its own .ifo file. If you wish to install only one or two specific faces, you must use this
option. (Specific typeface numbers can be determined by using stload -list to examine the contents of the FAIS directory; the
"Face" column reveals typeface IDs.)
-link Causes stload to install files in the output directory by making hard links back to the original repository in directory. Note
that this works only when loading .sym files and pre-existing .ifo files. The default behavior (when this option is not specified)
is to copy the .ifo and .sym files unmodified to the output directory. All .ifo files loaded from FAIS data are created as new
files in the output directory.
-list Prints a list of the data located in directory on the standard output device. The directory may contain either FAIS data, .ifo
typeface libraries, or .sym symbol set files. No other processing takes place.
-o path Specifies the name of the output directory in which to write the final .ifo, .sym, and .tfm files. If the directory does not
exist, stload will attempt to create it. If left unspecified, these files will be written to the following default output directo-
ries:
write .ifo files to /usr/lib/X11/fonts/ifo.st/typefaces
write .sym files to /usr/lib/X11/fonts/stadmin/ifo/charsets
write .tfm files to /usr/lib/X11/fonts/ifo.st/metrics
-p product-number
Associates a product number with newly-loaded typefaces (.ifo files). Although this can be any arbitrary filename-sized string, it
should reflect the product number printed on the typeface distribution package and media. The stlicense utility requires this
product number in order to license loaded typefaces for use with specific devices. Product numbers are written into a products
directory at the same directory level as the .ifo output directory. For example, if you specified the -o path option, product num-
bers will be written to path/../products; if you do not specify the any output directory, product numbers will be written to files
in /usr/lib/X11/fonts/ifo.st/products. The products directory will be automatically created if it does not already exist.
-sym Causes stload to install files the output directory by making symbolic links back to the original repository in directory rather
than by copying the original files. Note that this works only for loading .sym files and pre-existing .ifo files. All .ifo files
loaded from FAIS data are created as new files in the output directory.
-tfm Causes stload to update Tagged Font Metric .tfm files in the output directory (or in /usr/lib/X11/fonts/ifo.st/metrics if no output
directory is specified).
-to format
Specifies the symbol list that should be used for assigning character ID codes when loading FAIS data. If left unspecified, char-
acter IDs will be assigned in accordance with the HP Master Symbol List (HPMSL); to retain Agfa Compugraphic (native FAIS) ID num-
bers, you should specify -to ACG.
-u Specifies that the .dir files should not be updated. Stload normally automatically uses the stmkdirs utility to update the
fonts.dir, charsets.dir, and metrics.dir files in the output directory or directories. The -tfm option should not be used with
this option, since -tfm requires current fonts.dir files for correct operation.
-v Specifies that stload should run verbosely.
EXAMPLES
stload -p C2050A#D15 .
Compiles the CG/FAIS data in the current directory and puts the resulting .ifo files in /usr/lib/X11/fonts/ifo.st/typefaces.
Existing .ifo files in the current directory will also be copied; existing .sym files will be copied into /usr/lib/X11/fonts/stad-
min/ifo/charsets; appropriate .tfm files will be added to /usr/lib/X11/fonts/ifo.st/metrics. The product number required for
future licensing of these typefaces by stlicense is C2050A#D15. Fonts.dir, charsets.dir, and metrics.dir are updated to reflect
the additions.
stload -o . -dos -f big3.ifo -92500 times
stload -o . -dos -f big3.ifo -93717 courier
stload -o . -p BIG3 -f big3.ifo -92041 univers
Compiles three different CG/FAIS typefaces into a single .ifo library. The library must be explicitly named to prevent stload from
assigning names, and all but the last typeface must be loaded in DOS format to keep the library expandable. The final invocation
loads the last typeface, converts the complete DOS library into true .ifo format, and makes the typefaces licensable via the prod-
uct name BIG3.
stload -list /usr/lib/X11/fonts/ifo.st/typefaces
Lists all of the typefaces currently contained in /usr/lib/X11/fonts/ifo.st/typefaces.
FILES
Remember that stload requires write access to the directory that will contain the compiled typeface libraries. This implies that only the
system font administrator should be able to add typefaces to the typeface collection in /usr/lib/X11/fonts/ifo.st/typefaces. The files
fonts.dir, charsets.dir, and metrics.dir will be automatically updated to reflect additions. Typeface licenses are not modified.
RESTRICTIONS
Stload can process a maximum of 20000 glyphs per typeface.
SEE ALSO
stlicense(1M), stmkfont(1), stmkdirs(1), stconv(1M)
COPYRIGHT
(c) Copyright 1990, Hewlett-Packard Company
See X(1) for a full statement of rights and permissions.
X Version 11 Release 5 STLOAD(1M)