STLOAD(1M)STLOAD(1M)NAMEstload - Utility to load Scalable Type outlines
SYNOPSISstload [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 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 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 utili‐
ties such as doscp or cp to transfer the typeface files from the dis‐
tribution 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 direc‐
tory 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 direc‐
tory.
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 direc‐
tory 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 subsys‐
tem, but have the feature of being expandable -- you can add
new typefaces to an existing DOS format library. (See ``EXAM‐
PLES'' 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 type‐
face, 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 prod‐
uct 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/stad‐
min/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 mak‐
ing 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 unspeci‐
fied, these files will be written to the following default out‐
put directories:
write .ifo files to /usr/lib/X11/fonts/ifo.st/typefaces
write .sym files to /usr/lib/X11/fonts/stad‐
min/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 type‐
faces for use with specific devices. Product numbers are writ‐
ten into a products directory 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 output direc‐
tory, 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 unspeci‐
fied, 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 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.
EXAMPLESstload-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 prod‐
uct number required for future licensing of these typefaces by
stlicense is C2050A#D15. Fonts.dir, charsets.dir, and met‐
rics.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 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 type‐
face 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 ALSOstlicense(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)