STCONV(1M) UNIX Programmer's Manual STCONV(1M)
NAME
stconv - Utility to convert scalable type symbol set map
formats
SYNOPSIS
stconv infile [-hmq] [-d mapdir] [-to ACG|HPMSL|other]
DESCRIPTION
The stconv utility is used to convert scalable typeface sym-
bol set maps (.sym files) for Intellifont fonts from one
symbol list numbering format to another. The installation
default symbol sets map their respective symbols into
appropriate HP Master Symbol List character codes (the
default format provided in .ifo typeface libraries). Since
it is possible, however, to use stload(1M) to generate .ifo
libraries that use some other symbol list numbering (such as
native Agfa Compugraphic ACG numbering), stconv provides a
way to modify existing .sym files to map characters to non-
MSL numbers.
A symbol list assigns a unique numeric value to each indivi-
dual character in the global collection of characters avail-
able from a specific typeface manufacturer. The specific
numbering scheme used is usually unique to that vendor, and
typically identifies hundreds or even thousands of charac-
ters. A symbol set (or character set) is generally a par-
ticular subset of characters taken from this master collec-
tion, with each character being assigned another unique code
in accordance with the some specific registry/encoding
scheme (such as ISO8859 Latin-1 or HP Roman-8). In this
respect, the .sym files used by the HP Scalable Type subsys-
tem are actually symbol set maps, equating all the character
codes comprising a specific character set registry/encoding
to the corresponding character numbers of a particular
typeface vendor's symbol list.
Intellifont format scalable typeface libraries are commer-
cially available with HP Master Symbol List character
numbering (HPMSL) in products obtained from the HP Master-
Type Library, and with Agfa Compugraphic symbol list number-
ing (ACG) for products from the Agfa Typeface Library.
OPTIONS
There are several command line parameters which are
described below.
infile Required name of the .sym file to be converted.
-d mapdir
Specifies the name of the directory containing the
symbol list conversion map (see below). This direc-
tory should contain the file ACG-HPMSL, plus any
HP-UX 9.0 August 1992 Release 5 1
STCONV(1M) UNIX Programmer's Manual STCONV(1M)
optional additional symbol list maps. If unspeci-
fied, stconv looks for an appropriate map in
/usr/lib/X11/fonts/stadmin/ifo/charsets. The file
ACG-HPMSL defines the translation between Agfa Com-
pugraphic symbol list numbering and HP Master Symbol
List numbering.
-h Requests help.
-m Requests that stconv list the conversion map.
-q Requests that stconv should run quietly.
-to format
Specifies the new symbol list format. The
installation-default symbol sets use HPMSL format;
to generate a symbol set for native Agfa Compu-
graphic symbol list character codes, you should
specify -to ACG.
EXAMPLES
stconv -to ACG roman8.sym >acgr8.sym
This reads the HPMSL symbol map roman8.sym, and
writes the ACG version to acgr8.sym via stdout
redirection. The new symbol map can subsequently be
used to generate an HP Roman-8 font from an Agfa
Typeface Library product.
SYMBOL LIST CONVERSION MAPS
A symbol list conversion map defines the translation of
character numbers between two different symbol lists. The
map is a simple text file contain two columns of character
codes: the first column is the first format's character
code, the second column is the second format's character
code. Lines that begin with anything other than two dis-
tinct values are ignored. The name of the conversion must
be the names of the two formats concantenated together with
a hyphen, with care taken to insure the name before the
hyphen reflects the numbering scheme used in the first
column, and the name after the hyphen reflects the numbering
scheme used in the second column. A single conversion map
file is sufficient for converting a symbol list of either
format into a symbol list of the opposite format. As an
example, the first few lines of the file ACG-HPMSL are:
# ACG-HPMSL
# First column is ACG number
# Second column is corresponding HPMSL number
1 86
2 81
3 74
4 80
HP-UX 9.0 August 1992 Release 5 2
STCONV(1M) UNIX Programmer's Manual STCONV(1M)
FILES
Stconv takes input only from the specified file, and always
sends output to stdout.
NOTE
Stconv supports only the .sym files used for Intellifont
scalable fonts, and has no application to other types of
scalable fonts (such as Type 1).
SEE ALSO
stlicense(1M), stmkfont(1), stmkdirs(1), stload(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 3