=== === === === === === === === === === === === === === === === === === ===
 ENGLISH:
=== === === === === === === === === === === === === === === === === === ===
This is METATYPE1 package -- a tool for creating Type 1 fonts using METAPOST
Version: 0.40 (11.06.2003)
Author: JNS team <JNSteam@gust.org.pl>

Warning: package is still under development, upwards incompatible
changes are likely to occur.

The METATYPE1 package consist of:
   mt1set.bat    -- a batch file that sets the system variable METATYPE1;
                    it is exploited by other batches of the package
   mkfont.bat    -- a batch file for the generation of a font; it should be
                    called with the font file name without an extension
                    (there are two batches more related to mkfont.bat,
                    namely: mkt1.bat generates a Type 1 font without
                    generating a tfm metric file and mktfm.bat that
                    generates only a tfm file)
   fontbase.mp   -- a set of METAPOST macros for creating Type 1 fonts
   plain_ex.mp   -- an extension of plain.mp, useful not only for
                    creating fonts; it is input by fontbase.mp;
   plain_e_.mp   -- the set of illustrations to plain_ex.mp documentation
   mp2pf.awk     -- an AWK script that creates Type1 font (in a text form)
                    out of METAPOST generated EPSes
   pfcommon.dat  -- data for mp2pf.awk script (fixed elements of font)
   encqxtex.mp   -- a sample encoding file: QX layout in a TeX-oriented
                    incarnation 
   encqxwin.mp   -- a complementary encoding file: QX layout
                    in a Windows-oriented incarnation
   packsubr.awk  -- AWK script for making subroutines out of the repeating 
                    fragments of PostScript code in a font file
   afm2pfm.bat   -- a batch file that converts an AFM file (Adobe font
                    metric) into a PFM (printer font metric) one
   afm2pfm.pl    -- a Perl script for the above conversion

   mkproof.bat   -- a batch file for running mft (METAFONT nad METAPOST 
                    formatting) program; the usage is described in the file
   mt1form.mft   -- formatting data, necessary for mft program
   mt1form.sty   -- TeX (plain) macros for formatting documentation
   README        -- this file

Additionally, the METATYPE1 distribution contains the pf2mt1 package for
converting converting a Type 1 font into a METATYPE1 form. The conversion
preserves as much as possible font parameters; the resulting font generated
by METATYPE1 is, in normal circumstances, almost identical with the
original one. The package pf2mt1 consists of three files:
  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 or renamed during it
This package is useful for beginners who would like to see how METATYPE1
works. The fonts generated by pf2mt1 are a good example of using
the METATYPE1 package, although they do not make use of all possibilities
it offers (in particular, the resulting fonts are not parameterized).

