Initial release of Maemo 5 port of gnuplot
[gnuplot] / docs / old / README.mf
1 METAFONT Terminal Driver for gnuplot (mf.trm):
2 ----------------------------------------------
3
4 The METAFONT terminal driver creates a input file to the METAFONT program.
5 Thus a figure may be used in the TeX document in the same way as a
6 character is.
7
8 To use the plot in a document the METAFONT program must be run
9 with the output file from gnuplot as input. Thus, the user needs a basic
10 knowledge of the font creating prosess and inclusion of a new font in a
11 document. However, if the METAFONT program are set up properly at the
12 local site an unexperienced user could perform the operation without
13 much trouble.
14
15 The text support is based on a METAFONT character set.
16 Currently the Computer Modern Roman font set is input but the
17 user are in principal free to chose whatever fonts he/she needs.
18 The METAFONT source files for the chosen font must be available.
19 Each character is stored in a separate picture variable in METAFONT. These
20 variables may be manipulated (rotated, scaled etc.) when characters are
21 needed. The drawback is the interpretation time in the METAFONT
22 program. On some machines (i.e. PC) the limited amount of memory available
23 may also cause problem if too many pictures are stored.
24
25 To use the METAFONT terminal driver:
26 ------------------------------------
27 1) In gnuplot use:   set terminal mf
28                      set output "myfile.mf"
29                           .
30                           .
31                           .
32                      plot ....
33                      exit
34
35
36 2) Run METAFONT. Syntax is site dependant:
37
38    On my UNIX I use:   cmmf '\mode=localfont; \mag=1;' input myfile.mf
39    On my PC I use:     mf286 &cm \mode=localfont; \mag=1; input myfile.mf
40
41    Be aware that METAFONT can only handle number less than 4096. Thus if you
42
43    have very high resolution in your localfont and a large picture you will
44    probably get an error message when running METAFONT. To solve the
45 problem,
46    reduce the resolution or the plot size.
47
48 3) Run GfToPk, syntax is
49
50    on my UNIX:   gftpk myfile.xxxgf myfile.pk
51    on my PC:     gftpk myfile.xxx myfile.pk
52
53    where xxx is the resolution (typically 300).
54
55 4) Copy the files myfile.pk and myfile.tfm to a place where you are sure TeX
56    and the dvi processing programs you use  can find them. (They can
57 probably
58    be located in your current working directory)
59
60 5) Include in your TeX document the following statement:
61
62       \font\myfont=myfile  % Declares the new font you just have made
63       {\myfont\char0}      % Typeset character with code zero which
64                            % MF.TRM uses as default character
65
66 Paal Hedne
67 SINTEF Multiphase Laboratory
68 N-7034 Trondheim
69 Norway
70
71 Tel.: -47-7-591060
72 E.mail: Pal.Hedne@termo.unit.no