ttf2pt1_convert - Man Page

convenience font conversion script


ttf2pt1_convert [config-file]


Ttf2pt1_Convert' is the master conversion script provided with ttf2pt1.

If the configuration file is not specified as an argument then the file `convert.cfg' in the current directory is used. This file contains a set of configuration variables. The distribution contains a sample file file `convert.cfg.sample'. Please copy it to `convert.cfg', look inside it and change the configuration variables. The more stable configuration variables, such as the path names of the scripts and encoding files are located in `ttf2pt1_convert' itself, they are automatically updated when installing ttf2pt1.

Put all the TTF fonts you want to convert into some directory (this may be just the directory that already contains all the Windows fonts on a mounted FAT filesystem). If you have fonts in different source encoding then put the fonts in each of the encodings into a separate directory. Up to 10 source directories are supported. If you (in a rather unlikely case) have more source directories then you can make two separate runs of the converter, converting up to 10 directories at a time.

The variables in the configuration file are:

The next few parameters control the general behavior of the converter. They default values are set to something reasonable.

The following parameters are used to locate the other scripts and configuration files. By default the scripts do a bit of guessing for them: they search in the ttf2pt1 installation directory if ttf2pt1 was installed or otherwise suppose that you are running `ttf2pt1_convert' with `scripts' subdirectory being the current directory.

Besides that a few parameters are built into the `ttf2pt1_convert' script itself. You probably won't need to change them:

Also there are a few parameters controlling the installation of fonts for Ghostscript. Please look at their description in the  Ghostscript section of documentation or in the ttf2pt1_x2gs(1) manual page before running `ttf2pt1_convert'. If these parameters are set, `ttf2pt1_convert' will call the `x2gs' script automatically to install the newly converted fonts in Ghostscript.

After creating the configuration file run the `ttf2pt1_convert' script. Look at the result and the log file in DSTDIR.

Add the directory with newly converted fonts to the configuration of X server or font server. For most of the systems this step is very straightforward. For HP-UX it's rather tricky and poorly documented, so the file FONTS.hpux gives a short description.

If you don't have the privileges of the root user, you still can configure your private font server. Just use some non-standard port number (see FONTS.hpux for an example, exept that you won't need all the HP-related stuff on any other system).


See Also


Known problems

  • The fonts.scale files created by the older versions of the ttf2pt1 installation program (up to release 3.1) have conflicted  with the language definitions of the Xfsft font server and parts of it included into XFree86. To overcome this incompatibility the never versions creats the fonts.scale file describing all the fonts as belonging to the adobe-fontspecific encoding and the fonts.alias file with the proper names. The drawback of this solution is that xlsfonts gives the list of twice more fonts. But as a side effect the option ENFORCEISO in `convert.cfg' is not required for X11 any more.
  • The conversion script has no support for Eastern multi-plane fonts. Contribution of such a support would be welcome.

Referenced By

ttf2pt1(1), ttf2pt1_x2gs(1).

December 31, 2003 version 3.4.4 TTF2PT1 Font Converter