| 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. |