1 .TH mkmupfnt 1 "July 31, 1999" "Arkkra Enterprises"
4 mkmupfnt - create fontfile for overriding Mup fonts
7 mkmupfnt \fIPostScript_font_name Mup_font_name outfile [file]\fP
10 The \fBmkmupfnt\fP program creates an \fIoutfile\fP that can be used
11 with the Mup "fontfile" statement to override a Mup font.
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.
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".
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.
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
35 An an example, suppose you want Mup to use the Helvetica-Narrow font
36 rather than the plain Helvetica font. You could use:
39 mkmupfnt Helvetica-Narrow HR helvnarr
42 to generate a Mup fontfile, then in your Mup program put:
48 Then anything that would normally be printed in Helvetica will come out
49 in Helvetica-Narrow instead.
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
55 The file can contain comment lines, which have a '#' in column 1.
56 Otherwise the format is:
61 \fBMup font name:\fP \fIMup_font_name\fP
62 \fBPostScript font name:\fP \fIPostScript_font_name\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
70 \fIZero or more lines of PostScript that will be copied
71 exactly as is to the end of the Mup PostScript prolog.\fP
78 mkmupfnt.ps PostScript program that extracts font size information
83 Mup \(em Music Publisher User's Guide
86 You must have ghostscript (gs or gs386.exe) in your PATH
87 and it must be built to include the "bit" device.
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.
99 Only the ASCII characters 32-126 can be overridden. The non-ASCII
100 characters can not be overridden.
102 Mup only allows width values up to 1/2 inch for
103 a 12-point character. This program does not enforce that limitation.
105 This program has been tested with various Ghostscript fonts,
106 but may not work on just any arbitrary PostScript font.
~mdw / mup / blob