STCONV(1M)																STCONV(1M)

NAME

       stconv - Utility to convert scalable type symbol set map formats

SYNOPSIS

       stconv infile [-hmq] [-d mapdir] [-to ACG|HPMSL|other]

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 stconv utility is used to convert scalable typeface symbol 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 individual character in the global collection of characters available from a  specific
       typeface  manufacturer.	 The  specific	numbering  scheme used is usually unique to that vendor, and typically identifies hundreds or even
       thousands of characters.  A symbol set (or character set) is generally a particular subset of characters taken from this master collection,
       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 subsystem 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 commercially available with HP Master Symbol List character numbering (HPMSL)  in  prod-
       ucts  obtained  from  the HP MasterType Library, and with Agfa Compugraphic symbol list numbering (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 directory should contain the  file
	       ACG-HPMSL,   plus   any	optional  additional  symbol  list  maps.   If	unspecified,  stconv  looks  for  an  appropriate  map	in
	       /usr/lib/X11/fonts/stadmin/ifo/charsets.  The file ACG-HPMSL defines the translation between Agfa Compugraphic symbol list  number-
	       ing 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 Compugraphic 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  for-
       mat's  character  code.	Lines that begin with anything other than two distinct 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 conver-
       sion 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

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.

X Version 11							     Release 5								STCONV(1M)