home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0200 - 0209 / ibm0200-0209 / ibm0200.tar / ibm0200 / ATM1.ZIP / ATWAV1.1 / ATINSTAL.TXT < prev    next >
Encoding:
Text File  |  1979-11-30  |  9.0 KB  |  295 lines
  1. Format of the ATWP ATINSTAL.INI file
  2. -----------------------------------------
  3. The first section of the ATINSTAL.INI file, called [WPCharMap] describes
  4. the mapping from glyph names in the Type 1 fonts (PFB files), to
  5. WordPerfect's 13 Character Maps.
  6.  
  7. All lines are in the form:
  8.  
  9.   name = wpset,wpchar
  10.  
  11. Where "name" is the name as it appears in the Type 1 font file (the name
  12. also appears in the AFM file for the font), "wpset" is the WordPerfect
  13. character set number, and "wpchar" is the WordPerfect character code.  Note
  14. that names are case sensitive (i.e. "QuoteDbl" is not the same as "quotedbl").
  15.  
  16. Refer to the appendix in your WordPerfect manual for a list of all
  17. WordPerfect character sets and codes.  If you modify this table, you must
  18. re-install all your fonts to effect the changes.
  19.  
  20. The following rules are used when duplicate entries are found:
  21.  
  22. 1. You may have the same character name assigned to more than one
  23.    WordPerfect code.  That character will be used for each
  24.    WordPerfect character it is assigned to.
  25.  
  26. 2. You may have more than one character name assigned to the same
  27.    WordPerfect character.  If two or more such characters appear in
  28.    a font, the first one listed in this file will be used.
  29.  
  30. WordPerfect character sets:
  31.  
  32.  0 ASCII
  33.  1 Multinational 1
  34.  2 Multinational 2
  35.  3 Box Drawing
  36.  4 Typographic symbols
  37.  5 Iconic symbols
  38.  6 Math/Scientific
  39.  7 Math/Scientific Extension
  40.  8 Greek
  41.  9 Hebrew
  42. 10 Cyrillic
  43. 11 Japanese Kana (Hiragana and Katakana)
  44. 12 User-defined
  45.  
  46. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  47.  
  48. All the remaining sections in the INI file describe installation information
  49. for specific typefaces.  Most of the entries cover fonts available from
  50. Adobe Systems Inc.
  51.  
  52. Here is an example section:
  53.  
  54.   [NewCenturySchlbk-Italic]
  55.   Vp=I
  56.   Fn=NewCenturySchlbk,ITALIC
  57.   Tn=Century (Italic)
  58.   Wt=2 2
  59.   Wp=8 0 25 0 0
  60.   Mt=7320 1760 5000 6600 7390
  61.   Ia=1893
  62.   Hp=127
  63.   Hw=0
  64.   Hs=1
  65.  
  66. Several of the lines in the section are important data for WordPerfect to
  67. use when it matches fonts in your document against the list of fonts
  68. available in the printer driver (Vp, Fn, Tn, Wt, Wp, Mt, and Ia).  This
  69. affects you in several ways.
  70.  
  71. For example, let's say that you have Adobe Garamond in both standard and
  72. expert versions, all in weights of normal, bold, italic, and bold-italic.
  73. The expert set contains certain special characters such as extra ligatures,
  74. but does not contain lower case characters.
  75.  
  76. If you select Adobe Garamond (Expert) from WordPerfect's font menu, and
  77. type in some lower case characters, WordPerfect searches for a font with
  78. the closest matching characteristics that can supply the lower case
  79. characters.  If several fonts had the same characteristics, WordPerfect
  80. would just pick the first match it found.  In this case, fortunately, Adobe
  81. Garamond has enough unique characteristics that WordPerfect will almost
  82. always pick the standard version of Adobe Garamond as the substitute font.
  83.  
  84. The other case where font matching is very important is for WordPerfect's
  85. automatic font changes (AFCs) for text that is bold or italic, for example.
  86. For bold text in your document, you have the choice of either explicitly
  87. selecting a bold base font, or by just marking the text as being bold.  In
  88. the latter case, WordPerfect again searches for the closest matching font
  89. based on the current font's characteristics, plus the bold characteristic.
  90. Again, if there were multiple matches, WordPerfect could pick the wrong
  91. font, but the Adobe Garamond characteristics are unique enough to prevent
  92. this from happening in most cases.
  93.  
  94. WordPerfect's font substitutions and AFCs also come into effect when someone
  95. gives you a document that was created for some other printer driver.
  96. WordPerfect does its best to match up the fonts according to each font's
  97. characteristics.  ATWP was designed so that the fonts will match for
  98. documents created with most PostScript printer drivers.
  99.  
  100.  
  101. Now to describe each entry in detail:
  102.  
  103.  
  104. [Name]    This indicates the start of the font section.  Font names are usually
  105.     a combination of the name of the font family (NewCenturySchlbk in our
  106.     example above) followed by some sort of style indicator (e.g. Italic).
  107.     This name can be found in the font's AFM file on the FontName line.
  108.     This line is required.
  109.  
  110.  
  111. Vp    This is the font style.  It matches the style code typically found in
  112.     a font's INF file in the VPStyle entry.
  113.  
  114.        N = normal
  115.        B = bold
  116.        I = italic (or oblique)
  117.        T = bold-italic
  118.  
  119.     If the Vp entry is missing, normal is assumed.
  120.  
  121.  
  122. Fn    This is the font name for the WordPerfect font menu.  If it is
  123.     missing, it is derived from the font section heading by using the
  124.     name from the left bracket up to the first dash.  The font style
  125.     is then appended, using the same nomenclature as ATM for Windows:
  126.  
  127.        N = nothing is appended
  128.        B = BOLD
  129.        I = ITALIC
  130.        T = BOLDITALIC
  131.  
  132.  
  133. Tn    This is the typeface name for the WordPerfect .ALL and .PRS files.
  134.     If the typeface name is missing, it is derived from the font section
  135.     heading by using the name from the left bracket up to the first dash.
  136.     The font style is then appended, using the same nomenclature as
  137.     WordPerfect:
  138.  
  139.        N = nothing is appended
  140.        B = (Bold)
  141.        I = (Italic)
  142.        T = (Bold Italic)
  143.  
  144.  
  145. Wt    This holds the typeface stroke weight for both WordPerfect 5.1 and
  146.     WordPerfect 5.0, respectively.
  147.  
  148.     For WordPerfect 5.1:
  149.  
  150.        0 = Extra Light
  151.        1 = Light
  152.        2 = Normal
  153.        3 = Demi-Bold
  154.        4 = Bold
  155.        5 = Heavy
  156.        6 = Black
  157.        7 = Ultra-Black
  158.  
  159.     For WordPerfect 5.0:
  160.  
  161.        0 = Extra Light
  162.        1 = Light
  163.        2 = Normal
  164.        3 = Bold
  165.        4 = Extra Bold
  166.  
  167.     If this line is missing, it is derived from the Vp code:
  168.  
  169.        N = "2 2"
  170.        B = "4 3"
  171.        I = "2 2"
  172.        T = "4 3"
  173.  
  174.  
  175. Wp    This is a hex representation of five bytes that describe the font's
  176.     characteristics.
  177.  
  178.     Bits in the first byte (font attributes):
  179.  
  180.        00000001 small caps       
  181.            00000010 shadow font      
  182.            00000100 outline font     
  183.            00001000 italic
  184.  
  185.     Bits in the second byte (appearance):
  186.  
  187.        00000001 casual        
  188.            00000010 connecting    
  189.            00000100 decorative    
  190.            00001000 formal        
  191.            00010000 futuristic    
  192.            00100000 old_style     
  193.            01000000 script
  194.  
  195.     Bits in the third byte (serifs):
  196.  
  197.        00000001 cupped      
  198.            00000010 exaggerated 
  199.            00000100 hairline    
  200.            00001000 slab        
  201.            00010000 slanted     
  202.            00100000 transitional
  203.            01000000 triangular  
  204.            10000000 ball serifs
  205.  
  206.     Bits in the fourth byte (shape):
  207.  
  208.        00000001 curved           
  209.            00000010 nonconnecting    
  210.            00000100 round            
  211.            00001000 square
  212.  
  213.     Bits in the fifth byte (stress):
  214.  
  215.        00000001 angular           
  216.            00000010 exaggerated       
  217.            00000100 uniform
  218.  
  219.     If the Wp line is missing, a default of "0 0 0 0 4" is used.
  220.  
  221.  
  222. Mt    These are the typeface's global font metrics.  Five numbers
  223.     on the line represent:
  224.  
  225.        Cap height      How far the capital H goes above the baseline.
  226.               See the CapHeight value (times 10) in the AFM file.
  227.  
  228.        Max descender  The maximum that the descender of a lower case p
  229.               goes below the baseline.  See the Descender value
  230.               (times 10) in the AFM file.
  231.  
  232.        X height      How far the lower-case x goes above the baseline.
  233.               See the XHeight value (times 10) in the AFM file.
  234.  
  235.        T height      How far the lower-case t goes above the baseline.
  236.               See the height of a lower case t (times 10) in
  237.               the AFM file.
  238.  
  239.        Max ascender      The maximum that the ascender of a lower case d
  240.               goes above the baseline.  See the Ascender value
  241.               (times 10) in the AFM file.
  242.  
  243.     By dividing each number by 100, we get a percentage of the current
  244.     font's point size (e.g 9076 is 90.76%).  These values are required.
  245.  
  246.  
  247. Ia    This describes how far italic or oblique characters are skewed
  248.     from vertical.  By dividing by 100, we convert it to a percentage.
  249.     If it is missing, zero is used.  See the ItalicAngle (times 100)
  250.     in the AFM file.
  251.  
  252.  
  253. Hp    This is the typeface code to use when ATWP sends soft fonts to
  254.     LaserJet printers.  It is important that each font family have a
  255.     unique typeface code (e.g. all the New Century Schoolbook fonts should
  256.     use 127, regardless of stroke weight).  This value is required.  See
  257.     the PCLTypefaceID in the INF file.
  258.  
  259.  
  260. Hw    This is the stroke weight code to use for HP soft fonts:
  261.  
  262.       -7 = ultra thin
  263.       -5 = thin
  264.       -3 = light
  265.        0 = medium
  266.        1 = demi
  267.        3 = bold
  268.        5 = black
  269.        7 = ultra black
  270.  
  271.     If it is missing, it will be derived from the Vp code:
  272.  
  273.        N = 0
  274.        B = 3
  275.        I = 0
  276.        T = 3
  277.  
  278.     See the PCLStrokeWeight value in the INF file.
  279.  
  280.  
  281. Hs    This is the style code to use for HP soft fonts:
  282.  
  283.        0 = upright
  284.        1 = italic or oblique
  285.        4 = condensed
  286.  
  287.     If it is missing, it will be derived from the Vp code:
  288.  
  289.        N = 0
  290.        B = 0
  291.        I = 1
  292.        T = 1
  293.  
  294.     See the PCLStyle value in the INF file.
  295.