STLOAD(1M) UNIX Programmer's Manual STLOAD(1M)
NAME
stload - Utility to load Scalable Type outlines
SYNOPSIS
stload [options] directory|filespec...
DESCRIPTION
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 scal-
able typeface products that is compatible with the HP Font
Server and Scalable Typeface subsystem implementation. It
is also is the distribution format used by HP Type
Director/DOS and the HP MasterType library of scalable
typeface floppy disks.) Stload also simplifies the installa-
tion 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 distri-
bution 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 con-
tain each CG/FAIS diskette you load. Once all of the
CG/FAIS typeface files have been loaded onto the target sys-
tem, stload is used to compile them into .ifo scalable
typeface libraries and install the libraries in an appropri-
ate typefaces directory.
Stload does not grant licensed access to newly-installed
typefaces. Font administrators must use the stlicense util-
ity 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
HP-UX 9.0 August 1992 Release 5 1
STLOAD(1M) UNIX Programmer's Manual STLOAD(1M)
diskette, or one or more repositories containing
.ifo and/or .sym files, or explicit or wildcarded
filespecs of existing
-d mapdir
Specifies the directory containing the symbol list
map required by the -to format option. This direc-
tory 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 writ-
ten 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 generates 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 direc-
tories 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.
HP-UX 9.0 August 1992 Release 5 2
STLOAD(1M) UNIX Programmer's Manual STLOAD(1M)
-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 con-
tents of the FAIS directory; the "Face" column
reveals typeface IDs.)
-link Causes stload to install files the output directory
by making hard links back to the original repository
in directory rather than by copying the original
files. Note that this works only when loading .sym
files and pre-existing .ifo files. 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 con-
tain 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 directories:
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 distribu-
tion 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 direc-
tory at the same directory level as the .ifo output
directory. For example, if you specified the -o
path option, product numbers will be written to
path/../products; if you do not specify the any out-
put directory, product numbers will be written to
files in /usr/lib/X11/fonts/ifo.st/products. The
HP-UX 9.0 August 1992 Release 5 3
STLOAD(1M) UNIX Programmer's Manual STLOAD(1M)
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 repo-
sitory in directory rather than by copying the ori-
ginal 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, character IDs will be assigned
in accordance with the HP Master Symbol List
(HPMSL); to retain Agfa Compugraphic (native FAIS)
ID numbers, 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 direc-
tories.
-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/stadmin/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
HP-UX 9.0 August 1992 Release 5 4
STLOAD(1M) UNIX Programmer's Manual STLOAD(1M)
named to prevent stload from assigning names, and
all but the last typeface must be loaded in DOS for-
mat to keep the library expandable. The final invo-
cation loads the last typeface, converts the com-
plete DOS library into true .ifo format, and makes
the typefaces licensable via the product 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.
HP-UX 9.0 August 1992 Release 5 5