Commit | Line | Data |
---|---|---|
fac14bbe MW |
1 | .TH mkmupfnt 1 "July 31, 1999" "Arkkra Enterprises" |
2 | .SH NAME | |
3 | .PP | |
4 | mkmupfnt - create fontfile for overriding Mup fonts | |
5 | .SH SYNOPSIS | |
6 | .PP | |
7 | mkmupfnt \fIPostScript_font_name Mup_font_name outfile [file]\fP | |
8 | .SH DESCRIPTION | |
9 | .PP | |
10 | The \fBmkmupfnt\fP program creates an \fIoutfile\fP that can be used | |
11 | with the Mup "fontfile" statement to override a Mup font. | |
12 | .PP | |
13 | The \fIPostScript_font_name\fP is the name of the font you want Mup | |
14 | to use. This would be something that could be given as a name | |
15 | to the PostScript \fBfindfont\fP procedure. | |
16 | .PP | |
17 | The \fIMup_font_name\fP is the name of the Mup font you want to | |
18 | override, either an abbreviated name, like "PR" or a full | |
19 | name, like "palatino rom". | |
20 | .PP | |
21 | The \fIoutfile\fP is the file that will be generated, which will | |
22 | contain character size and other information, to use with | |
23 | Mup's "fontfile" statement. | |
24 | .PP | |
25 | The final optional \fIfile\fP argument is the name of a file that | |
26 | contains PostScript to be placed at the end of the Mup PostScript prolog. | |
27 | This might be useful if you have a font whose implementation PostScript could | |
28 | not find on its own. For example, if you've written your own font | |
29 | implementation, you could put it in the given \fIfile\fP. | |
30 | The actual characters produced by the font need not be similar to those | |
31 | in the font being replaced; they could be in some other alphabet, | |
32 | or hieroglyphics or whatever you wish. However, see the CAVEATS section | |
33 | for limitations. | |
34 | .PP | |
35 | An an example, suppose you want Mup to use the Helvetica-Narrow font | |
36 | rather than the plain Helvetica font. You could use: | |
37 | .br | |
38 | .in +0.5i | |
39 | mkmupfnt Helvetica-Narrow HR helvnarr | |
40 | .in -0.5i | |
41 | .br | |
42 | to generate a Mup fontfile, then in your Mup program put: | |
43 | .br | |
44 | .in +0.5i | |
45 | fontfile "helvnarr" | |
46 | .in -0.5i | |
47 | .br | |
48 | Then anything that would normally be printed in Helvetica will come out | |
49 | in Helvetica-Narrow instead. | |
50 | .SH "FILE FORMAT" | |
51 | .PP | |
52 | Mup requires a \fIfontfile\fP to be in a fairly rigid format. | |
53 | This section describes the format of the file that is produced by | |
54 | mkmupfnt. | |
55 | The file can contain comment lines, which have a '#' in column 1. | |
56 | Otherwise the format is: | |
57 | .br | |
58 | .nf | |
59 | .na | |
60 | .in +0.3i | |
61 | \fBMup font name:\fP \fIMup_font_name\fP | |
62 | \fBPostScript font name:\fP \fIPostScript_font_name\fP | |
63 | \fBSize data:\fP | |
64 | \fB32\fP \fIwidth height ascent\fP | |
65 | \fB33\fP \fIwidth height ascent\fP | |
66 | \fI... similar lines for ASCII codes 34-126. | |
67 | Dimension are given in 1/1000ths of an inch for a 12-point character. | |
68 | All codes must be specified, and they must be in order.\fP | |
69 | \fBPostScript:\fP | |
70 | \fIZero or more lines of PostScript that will be copied | |
71 | exactly as is to the end of the Mup PostScript prolog.\fP | |
72 | .br | |
73 | .in -0.3i | |
74 | .fi | |
75 | .ad | |
76 | .SH FILES | |
77 | .P | |
78 | mkmupfnt.ps PostScript program that extracts font size information | |
79 | .SH "SEE ALSO" | |
80 | .PP | |
81 | gs(1), mup(1). | |
82 | .br | |
83 | Mup \(em Music Publisher User's Guide | |
84 | .SH "CAVEATS" | |
85 | .PP | |
86 | You must have ghostscript (gs or gs386.exe) in your PATH | |
87 | and it must be built to include the "bit" device. | |
88 | .PP | |
89 | Mup uses certain fonts for certain things, such as | |
90 | time signatures, octave marks, endings, tuplet numbers, etc. | |
91 | (The fonts used include all the Times fonts and New Century bold, plus | |
92 | Helvetica roman and Helvetica bold for tablature.) | |
93 | If your override one of the fonts used for those things, they will | |
94 | come out in your new font. On the one hand, if you don't like Mup's | |
95 | choices, this provides you a way to get your own. On the other hand, | |
96 | if you want to change most, but not all uses of a particular font, | |
97 | it may not be possible to do that. | |
98 | .PP | |
99 | Only the ASCII characters 32-126 can be overridden. The non-ASCII | |
100 | characters can not be overridden. | |
101 | .PP | |
102 | Mup only allows width values up to 1/2 inch for | |
103 | a 12-point character. This program does not enforce that limitation. | |
104 | .PP | |
105 | This program has been tested with various Ghostscript fonts, | |
106 | but may not work on just any arbitrary PostScript font. |