src/devices/grolj4/lj4_font.5.man

   1 .TH LJ4_FONT @MAN5EXT@ "@MDATE@" "groff @VERSION@"
   2 .SH NAME
   3 lj4_font \- groff fonts for use with devlj4
   4 .
   5 .
   6 .\" ====================================================================
   7 .\" Legal Terms
   8 .\" ====================================================================
   9 .\"
  10 .\" Copyright (C) 2004-2018 Free Software Foundation, Inc.
  11 .\"
  12 .\" Permission is granted to make and distribute verbatim copies of this
  13 .\" manual provided the copyright notice and this permission notice are
  14 .\" preserved on all copies.
  15 .\"
  16 .\" Permission is granted to copy and distribute modified versions of
  17 .\" this manual under the conditions for verbatim copying, provided that
  18 .\" the entire resulting derived work is distributed under the terms of
  19 .\" a permission notice identical to this one.
  20 .\"
  21 .\" Permission is granted to copy and distribute translations of this
  22 .\" manual into another language, under the above conditions for
  23 .\" modified versions, except that this permission notice may be
  24 .\" included in translations approved by the Free Software Foundation
  25 .\" instead of in the original English.
  26 .
  27 .
  28 .\" ====================================================================
  29 .SH DESCRIPTION
  30 .\" ====================================================================
  31 .
  32 Nominally,
  33 all Hewlett-Packard LaserJet\~\%4-series and newer printers have the
  34 same internal fonts:
  35 45 scalable fonts and one bitmapped Lineprinter font.
  36 .
  37 The scalable fonts are available in sizes between 0.25 points and 999.75
  38 points,
  39 in 0.25-point increments;
  40 the Lineprinter font is available only in 8.5-point size.
  41 .
  42 .
  43 .LP
  44 The LaserJet font files included with
  45 .B groff
  46 assume that all printers since the LaserJet\~4 are identical.
  47 .
  48 There are some differences between fonts in the earlier and more recent
  49 printers,
  50 however.
  51 .
  52 The LaserJet\~4 printer used Agfa Intellifont technology for 35 of the
  53 internal scalable fonts;
  54 the remaining 10 scalable fonts were TrueType.
  55 .
  56 Beginning with the LaserJet\~\%4000-series printers introduced in 1997,
  57 all scalable internal fonts have been TrueType.
  58 .
  59 The number of printable glyphs differs slightly between Intellifont and
  60 TrueType fonts
  61 (generally,
  62 the TrueType fonts include more glyphs),
  63 and
  64 there are some minor differences in glyph metrics.
  65 .
  66 Differences among printer models are described in the
  67 .I "PCL\~5 Comparison Guide"
  68 and the
  69 .I "PCL\~5 Comparison Guide Addendum"
  70 (for printers introduced since approximately 2001).
  71 .
  72 .
  73 .LP
  74 LaserJet printers reference a glyph by a combination of a 256-glyph
  75 symbol set and an index within that symbol set.
  76 .
  77 Many glyphs appear in more than one symbol set;
  78 all combinations of symbol set and index that reference the same glyph
  79 are equivalent.
  80 .
  81 For each glyph,
  82 .BR hpftodit (@MAN1EXT@)
  83 searches a list of symbol sets,
  84 and selects the first set that contains the glyph.
  85 .
  86 The printing code generated by
  87 .B hpftodit
  88 is an integer that encodes a numerical value for the symbol set in the
  89 high byte(s),
  90 and the index in the low byte.
  91 .
  92 See
  93 .BR groff_font (@MAN5EXT@)
  94 for a complete description of the font file format;
  95 symbol sets are described in greater detail in the
  96 .IR "PCL\~5 Printer Language Technical Reference Manual" .
  97 .
  98 .
  99 .LP
 100 Two of the scalable fonts,
 101 Symbol and Wingdings,
 102 are bound to 256-glyph symbol sets;
 103 the remaining scalable fonts,
 104 as well as the Lineprinter font,
 105 support numerous symbol sets,
 106 sufficient to enable printing of more than 600 glyphs.
 107 .
 108 .
 109 .LP
 110 The metrics generated by
 111 .B hpftodit
 112 assume that the DESC file contains values of 1200 for
 113 .I res
 114 and 6350 for
 115 .IR unitwidth ,
 116 or any combination
 117 (e.g.,
 118 2400 and 3175)
 119 for which
 120 .IR res \~\[tmu]\~ unitwidth \~=\~7\|620\|000.
 121 .
 122 Although HP PCL\~5 LaserJet printers support an internal resolution of
 123 7200 units per inch,
 124 they use a 16-bit signed integer for cursor positioning;
 125 if
 126 .B devlj4
 127 is to support U.S.\& ledger paper (11\~in\~\[mu]\~17\~in;
 128 in = inch),
 129 the maximum usable resolution is 32\|767\~\[di]\~17,
 130 or 1927 units per inch,
 131 which rounds down to 1200 units per inch.
 132 .
 133 If the largest required paper size is less
 134 (e.g.,
 135 8.5\~in\~\[mu]\~11\~in,
 136 or A5),
 137 a greater
 138 .I res
 139 (and lesser
 140 .IR unitwidth )
 141 can be specified.
 142 .
 143 .
 144 .\" ====================================================================
 145 .SH LIMITATIONS
 146 .\" ====================================================================
 147 .
 148 Font metrics for Intellifont fonts were provided by Tagged Font Metric
 149 (TFM) files originally developed by Agfa/Compugraphic.
 150 .
 151 The TFM files provided for these fonts supported 600+ glyphs and
 152 contained extensive lists of kerning pairs.
 153 .
 154 .
 155 .LP
 156 To accommodate developers who had become accustomed to TFM files,
 157 HP also provided TFM files for the 10 TrueType fonts included in the
 158 LaserJet\~4.
 159 .
 160 The TFM files for TrueType fonts generally included less information
 161 than the Intellifont TFMs,
 162 supporting fewer glyphs,
 163 and in most cases,
 164 providing no kerning information.
 165 .
 166 By the time the LaserJet\~4000 printer was introduced,
 167 most developers had migrated to other means of obtaining font metrics,
 168 and support for new TFM files was very limited.
 169 .
 170 The TFM files provided for the TrueType fonts in the LaserJet\~4000
 171 support only the Latin 2 (ISO 8859-2) symbol set,
 172 and include no kerning information;
 173 consequently,
 174 they are of little value for any but the most rudimentary documents.
 175 .
 176 .
 177 .LP
 178 Because the Intellifont TFM files contain considerably more information,
 179 they generally are preferable to the TrueType TFM files even for use
 180 with the TrueType fonts in the newer printers.
 181 .
 182 The metrics for the TrueType fonts are very close,
 183 though not identical,
 184 to those for the earlier Intellifont fonts of the same names.
 185 .
 186 Although most output using the Intellifont metrics with the newer
 187 printers is quite acceptable,
 188 a few glyphs may fail to print as expected.
 189 .
 190 The differences in glyph metrics may be particularly noticeable with
 191 composite parentheses,
 192 brackets,
 193 and braces used by
 194 .BR eqn (@MAN1EXT@) .
 195 .
 196 A script,
 197 located in
 198 .IR @FONTDIR@/\:devlj4/\:generate ,
 199 can be used to adjust the metrics for these glyphs in the special font
 200 \[lq]S\[rq] for use with printers that have all TrueType fonts.
 201 .
 202 .
 203 .LP
 204 At the time HP last supported TFM files,
 205 only version 1.0 of the Unicode standard was available.
 206 .
 207 Consequently,
 208 many glyphs lacking assigned code points were assigned by HP to the
 209 Private Use Area (PUA).
 210 .
 211 Later versions of the Unicode standard included code points outside the
 212 PUA for many of these glyphs.
 213 .
 214 The HP-supplied TrueType TFM files use the PUA assignments;
 215 TFM files generated from more recent TrueType font files require the
 216 later Unicode values to access the same glyphs.
 217 .
 218 Consequently,
 219 two different mapping files may be required:
 220 one for the HP-supplied TFM files,
 221 and one for more recent TFM files.
 222 .
 223 .
 224 .\" ====================================================================
 225 .SH FILES
 226 .\" ====================================================================
 227 .
 228 .TP
 229 .I @FONTDIR@/\:devlj4/\:DESC
 230 device description file
 231 .
 232 .
 233 .TP
 234 .IR @FONTDIR@/\:devlj4/\: F
 235 font description file for font
 236 .I F
 237 .
 238 .
 239 .TP
 240 .I @FONTDIR@/\:devlj4/\:generate
 241 corrects Intellifont-based height metrics for several glyphs in the
 242 special font for TrueType CG Times (LaserJet\~4000 and later).
 243 .
 244 .
 245 .\" ====================================================================
 246 .SH "SEE ALSO"
 247 .\" ====================================================================
 248 .
 249 .BR groff (@MAN1EXT@),
 250 .BR hpftodit (@MAN1EXT@),
 251 .BR grolj4 (@MAN1EXT@),
 252 .BR groff_font (@MAN5EXT@)
 253 .
 254 .
 255 .\" ====================================================================
 256 .\" Editor settings
 257 .\" ====================================================================
 258 .
 259 .\" Local Variables:
 260 .\" mode: nroff
 261 .\" fill-column: 72
 262 .\" End:
 263 .\" vim: set filetype=groff textwidth=72: