unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 STLOAD(1M)			X Version 11			  STLOAD(1M)
				  Release 5



 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
      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
      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
      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
      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.





































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