Format of the PrimeType PTINSTAL.INI file
-----------------------------------------
The first section of the PTINSTAL.INI file, called [WPCharMap] describes
the mapping from glyph names in the Type 1 fonts (PFB files), to
WordPerfect's 13 Character Maps.

All lines are in the form:

  name = wpset,wpchar

Where "name" is the name as it appears in the Type 1 font file (the name
also appears in the AFM file for the font), "wpset" is the WordPerfect
character set number, and "wpchar" is the WordPerfect character code.  Note
that names are case sensitive (i.e. "QuoteDbl" is not the same as "quotedbl").

Refer to the appendix in your WordPerfect manual for a list of all
WordPerfect character sets and codes.  If you modify this table, you must
re-install all your fonts to effect the changes.

The following rules are used when duplicate entries are found:

1. You may have the same character name assigned to more than one
   WordPerfect code.  That character will be used for each
   WordPerfect character it is assigned to.

2. You may have more than one character name assigned to the same
   WordPerfect character.  If two or more such characters appear in
   a font, the first one listed in this file will be used.

WordPerfect character sets:

 0 ASCII
 1 Multinational 1
 2 Multinational 2
 3 Box Drawing
 4 Typographic symbols
 5 Iconic symbols
 6 Math/Scientific
 7 Math/Scientific Extension
 8 Greek
 9 Hebrew
10 Cyrillic
11 Japanese Kana (Hiragana and Katakana)
12 User-defined

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

All the remaining sections in the INI file describe installation information
for specific typefaces.  Most of the entries cover fonts available from
Adobe Systems Inc.

Here is an example section:

  [NewCenturySchlbk-Italic]
  Vp=I
  Fn=NewCenturySchlbk,ITALIC
  Tn=Century (Italic)
  Wt=2 2
  Wp=8 0 25 0 0
  Mt=7320 1760 5000 6600 7390
  Ia=1893
  Hp=127
  Hw=0
  Hs=1

Several of the lines in the section are important data for WordPerfect to
use when it matches fonts in your document against the list of fonts
available in the printer driver (Vp, Fn, Tn, Wt, Wp, Mt, and Ia).  This
affects you in several ways.

For example, let's say that you have Adobe Garamond in both standard and
expert versions, all in weights of normal, bold, italic, and bold-italic.
The expert set contains certain special characters such as extra ligatures,
but does not contain lower case characters.

If you select Adobe Garamond (Expert) from WordPerfect's font menu, and
type in some lower case characters, WordPerfect searches for a font with
the closest matching characteristics that can supply the lower case
characters.  If several fonts had the same characteristics, WordPerfect
would just pick the first match it found.  In this case, fortunately, Adobe
Garamond has enough unique characteristics that WordPerfect will almost
always pick the standard version of Adobe Garamond as the substitute font.

The other case where font matching is very important is for WordPerfect's
automatic font changes (AFCs) for text that is bold or italic, for example.
For bold text in your document, you have the choice of either explicitly
selecting a bold base font, or by just marking the text as being bold.  In
the latter case, WordPerfect again searches for the closest matching font
based on the current font's characteristics, plus the bold characteristic.
Again, if there were multiple matches, WordPerfect could pick the wrong
font, but the Adobe Garamond characteristics are unique enough to prevent
this from happening in most cases.

WordPerfect's font substitutions and AFCs also come into effect when someone
gives you a document that was created for some other printer driver.
WordPerfect does its best to match up the fonts according to each font's
characteristics.  PrimeType was designed so that the fonts will match for
documents created with most PostScript printer drivers.


Now to describe each entry in detail:


[Name]	This indicates the start of the font section.  Font names are usually
	a combination of the name of the font family (NewCenturySchlbk in our
	example above) followed by some sort of style indicator (e.g. Italic).
	This name can be found in the font's AFM file on the FontName line.
	This line is required.


Vp	This is the font style.  It matches the style code typically found in
	a font's INF file in the VPStyle entry.

	   N = normal
	   B = bold
	   I = italic (or oblique)
	   T = bold-italic

	If the Vp entry is missing, normal is assumed.


