=== === === === === === === === === === === === === === === === === === ===
 ENGLISH:
=== === === === === === === === === === === === === === === === === === ===
The files in this directory ARE NOT a part of the METATYPE1 package,
although they are either use it or are used by it.

The ``extra'' directory contains:

-- The pf2mt1 package (it is a natural counterpart of the METATYPE1 package);
   its purpose is converting a Type 1 font into a METAPOST one.
   The conversion preserves nearly all font parameters; 
   the resulting font generated by METATYPE1 is, from a practical
   point of view, almost identical with the source one
   The package pf2mt1 consists of:
      pf2mt1.bat  -- batch file; its parameter is the name of the font
                     (without an extension); the font must consist of
                     PFB and AFM files
      pf2mt1.awk  -- AWK script; the main engine
      pf2mt1.exc  -- a sample file defining ``exception chars,'' i.e.,
                     excluded from the conversion

-- The epsincl package for embedding external EPSes into files generated
   by METAPOST. The package is distributed separately and can be used
   independently of the METATYPE1 package. It has been included here
   because the METATYPE1 package makes use of it for including ``stencils''
   (useful for making replicas of traditional fonts). The package epsincl
   consists of:
      epsincl.mp  -- METAPOST macros; the main macros is use_eps(EPS_name)
                     returning an object of a picture type
      epsincl.bat -- batch file; its parameter is a name of an EPS file
                     to which the external EPSes are to be inserted
      epsincl.awk -- AWK script -- performs the main job of the inserting
                     of the external EPSes

-- README: this file

The programs listed above require GAWK (we used ver. 3.0.3), 
the package pf2mt1 requires the program t1disasm (t1utils, ver. 1.4),
and the epsincl package requires METAPOST.

The fonts generated by pf2mt1 are a good example of using
the METATYPE1 package, although they do not make use of 
possibilities it offers (in particular, the resulting fonts
are not parameterized).

=== === === === === === === === === === === === === === === === === === ===
 POLSKI:
=== === === === === === === === === === === === === === === === === === ===
Pliki, kt/ore zawiera ten katalog, NIE s/a cze/sci/a pakietu METATYPE1,
aczkolwiek s/a z nim zwi/azane i albo przez niego wykorzystywane,
albo go wykorzystuj/a.

W katalogu ,,extra'' znajduj/a si/e:

-- Pakiet pf2mt1 stanowi/acy naturalne dope/lnienie pakietu METATYPE1;
   umo/zliwia przekszta/lcenie fontu PostScript-owego w formacie Type1 do
   postaci METAPOST-owej. Zamiana ta zachowuje prawie wszystkie parametry 
   fontu (praktycznie umo/zliwia odtworzenie fontu /xr/od/lowego).
   W sk/lad tego pakietu wchodz/a:
      pf2mt1.bat  -- plik wsadowy uruchamiaj/acy proces konwersji fontu
                     do postaci METATYPE1; jego parametrem jest nazwa
                     fontu bez rozszerzenia (font musi sk/lada/c si/e 
                     z pliku PFB oraz AFM)
      pf2mt1.awk  -- podstawowy skrypt AWK-owy, dokonuj/acy konwersji
      pf2mt1.exc  -- przyk/ladowy plik zawieraj/acy definincj/e ,,znak/ow 
                     wyj/atkowych'', tzn. nie podlegaj/acych konwersji

-- Pakiet epsincl umo/zliwiaj/acy wstawianie dowolnych plik/ow EPS-owych
   do plik/ow EPS tworzonych przez METAPOST-a. Pakiet ten jest dystrubowany
   i mo/ze by/c stosowany oddzielnie, zosta/l tutaj za/l/aczony ze wzgl/edu na
   to, /ze pakiet METATYPE1 wykorzystuje go podczas sk/ladania dokumentacji 
   zawieraj/acej EPS-y ,,,podk/ladowe'' (np. z rysunkami, na podstawie
   kt/orych tworzymy font). W sk/lad pakietu ,,epsincl''  wchodz/a:
      epsincl.mp  -- pakiet makr METAPOST-owych umo/zliwiaj/acych /latwe 
                     wstawanie zewn/etrznych EPS-/ow; podstawowym makrem
                     tego pakietu jest use_eps(nazwa_pliku_eps) zwracaj/ace
                     obiekt typu picture
      epsincl.bat -- plik wsadowy uruchamiaj/acy proces wstawiania plik/ow 
                     EPS do pliku wynikowego METAPOST-a; jego parametrem
                     jest nazwa pliku do kt/orego maj/a by/c do/l/aczone 
                     zewn/etrzne EPS-y
      epsincl.awk -- skrypt AWK-owy dokonuj/acy wstawienia EPS-/ow

-- plik README, kt/ory w/la/snie czytasz

Do dzia/lania powy/zszych program/ow niezb/edny jest GAWK (u/zywali/smy
wersji 3.0.3), pakiet pf2mt1 wymaga programu t1disasm (t1utils, wer. 1.4),
a pakiet epsincl -- METAPOST-a.

Fonty wygenerowane przez pf2mt1 stanowi/a dobry przyk/lad u/zycia
pakietu METATYPE1, cho/c oczywi/scie nie wykorzystuj/a pot/egi jego
instrukcji rysuj/acych i mo/zliwo/sci parametryzacji.

