Update to groff 1.19.2.
[dragonfly.git] / contrib / groff-1.19 / src / devices / grolj4 / lj4_font.man
1 .tr ~
2 .ig
3 Copyright (C) 2004 Free Software Foundation, Inc.
4
5 Permission is granted to make and distribute verbatim copies of
6 this manual provided the copyright notice and this permission notice
7 are preserved on all copies.
8
9 Permission is granted to copy and distribute modified versions of this
10 manual under the conditions for verbatim copying, provided that the
11 entire resulting derived work is distributed under the terms of a
12 permission notice identical to this one.
13
14 Permission is granted to copy and distribute translations of this
15 manual into another language, under the above conditions for modified
16 versions, except that this permission notice may be included in
17 translations approved by the Free Software Foundation instead of in
18 the original English.
19 ..
20 .\" Like TP, but if specified indent is more than half
21 .\" the current line-length - indent, use the default indent.
22 .de Tp
23 .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
24 .el .TP "\\$1"
25 ..
26 .tr ~
27 .TH LJ4_FONT @MAN5EXT@ "@MDATE@" "Groff Version @VERSION@"
28 .\" --------------------------------------------------------------------------
29 .SH NAME
30 .\" --------------------------------------------------------------------------
31 lj4_font \- groff fonts for use with devlj4
32 .\" --------------------------------------------------------------------------
33 .SH DESCRIPTION
34 .\" --------------------------------------------------------------------------
35 Nominally, all Hewlett-Packard LaserJet~4\(enseries and newer printers
36 have the same internal fonts: 45 scalable fonts and one bitmapped
37 Lineprinter font.
38 The scalable fonts are available in sizes between 0.25 point and 999.75
39 points, in 0.25-point increments; the Lineprinter font is available only
40 in 8.5-point size.
41 .LP
42 The LaserJet font files included with
43 .B groff
44 assume that all printers since the LaserJet~4 are identical.
45 There are some differences between fonts in the earlier and more recent
46 printers, however.
47 The LaserJet~4 printer used Agfa Intellifont technology for 35 of the
48 internal scalable fonts; the remaining 10 scalable fonts were TrueType.
49 Beginning with the LaserJet~4000\(enseries printers introduced in 1997,
50 all scalable internal fonts have been TrueType.
51 The number of printable glyphs differs slightly between Intellifont and
52 TrueType fonts (generally, the TrueType fonts include more glyphs), and
53 there are some minor differences in glyph metrics.
54 Differences among printer models are described in the
55 .I "PCL~5 Comparison Guide"
56 and the
57 .I "PCL~5 Comparison Guide Addendum"
58 (for printers introduced since approximately 2001).
59 .LP
60 LaserJet printers reference a glyph by a combination of a 256-glyph
61 symbol set and an index within that symbol set.
62 Many glyphs appear in more than one symbol set; all combinations of
63 symbol set and index that reference the same glyph are equivalent.
64 For each glyph,
65 .BR hpftodit (@MAN1EXT@)
66 searches a list of symbol sets, and selects the first set that contains
67 the glyph.
68 The printing code generated by
69 .BR hpftodit (@MAN1EXT@)
70 is an integer that encodes a numerical value for the symbol set in the
71 high byte(s), and the index in the low byte.
72 See
73 .BR groff_font (@MAN5EXT@)
74 for a complete description of the font file format; symbol sets are
75 described in greater detail in the
76 .IR "PCL~5 Printer Language Technical Reference Manual" .
77 .LP
78 Two of the scalable fonts, Symbol and Wingdings, are bound to
79 256-glyph symbol sets; the remaining scalable fonts, as well as the
80 Lineprinter font, support numerous symbol sets, sufficient to enable
81 printing of more than 600 glyphs.
82 .LP
83 The metrics generated by
84 .BR hpftodit (@MAN1EXT@)
85 assume that the DESC file contains values of 1200 for res and 6350 for
86 unitwidth (or any combination (e.g., 2400 and 3175) for which
87 res~\(mu~unitwidth~=~7\|620\|000).
88 Although HP PCL~5 LaserJet printers support an internal resolution of
89 7200 units per inch, they use a 16-bit signed integer for cursor
90 positioning; if
91 .B devlj4
92 is to support U.S. ledger paper (11\(sd~\(mu~17\(sd), the maximum usable
93 resolution is 32\|767~/~17, or 1927, units per inch, which rounds down to
94 1200 units per inch.
95 If the largest required paper size is less (e.g., 8.5\(sd~\(mu~11\(sd or
96 A5), a greater resolution (and lesser unitwidth) can be specified.
97 .\" --------------------------------------------------------------------------
98 .SH LIMITATIONS
99 .\" --------------------------------------------------------------------------
100 Font metrics for Intellifont fonts were provided by Tagged Font Metric
101 (TFM) files originally developed by Agfa/Compugraphic.
102 The TFM files provided for these fonts supported 600+ glyphs and
103 contained extensive lists of kern pairs.
104 .LP
105 To accommodate developers who had become accustomed to TFM files, HP also
106 provided TFM files for the 10 TrueType fonts included in the LaserJet~4.
107 The TFM files for TrueType fonts generally included less information
108 than the Intellifont TFMs, supporting fewer glyphs, and in most cases,
109 providing no kerning information.
110 By the time the LaserJet~4000 printer was introduced, most
111 developers had migrated to other means of obtaining font metrics,
112 and support for new TFM files was very limited.
113 The TFM files provided for the TrueType fonts in the LaserJet~4000
114 support only the Latin 2 (ISO 8859-2) symbol set, and include no kerning
115 information; consequently, they are of little value for any but the most
116 rudimentary documents.
117 .LP
118 Because the Intellifont TFM files contain considerably more information,
119 they generally are preferable to the TrueType TFM files even for use
120 with the TrueType fonts in the newer printers.
121 The metrics for the TrueType fonts are very close, though not identical,
122 to those for the earlier Intellifont fonts of the same names.
123 Although most output using the Intellifont metrics with the newer
124 printers is quite acceptable, a few glyphs may fail to print as
125 expected.
126 The differences in glyph metrics may be particularly noticeable with
127 composite parentheses, brackets, and braces used by
128 .BR eqn (@MAN1EXT@) .
129 A script, located in
130 .BR @FONTDIR@/devlj4/generate ,
131 can be used to adjust the metrics for these glyphs in the special font S
132 for use with printers that have all TrueType fonts.
133 .LP
134 At the time HP last supported TFM files, only Version 1 of the Unicode
135 standard was available.
136 Consequently, many glyphs lacking assigned code points were assigned by
137 HP to the Private Use Area (PUA).
138 Later versions of the Unicode standard included code points outside the
139 PUA for many of these glyphs.
140 The HP-supplied TrueType TFM files use the PUA assignments;
141 TFM files generated from more recent TrueType font files require the
142 later Unicode values to access the same glyphs.
143 Consequently, two different mapping files may be required: one for the
144 HP-supplied TFM files, and one for more recent TFM files.
145 .\" --------------------------------------------------------------------------
146 .SH FILES
147 .\" --------------------------------------------------------------------------
148 .Tp \w'\fB@FONTDIR@/devlj4/DESC'u+2n
149 .B @FONTDIR@/devlj4/DESC
150 Device description file.
151 .TP
152 .BI @FONTDIR@/devlj4/ F
153 Font description file for font
154 .IR F .
155 .\" --------------------------------------------------------------------------
156 .SH "SEE ALSO"
157 .\" --------------------------------------------------------------------------
158 .ad 0
159 .BR groff (@MAN1EXT@),
160 .BR groff_diff (@MAN1EXT@),
161 .BR hpftodit (@MAN1EXT@),
162 .BR grolj4 (@MAN1EXT@),
163 .BR groff_font (@MAN5EXT@)
164 .
165 .\" Local Variables:
166 .\" mode: nroff
167 .\" End: