Annotation of researchv10no/cmd/post.src/printfont/printfont.1, revision 1.1.1.1

1.1       root        1: .ds dQ /usr/lib/postscript
                      2: .TH PRINTFONT 1 "DWB 3.2"
                      3: .SH NAME
                      4: .B printfont
                      5: \- font listing program for PostScript printers
                      6: .SH SYNOPSIS
                      7: \*(mBprintfont\f1
                      8: .OP "" options []
                      9: .OP "" files []
                     10: .SH DESCRIPTION
                     11: .B printfont
                     12: builds a PostScript program that prints character set tables for
                     13: one or more PostScript fonts.
                     14: The program is written on the standard output,
                     15: and when sent to a PostScript printer usually prints a 16\(mu16 table
                     16: that shows the available (encoded) characters in each font.
                     17: The following
                     18: .I options
                     19: are understood:
                     20: .TP 1.0i
                     21: .OP \-a num
                     22: Set the character cell axes mode to
                     23: .IR num .
                     24: 0 disables axes printing, 1 draws a baseline,
                     25: 2 adds a vertical line through the character origin,
                     26: and 3 adds a vertical line through the next character origin.
                     27: The default is 0.
                     28: .TP 1.0i
                     29: .OP \-b num
                     30: Print each table in base
                     31: .IR num .
                     32: The base determines the number of rows and columns in the table.
                     33: It also affects the character code placed in the lower left corner of each cell.
                     34: The default is 16 (hexadecimal).
                     35: .TP 1.0i
                     36: .OP \-c num
                     37: Print
                     38: .I num
                     39: copies of each page.
                     40: By default only one copy is printed.
                     41: .TP 1.0i
                     42: .OP \-f name
                     43: Use font
                     44: .I name
                     45: for labeling the tables.
                     46: The default font is Helvetica.
                     47: .TP 1.0i
                     48: .OP \-g num
                     49: Use
                     50: .I num
                     51: as the gray level for marking cells not currently assigned to characters.
                     52: The gray level should fall between 0 (black) and 1 (white).
                     53: The default is 0.85.
                     54: .TP 1.0i
                     55: .OP \-m num
                     56: Magnify each logical page by the factor
                     57: .IR num .
                     58: Pages are scaled uniformly about the origin,
                     59: which is located near the upper left corner of each page.
                     60: The default is 1.0.
                     61: .TP 1.0i
                     62: .OP \-p mode
                     63: Print
                     64: .I files
                     65: in either \*(mBportrait\fP or \*(mBlandscape\fP
                     66: .IR mode .
                     67: Only the first character of
                     68: .I mode
                     69: is significant.
                     70: The default
                     71: .I mode
                     72: is \*(mBportrait\fP.
                     73: .TP 1.0i
                     74: .OP \-v
                     75: Completely label each character cell.
                     76: The full character name goes in the upper left corner and the
                     77: character width (at point size 1) goes in the lower right corner.
                     78: .TP 1.0i
                     79: .OP \-w num
                     80: Set the line width to
                     81: .I num
                     82: points, where a point is approximately 1/72 of an inch.
                     83: A line width of 0 means 1 pixel.
                     84: The default line width is resolution dependent.
                     85: .TP 1.0i
                     86: .OP \-x num
                     87: Translate the origin
                     88: .I num
                     89: inches along the x axis.
                     90: Positive
                     91: .I num
                     92: shifts the table to the right.
                     93: The default offset is 0.
                     94: .TP 1.0i
                     95: .OP \-y num
                     96: Translate the origin
                     97: .I num
                     98: inches along the y axis.
                     99: Positive
                    100: .I num
                    101: shifts the table up the page.
                    102: The default offset is 0.
                    103: .TP 1.0i
                    104: .OP \-C file
                    105: Copy
                    106: .I file
                    107: to the output file;
                    108: .B file
                    109: must contain legitimate PostScript.
                    110: .TP 1.0i
                    111: .OP \-E name
                    112: Set the character encoding for text fonts to
                    113: .IR name .
                    114: Requesting
                    115: .I name
                    116: means include file
                    117: .MI \*(dQ/ name .enc \f1.
                    118: A nonexistent encoding file is silently ignored.
                    119: The default selects file
                    120: .MR \*(dQ/Default.enc .
                    121: .TP 1.0i
                    122: .OP \-L file
                    123: Use
                    124: .I file
                    125: as the PostScript prologue.
                    126: .br
                    127: The default is
                    128: .MR \*(dQ/printfont.ps .
                    129: .PP
                    130: Arguments should be PostScript
                    131: .I font
                    132: names or the word
                    133: .MR all ,
                    134: which means the full set of
                    135: .SM ROM
                    136: and disk based fonts available on a printer.
                    137: .B printfont
                    138: prints one font table per page.
                    139: Each page is labeled with the
                    140: .I font
                    141: name, the printer product name and interpreter version number,
                    142: and the gray level, linewidth, and printer resolution.
                    143: .PP
                    144: Black cells are used to mark characters listed in the font's
                    145: .MW Encoding
                    146: array but missing from its
                    147: .MW CharStrings
                    148: dictionary.
                    149: They usually indicate an incomplete font or a mistake in the
                    150: .MW Encoding
                    151: array.
                    152: The check is skipped if the font doesn't include a
                    153: .MW CharStrings
                    154: dictionary.
                    155: .br
                    156: .ne 4v
                    157: .SH EXAMPLES
                    158: Print the characters available in the Times-Roman, Symbol and
                    159: ZapfDingbats fonts:
                    160: .EX
                    161: printfont Times-Roman Symbol ZapfDingbats | lp ...
                    162: .EE
                    163: Print a baseline under each character and fully label the cells:
                    164: .EX
                    165: printfont -a1 -v Times-Roman Symbol ZapfDingbats | lp ...
                    166: .EE
                    167: Dump all the fonts available on a printer using the Latin1 character encoding:
                    168: .EX
                    169: printfont -ELatin1 all | lp ...
                    170: .EE
                    171: .SH WARNINGS
                    172: Printing a single table can take several minutes.
                    173: Dumping all available fonts can tie a printer up for an hour or more.
                    174: .SH FILES
                    175: .MW \*(dQ/printfont.ps
                    176: .br
                    177: .MW \*(dQ/*.enc
                    178: .SH SEE ALSO
                    179: buildtables(1),
                    180: dpost(1),
                    181: postio(1),
                    182: psencoding(1),
                    183: trofftable(1)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.