1mkmupfnt(1) General Commands Manual mkmupfnt(1)
2
3
4
6 mkmupfnt - create fontfile for overriding Mup fonts
7
9 mkmupfnt PostScript_font_name Mup_font_name outfile [file]
10
12 The mkmupfnt program creates an outfile that can be used with the Mup
13 "fontfile" statement to override a Mup font.
14
15 The PostScript_font_name is the name of the font you want Mup to use.
16 This would be something that could be given as a name to the PostScript
17 findfont procedure.
18
19 The Mup_font_name is the name of the Mup font you want to override,
20 either an abbreviated name, like "PR" or a full name, like "palatino
21 rom".
22
23 The outfile is the file that will be generated, which will contain
24 character size and other information, to use with Mup's "fontfile"
25 statement.
26
27 The final optional file argument is the name of a file that contains
28 PostScript to be placed at the end of the Mup PostScript prolog. This
29 might be useful if you have a font whose implementation PostScript
30 could not find on its own. For example, if you've written your own font
31 implementation, you could put it in the given file. The actual charac‐
32 ters produced by the font need not be similar to those in the font
33 being replaced; they could be in some other alphabet, or hieroglyphics
34 or whatever you wish. However, see the CAVEATS section for limitations.
35
36 An an example, suppose you want Mup to use the Helvetica-Narrow font
37 rather than the plain Helvetica font. You could use:
38 mkmupfnt Helvetica-Narrow HR helvnarr
39 to generate a Mup fontfile, then in your Mup program put:
40 fontfile "helvnarr"
41 Then anything that would normally be printed in Helvetica will come out
42 in Helvetica-Narrow instead.
43
45 Mup requires a fontfile to be in a fairly rigid format. This section
46 describes the format of the file that is produced by mkmupfnt. The
47 file can contain comment lines, which have a '#' in column 1. Other‐
48 wise the format is:
49 Mup font name: Mup_font_name
50 PostScript font name: PostScript_font_name
51 Size data:
52 32 width height ascent
53 33 width height ascent
54 ... similar lines for ASCII codes 34-126.
55 Dimension are given in 1/1000ths of an inch for a 12-point character.
56 All codes must be specified, and they must be in order.
57 PostScript:
58 Zero or more lines of PostScript that will be copied
59 exactly as is to the end of the Mup PostScript prolog.
60
62 mkmupfnt.ps PostScript program that extracts font size information
63
65 gs(1), mup(1).
66 Mup — Music Publisher User's Guide
67
69 You must have ghostscript (gs or gs386.exe) in your PATH and it must be
70 built to include the "bit" device.
71
72 Mup uses certain fonts for certain things, such as time signatures,
73 octave marks, endings, tuplet numbers, etc. (The fonts used include
74 all the Times fonts and New Century bold, plus Helvetica roman and Hel‐
75 vetica bold for tablature.) If your override one of the fonts used for
76 those things, they will come out in your new font. On the one hand, if
77 you don't like Mup's choices, this provides you a way to get your own.
78 On the other hand, if you want to change most, but not all uses of a
79 particular font, it may not be possible to do that.
80
81 Only the ASCII characters 32-126 can be overridden. The non‐ASCII char‐
82 acters can not be overridden.
83
84 Mup only allows width values up to 1/2 inch for a 12‐point character.
85 This program does not enforce that limitation.
86
87 This program has been tested with various Ghostscript fonts, but may
88 not work on just any arbitrary PostScript font.
89
90
91
92Arkkra Enterprises November 22, 2012 mkmupfnt(1)