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

                     Description of the
               font setup for VTeX/Free v7.10
          
------------------------------------------------------------
                        preliminary edition as of 2000-08-24
                                              Walter Schmidt
                                 walter.schmidt@arcormail.de



How VTeX is invoked
-------------------
The configuration described here assumes the following 
options for running VTeX:

  -ov -ofpdf ... -$p(,...   (PDF mode)

  -ov -ofps ... -$s(...     (PostScript mode)

Thus, the font setup for PDF mode is read from the file
pdf.fm, and the font setup for PostScript mode is read from
ps.fm.



The .fm files
-------------
The .fm files are made up from several "sections":

LOCAL-OS2 and LOCAL-LNX:  these sections define local
  variables, which can subsequently be referred to in the
  aliasing files; LOCAL-OS2 is evaluated with OS/2 only, 
  wheras LOCAL-LNX is for Linux
  
PSRENAME:  here the name of the file is to be given, which
  contains the list of base font substitutions

A4FIXTABLE:  the name of the file, which contains the list
  of of fonts to be treated in a special way so as to fix
  PCL printing with Acrobat4
  
TYPE1: this section lists the "aliasing" files (i.e, the 
  font maps)

%% This is pdf.fm
LOCAL-OS2 {
  TEXMF = "c:/texmf/"
  URW = "c:/gstools/fonts/"
  }
LOCAL-LNX {
  TEXMF = "/usr/local/vtex/texmf/"
  URW = "/usr/share/ghostscript/fonts/"
  }
PSRENAME {
  fontname.fix
  }
A4FIXTABLE {
  a4type1.fix
  }
TYPE1 {
  pdfbase.ali
  cm.ali
  euler.ali
  hoekwater.ali
  eurofont.ali
  charter.ali
  utopia.ali
  xypic.ali
  tmmath.ali
  hvmath.ali
  ifmath.ali
  cmbright.ali
  }
%% end of file

ps.fm differs only as to loading posbase.ali in place of 
pdfbase.ali.

The following local variables are evaluated in the aliasing
files (.ali ) and _must_ be defined in the .fm files:

  $TEXMF$  the root directory of the TDS tree; Type1 fonts 
           must be located below $TEXMF$fonts/type1 then.

  $URW$    where the Type1 fonts from URW are located;
           we use the fonts that come with Ghostscript

* 
* The setings of TEXMF and URW must reflect the
* directory structure of your (!) TeX system.
*
* Notice that the file names use slashes with OS/2, too (as
* opposed to backslashes), and that the local variables 
* _must_ supply a trailing slash!                                  
*

You may define further variables and use them in the font 
map files; however, $TEXMF$ and $URW$ must always be 
defined.



The "aliasing" files
--------------------
These files establish the relation between the tfm names
used by TeX and the Type1 (.pfb) font files.  The following
files reside in the directory texmf/vtex/config :

file:           fonts covered:

pdfbase.ali     the Base35 fonts, for use with PDF mode
psbase.ali      dito, for PostScript mode
cm.ali          CM, LaTeX symbols, AMS symbols, AMS Cyrillic
euler.ali       Euler fonts
hoekwater.ali   RSFS, wasy, mflogo, manfnt
eurofont.ali    Adobe Euro fonts
xypic.ali       XYPIC arrow tips
charter.ali     Charter
utopia.ali      Utopia
tmmath.ali      TM-Math
hvmath.ali      HV-Math
ifmath.ali      IF-Math
cmbright.ali    CM-Bright

Notice that the font families TM-Math, HV-Math, IF-Math,
CM-Bright and the XYpic-fonts are _not_ part of the
distribution.  The metrics and aliasing files are provided,
so as to make installing these fonts very easy.



Base Font substitition
----------------------
The .ali files for the Base fonts must list the FontNames of
the standard Adobe fonts, so that PostScript code can refer
to these.  However, we can actually use other fonts, e.g.,
from URW.  The file texmf/vtex/config/fontname.fix maps the
Adobe font names to the actual ones.

Notice that Times, Helvetica and Courier are special:  They
must not be listed here, but can `silently' be replaced with
(only!) URW's or MicroPress' clones.



The PostScript Base Fonts
-------------------------
The font map files pdfbase.ali and posbase.ali assume that

- Type1 fonts from URW are provided in the directory $URW$

- the .pfb files have their original names as supplied with 
  Ghostscript

- the tfm's of the raw (not-reencoded) fonts have URW names,
  too, except for Symbol="psyr" and ZapfDingbats="pzdr".
  The raw metrics are special for VTeX, i.e., the PSNFSS
  distribution on CTAN does _not_ include them, except for
  psyr.tfm and pzdr.tfm).

- the tfm's of the reencoded fonts are named according to 
  the KB scheme; we use the metrics supplied with PSNFSS.

The font map file posbase.ali (used with PS mode) assumes
that all 35 Base Fonts are provided by the interpreter,
i.e., VTeX will not embed them into the document.

The font map file pdfbase.ali (used with PDF mode) makes
VTeX download these fonts, except for the `Base14' (4xTimes,
4xHelvetica, 4xCourier, Symbol, ZapfDingbats).



Other fonts
-----------
The names of the remaining .ali files indicate the fonts
they refer to.  The .pfb files are searched under
texmf/fonts/type1; the directories are the same as with
previous VTeX/Free.  

All Type1 fonts and the related metrics are available with
any decent LaTeX system; the metrics for (re-encoded)
Charter and Utopia fonts are supplied with PSNFSS.
Exception:  The metrics for the "raw" Charter and Utopia
fonts are special for VTeX.



Substituting missing fonts
--------------------------
The file texmf/vtex/config/preload.cfg declares a number of 
\aliasfont's.  These cover

- standard fonts which are not part of the BlueSky font set,
  such as cmmib6, cmmib8  etc.

- artificially slanted fonts which are used by the basic
  PSNFSS, such as ptmro8r or eurmo10.

Notice that this affects LaTeX only, as opposed to plain 
TeX (unless you copy these commands into plain.cfg, too).



Embedding the base fonts
------------------------
Acrobat 4 will substitute Helvetica with Arial and Times
with TimesNewRomanPSMT, when displaying the PDF file on
screen or printing on a non-PostScript printer.

If you want to assure that your document looks the same way
on all printers, you must embed the base Times and Helvetica
fonts.  It really does not matter which variant of the fonts
you embed (Adobe, URW, MicroPress), however, using Adobe's
has two advantages:
        
1. You will have exactly the traditional appearance of the
Times Roman and Helvetica
                        
2. In the case of Helvetica only, URW has a minor bug with
the German sharp s (\ss).  Thus, for German language
documents, embedding URW Helvetica is not recommended.

Doing so requires editing the file pdfbase.ali
appropriately, i.e., 

- remove the "!"  from the entries for these fonts.
- change the name of the .pfb files appropriately
- add an appropriate directory definition to pdfbase.fm and
  change the entries so as to refer to this directory

One way to obtain these fonts is to locate a copy of
Acrobat3 on the net, install it, and copy these fonts (8
fonts with names starting with "hv" and "ti") from an
installed copy.



PSNFSS
------
The font setup described here works in conjunction with the
latest PSNFSS 8.1, which is distributed in conjunction with 
VTeX/Free.


-- finis

