STLOAD(1M) X Version 11 STLOAD(1M)
Release 5
NAME [Toc] [Back]
stload - Utility to load Scalable Type outlines
SYNOPSIS [Toc] [Back]
stload [options] directory|filespec...
DESCRIPTION [Toc] [Back]
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
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 [Toc] [Back]
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
Hewlett-Packard Company - 1 - HP-UX 10.0 July 1994
STLOAD(1M) X Version 11 STLOAD(1M)
Release 5
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 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
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 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
Hewlett-Packard Company - 2 - HP-UX 10.0 July 1994
STLOAD(1M) X Version 11 STLOAD(1M)
Release 5
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 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 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 numbers 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
Hewlett-Packard Company - 3 - HP-UX 10.0 July 1994
STLOAD(1M) X Version 11 STLOAD(1M)
Release 5
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 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 [Toc] [Back]
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 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.
Hewlett-Packard Company - 4 - HP-UX 10.0 July 1994
STLOAD(1M) X Version 11 STLOAD(1M)
Release 5
FILES [Toc] [Back]
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 [Toc] [Back]
Stload can process a maximum of 20000 glyphs per typeface.
SEE ALSO [Toc] [Back]
stlicense(1M), stmkfont(1), stmkdirs(1), stconv(1M)
COPYRIGHT [Toc] [Back]
(c) Copyright 1990, Hewlett-Packard Company
See X(1) for a full statement of rights and permissions.
Hewlett-Packard Company - 5 - HP-UX 10.0 July 1994 [ Back ] |