Fn	This is the font name for the WordPerfect font menu.  If it is
	missing, it is derived from the font section heading by using the
	name from the left bracket up to the first dash.  The font style
	is then appended, using the same nomenclature as ATM for Windows:

	   N = nothing is appended
	   B = BOLD
	   I = ITALIC
	   T = BOLDITALIC


Tn	This is the typeface name for the WordPerfect .ALL and .PRS files.
	If the typeface name is missing, it is derived from the font section
	heading by using the name from the left bracket up to the first dash.
	The font style is then appended, using the same nomenclature as
	WordPerfect:

	   N = nothing is appended
	   B = (Bold)
	   I = (Italic)
	   T = (Bold Italic)


Wt	This holds the typeface stroke weight for both WordPerfect 5.1 and
	WordPerfect 5.0, respectively.

	For WordPerfect 5.1:

	   0 = Extra Light
	   1 = Light
	   2 = Normal
	   3 = Demi-Bold
	   4 = Bold
	   5 = Heavy
	   6 = Black
	   7 = Ultra-Black

	For WordPerfect 5.0:

	   0 = Extra Light
	   1 = Light
	   2 = Normal
	   3 = Bold
	   4 = Extra Bold

	If this line is missing, it is derived from the Vp code:

	   N = "2 2"
	   B = "4 3"
	   I = "2 2"
	   T = "4 3"


Wp	This is a hex representation of five bytes that describe the font's
	characteristics.

	Bits in the first byte (font attributes):

	   00000001 small caps       
           00000010 shadow font      
           00000100 outline font     
           00001000 italic

	Bits in the second byte (appearance):

	   00000001 casual        
           00000010 connecting    
           00000100 decorative    
           00001000 formal        
           00010000 futuristic    
           00100000 old_style     
           01000000 script

	Bits in the third byte (serifs):

	   00000001 cupped      
           00000010 exaggerated 
           00000100 hairline    
           00001000 slab        
           00010000 slanted     
           00100000 transitional
           01000000 triangular  
           10000000 ball serifs

	Bits in the fourth byte (shape):

	   00000001 curved           
           00000010 nonconnecting    
           00000100 round            
           00001000 square

	Bits in the fifth byte (stress):

	   00000001 angular           
           00000010 exaggerated       
           00000100 uniform

	If the Wp line is missing, a default of "0 0 0 0 4" is used.


Mt	These are the typeface's global font metrics.  Five numbers
	on the line represent:

	   Cap height	  How far the capital H goes above the baseline.
			  See the CapHeight value (times 10) in the AFM file.

	   Max descender  The maximum that the descender of a lower case p
			  goes below the baseline.  See the Descender value
			  (times 10) in the AFM file.

	   X height	  How far the lower-case x goes above the baseline.
			  See the XHeight value (times 10) in the AFM file.

	   T height	  How far the lower-case t goes above the baseline.
			  See the height of a lower case t (times 10) in
			  the AFM file.

	   Max ascender	  The maximum that the ascender of a lower case d
			  goes above the baseline.  See the Ascender value
			  (times 10) in the AFM file.

	By dividing each number by 100, we get a percentage of the current
	font's point size (e.g 9076 is 90.76%).  These values are required.


Ia	This describes how far italic or oblique characters are skewed
	from vertical.  By dividing by 100, we convert it to a percentage.
	If it is missing, zero is used.  See the ItalicAngle (times 100)
	in the AFM file.


Hp	This is the typeface code to use when PrimeType sends soft fonts to
	LaserJet printers.  It is important that each font family have a
	unique typeface code (e.g. all the New Century Schoolbook fonts should
	use 127, regardless of stroke weight).  This value is required.  See
	the PCLTypefaceID in the INF file.


Hw	This is the stroke weight code to use for HP soft fonts:

	  -7 = ultra thin
	  -5 = thin
	  -3 = light
	   0 = medium
	   1 = demi
	   3 = bold
	   5 = black
	   7 = ultra black

	If it is missing, it will be derived from the Vp code:

	   N = 0
	   B = 3
	   I = 0
	   T = 3

	See the PCLStrokeWeight value in the INF file.


Hs	This is the style code to use for HP soft fonts:

	   0 = upright
	   1 = italic or oblique
	   4 = condensed

	If it is missing, it will be derived from the Vp code:

	   N = 0
	   B = 0
	   I = 1
	   T = 1

	See the PCLStyle value in the INF file.