The METATYPE1 package requires the following external programs (in
parentheses are given the versions which we use):
   Metapost (0.641), with plain (0.63) format
   Gawk (3.0.3)
   t1utils (t1asm and t1disasm, 1.26; http://www.lcdf.org/~eddietwo/type/)
The package also employs:
   Perl (5.005_03)   -- for generating PFM files (afm2pfm.bat)
   MFT (Web2C 7.3.7x, 2.0) -- for formatting documentation (mkproof.bat)
   EPSINCL (0.41)  -- for including stencil EPSes into documentation;
                      this package is attached in the subdirectory ``extra'' 

In order to install the package, you should copy batch files into an
appropriate subdirectory searched by system (environment variable PATH),
and change the setting of the METATYPE1 enviroment variable in the batch
mt1set.bat adequately to the location of the METATYPE1 package in your
system.

The subdirectory ``samples'' contains examples of METATYPE1 sources
of a few trivial fonts. They may be treated as a part of the documentation
of the METATYPE1 package.

We suggest familiarising with a METATYPE1 version of D. E. Knuth's
logo font (the file logo-mp.zip)---alike pf2mt1 package, it may
prove useful useful during the first steps in METATYPE1.

=== === === === === === === === === === === === === === === === === === ===
 POLSKI:
=== === === === === === === === === === === === === === === === === === ===
To jest pakiet METATYPE1 -- narz/edzie do tworzenia font/ow Type 1
za pomoc/a systemu METAPOST
Wersja: 0.40 (11.06.2003).
Autorstwo: JNS team <JNSteam@gust.org.pl>

Uwaga: pakiet znajduje si/e w fazie rozwoju, mo/zliwe s/a jeszcze
       zmiany niekompatybilne wstecz.

W sk/lad pakietu METATYPE1 wchodz/a:
   mt1set.bat    -- plik wsadowy ustawiaj/acy zmienn/a systemow/a
                    METATYPE1; pozosta/le pliki wsadowe pakietu
                    odwo/luj/a si/e do mt1set.bat
   mkfont.bat    -- plik wsadowy uruchamiaj/acy proces tworzenia fontu;
                    parametrem jest nazwa fontu bez rozszerzenia
   fontbase.mp   -- zestaw makr METAPOST-owych, umo/zliwiaj/acych
                    generowanie font/ow Type 1
   plain_ex.mp   -- rozszerzenie formatu plain.mp, przydatne nie tylko
                    przy generowaniu font/ow, wczytywane przez fontbase.mp
   plain_e_.mp   -- ilustracje do dokumentacji plain_ex.mp
   mp2pf.awk     -- podstawowy skrypt AWK-owy, tworz/acy font Type 1
                    (w postaci tekstowej) na podstawie EPS-/ow generowanych
                    przez METAPOST-a
   pfcommon.dat  -- dane dla skryptu mp2pf.awk (sta/le elementy fontu)
   encqxtex.mp   -- przyk/ladowy plik zawieraj/acy przypisane nazw znak/ow
                    do ich numer/ow (encoding) zgodne ze standardem QX,
                    a dok/ladniej jego TeX-owym wcieleniem
   encqxwin.mp   -- analogiczny plik zawieraj/acy uk/lad QX we wcieleniu
                    windowsowym
   packsubr.awk  -- skrypt AWK-owy u/zywany do znajdowania w foncie
                    powtarzaj/acych si/e fragment/ow kodu postscriptowego
                    i zast/epowania ich odwo/laniami do procedur
   afm2pfm.bat   -- plik wsadowy uruchamiaj/acy skrypt do generowania
                    plik/ow PFM (Printer Font Metrics) na podstawie danych
                    metrycznych zawartych w pliku AFM (Adobe font metric)
   afm2pfm.pl    -- skrypt w Perlu, realizuj/acy proces opisany powy/zej

   mkproof.bat   -- plik wsadowy uruchamiaj/acy program mft (formater plik/ow
                    METAFONT-owych i METAPOST-owych); spos/ob wywo/lania tego
                    pliku zosta/l opisany w komentarzach na jego pocz/atku
   mt1form.mft   -- dane steruj/ace formatowaniem, wymagane przez program mft
   mt1form.sty   -- makra TeX-owe (plain), u/zywane do formatowania
                    dokumentacji
   README        -- niniejszy plik

Dodatkowo w zestawie znajduje si/e pakiet pf2mt1, umo/zliwiaj/acy
przekszta/lcenie fontu PostScript-owego w formacie Type1 na posta/c
METAPOST-ow/a zgodn/a z konwencjami METATYPE1. W trakcie konwersji
praktycznie wszystkie parametry fontu /xr/od/lowego s/a zachowywane,
co umo/zliwia (w normalnych warunkach) odtworzenie niemal/ze bez zmian
fontu wynikowego). 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. b/ad/x nie podlegaj/acych konwersji,
                  b/ad/x przenazwowywanych w trakcie konwersji.
Pakiet pf2mt1 mo/ze by/c przydatny dla pocz/atkuj/acych u/zytkownik/ow
METATYPE1. Fonty wygenerowane przez pf2mt1 stanowi/a dobry przyk/lad
u/zycia pakietu METATYPE1, cho/c oczywi/scie nie wykorzystuj/a jego
wszystkich mo/zliwo/si (np. parametryzacji).

Do dzia/lania pakietu METATYPE1 niezb/edne s/a nast/epuj/ace
zewn/etrzne programy (w nawiasach numery wersji kt/orych u/zywamy):
   Metapost (0.641), z formatem plain (0.63)
   Gawk (3.0.3)
   t1utils (t1asm and t1disasm, 1.26; http://www.lcdf.org/~eddietwo/type/)
U/zywane s/a r/ownie/z:
   Perl (5.005_03)   -- do generowania PFM-/ow (afm2pfm.bat)
   MFT  (Web2C 7.3.7x, 2.0) -- do formatowania dokumentacji (mkproof.bat)
   EPSINCL (0.41)  -- do ewentualnego do/l/aczania EPS-/ow podk/ladowych
                      (stencils) do tworzonej dokumentacji; pakiet
                      ten znajduje si/e w katalogu ,,extra''

Instalacja sprowadza si/e do skopiowania plik/ow wsadowych do katalogu
znajduj/acego si/e w /sciezce przeszukiwania (PATH) oraz uaktalnienia
w pliku mt1set.bat ustawienia zmiennej systemowej METATYPE1 zgodnie
z po/lo/zeniem pakietu w drzewie katalog/ow.

W katalogu ,,samples'' znajduj/a si/e przyk/lady u/zycia pakietu METATYPE1;
mo/zna je traktowa/c jako dodatkow/a dokumentacj/e.

Polecamy zapoznanie si/e z wersj/a METATYPE1 fontu LOGO zawart/a w pliku
logo-mp.zip -- podobnie jak pakiet ,,pf2mt1'' mo/ze okaza/c si/e
przydatny podczas pierwszych pr/ob tworzenia font/ow.

