1151497Sru.tr ~ 279543Sru.ig 3151497SruCopyright (C) 1994-2000, 2001, 2003, 2004 Free Software Foundation, Inc. 475584Sru 575584SruPermission is granted to make and distribute verbatim copies of 675584Sruthis manual provided the copyright notice and this permission notice 775584Sruare preserved on all copies. 875584Sru 975584SruPermission is granted to copy and distribute modified versions of this 1075584Srumanual under the conditions for verbatim copying, provided that the 1175584Sruentire resulting derived work is distributed under the terms of a 1275584Srupermission notice identical to this one. 1375584Sru 1475584SruPermission is granted to copy and distribute translations of this 1575584Srumanual into another language, under the above conditions for modified 1675584Sruversions, except that this permission notice may be included in 1775584Srutranslations approved by the Free Software Foundation instead of in 1875584Sruthe original English. 1975584Sru.. 2075584Sru.\" Like TP, but if specified indent is more than half 2175584Sru.\" the current line-length - indent, use the default indent. 2275584Sru.de Tp 2375584Sru.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 2475584Sru.el .TP "\\$1" 2575584Sru.. 26151497Sru.de CW 27151497Sru.ie \\n(.$>2 \&\\$1\f(CR\\$2\fP\\$3 28151497Sru.el \&\f(CR\\$1\fP\\$2 29151497Sru.. 30151497Sru.tr ~ 3175584Sru.TH HPFTODIT @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 32151497Sru.\" -------------------------------------------------------------------------- 3375584Sru.SH NAME 34151497Sru.\" -------------------------------------------------------------------------- 3575584Sruhpftodit \- create font description files for use with groff \-Tlj4 36151497Sru.\" -------------------------------------------------------------------------- 3775584Sru.SH SYNOPSIS 38151497Sru.\" -------------------------------------------------------------------------- 3975584Sru.B hpftodit 4075584Sru[ 41151497Sru.B \-adqsv 4275584Sru] 4375584Sru[ 4475584Sru.BI \-i n 4575584Sru] 4675584Sru.I tfm_file 4775584Sru.I map_file 4875584Sru.I font 4975584Sru.PP 5075584SruIt is possible to have whitespace between the 5175584Sru.B \-i 52151497Sruoption and its parameter. 53151497Sru.\" -------------------------------------------------------------------------- 5475584Sru.SH DESCRIPTION 55151497Sru.\" -------------------------------------------------------------------------- 5675584Sru.B hpftodit 57151497Srucreates a font file for use with a Hewlett-Packard LaserJet~4\(enseries 58151497Sru(or newer) printer with 59151497Sru.BR "groff \-Tlj4" , 60151497Sruusing data from an HP tagged font metric (TFM) file. 6175584Sru.I tfm_file 62151497Sruis the name of the TFM file for the font; Intellifont and 63151497SruTrueType TFM files are supported, but symbol set TFM files are not. 6475584Sru.I map_file 65151497Sruis a file giving the groff names for characters in the font; this file 66151497Srushould consist of a sequence of lines of the form: 6775584Sru.IP 6875584Sru.I 69151497Srum u c1 c2 \fR.\|.\|. [ 70151497Sru.CW # 71151497Sru.I comment 72151497Sru] 7375584Sru.LP 7475584Sruwhere 75151497Sru.I m 7675584Sruis a decimal integer giving the MSL number of the character, 77151497Sru.I u 78151497Sruis a hexadecimal integer giving the Unicode value of the character, 7975584Sruand 8075584Sru.IR c1 , 81151497Sru.IR c2 ", .\|.\|." 8275584Sruare the groff names of the character. 83151497SruThe values can be separated by any whitespace; the Unicode value must 84151497Sruuse uppercase digits A\^\(en\^F, and must be without a leading 85151497Sru.CW ` 0x ', 86151497Sru.CW ` u ', 87151497Sruor 88151497Sru.CW ` U+ '. 89151497SruUnicode values corresponding to composite glyphs are decomposed; e.g., 90151497Sru.CW ` u00C0 ' 91151497Srubecomes 92151497Sru.CW ` u0041_0300 '. 93151497SruThe name for a glyph without a groff name may be given as 94151497Sru.CW u \fIXXXX\fP 95151497Sruif the glyph corresponds to a Unicode value, or as an unnamed glyph 96151497Sru.CW ` --- '. 97151497SruIf the given Unicode value is in the Private Use Area 98151497Sru(0xE000\^\(en\^0xF8FF), the glyph is included as an unnamed glyph. 99151497SruRefer to 100151497Sru.BR groff_diff (@MAN1EXT@) 101151497Srufor additional information about unnamed glyphs and how to access them. 102151497Sru.LP 103151497SruBlank lines and lines beginning with 104151497Sru.CW ` # ' 105151497Sruare ignored. 106151497SruA 107151497Sru.CW ` # ' 108151497Srufollowing one or more groff names begins a comment. 109151497SruBecause 110151497Sru.CW ` # ' 111151497Sruis a valid groff name, it must appear first in a list of 112151497Srugroff names if a comment is included, e.g., 113151497Sru.IP 114151497Sru.CW "3 0023 # # number sign" 115151497Sru.LP 116151497Sruor 117151497Sru.IP 118151497Sru.CW "3 0023 # sh # number sign" 119151497Sru.LP 120151497Srurather than 121151497Sru.IP 122151497Sru.CW "3 0023 sh # # number sign" 123151497Sru.LP 124151497Sruwhich will treat the first 125151497Sru.CW ` # ' 126151497Sruas the beginning of the comment. 127151497Sru.LP 12875584Sru.I font 12975584Sruis the name of the groff font file. 13075584SruThe groff font file is written to 131151497Sru.IR font ; 132151497Sruif 133151497Sru.I font 134151497Sruis specified as 135151497Sru.CW ` - ', 136151497Sruthe output is written to the standard output. 13775584Sru.LP 13875584SruThe 13975584Sru.B \-s 14075584Sruoption should be given if the font is special 14175584Sru(a font is 14275584Sru.I special 14375584Sruif 14475584Sru.B troff 14575584Srushould search it whenever 146151497Srua character is not found in the current font). 14775584SruIf the font is special, 14875584Sruit should be listed in the 14975584Sru.B fonts 15075584Srucommand in the DESC file; 15175584Sruif it is not special, there is no need to list it, since 15275584Sru.B troff 15375584Srucan automatically mount it when it's first used. 15475584Sru.LP 15575584SruIf the 15675584Sru.B \-i 15775584Sruoption is used, 15875584Sru.B hpftodit 159151497Sruautomatically will generate an italic correction, 16075584Srua left italic correction and a subscript correction 16175584Srufor each character 16275584Sru(the significance of these parameters is explained in 16375584Sru.BR groff_font (@MAN5EXT@)). 164151497Sru.\" -------------------------------------------------------------------------- 16575584Sru.SH OPTIONS 166151497Sru.\" -------------------------------------------------------------------------- 16775584Sru.TP 168151497Sru.B \-a 169151497SruInclude characters in the TFM file that are not included in the map 170151497Srufile. 171151497SruA glyph with corresponding Unicode value is given the name 172151497Sru.RI u XXXX ; 173151497Srua glyph without a Unicode value is included as an unnamed glyph 174151497Sru\&`\-\^\-\^\-'. 175151497SruA glyph with a Unicode value in the Private Use Area 176151497Sru(0xE000\^\(en\^0xF8FF) also is included as an unnamed glyph. 177151497Sru.IP 178151497SruThis option provides a simple means of adding Unicode-named and unnamed 179151497Sruglyphs to a font without including them in the map file, but it affords 180151497Srulittle control over which glyphs are placed in a regular font and which 181151497Sruare placed in a special font. 182151497SruThe presence or absence of the 183151497Sru.B \-s 184151497Sruoption has some effect on which glyphs are included: without the 185151497Sru.B \-s 186151497Sruoption, only the \(lqtext\(rq symbol sets are searched for matching 187151497Sruglyphs; with the 188151497Sru.B \-s 189151497Sruoption, only the \(lqmathematical\(rq symbol sets 190151497Sruare searched. 191151497SruNonetheless, restricting the symbol sets searched isn't very 192151497Sruselective\(emmany glyphs are placed in both regular and special fonts. 193151497SruNormally, the 194151497Sru.B \-a 195151497Sruoption should be used only as a last resort. 196151497Sru.\" -------------------------------------------------------------------------- 197151497Sru.TP 198151497Sru.B \-d 199151497SruDump information about the TFM file to the standard output; this option 200151497Srucan be useful for ensuring that a TFM file is a proper match for a font, 201151497Sruand that the contents of the TFM file are suitable. 202151497SruThe information includes the values of important TFM tags, and a listing 203151497Sru(by MSL number for Intellifont TFM files or by Unicode value for 204151497SruTrueType TFM files) of the glyphs included in the TFM file. 205151497SruThe unit of measure `DU' for some tags indicates design units; there are 206151497Sru8782 design units per em for Intellifont fonts, and 2048 design units 207151497Sruper em for TrueType fonts. 208151497SruNote that the accessibility of a glyph depends on its inclusion in a 209151497Srusymbol set; some TFM files list many glyphs but only a few symbol sets. 210151497Sru.IP 211151497SruThe glyph listing includes the glyph index within the TFM file, the MSL 212151497Sruor Unicode value, and the symbol set and character code that will be 213151497Sruused to print the glyph. 214151497SruIf 215151497Sru.I map_file 216151497Sruis given, 217151497Srugroff names are given for matching glyphs. 218151497SruIf only the glyph index and MSL or Unicode value are given, the glyph 219151497Srudoes not appear in any supported symbol set and cannot be printed. 220151497Sru.IP 221151497SruWith the 222151497Sru.B \-d 223151497Sruoption, 224151497Sru.I map_file 225151497Sruis optional, and 226151497Sru.I font 227151497Sruis ignored if given. 228151497Sru.\" -------------------------------------------------------------------------- 229151497Sru.TP 230151497Sru.B \-q 231151497SruSuppress warnings about characters in the map file that were not found 232151497Sruin the TFM file. 233151497SruWarnings never are given for unnamed glyphs or by glyphs named by their 234151497SruUnicode values. 235151497SruThis option is useful when sending the output of 236151497Sru.B hpftodit 237151497Sruto the standard output. 238151497Sru.\" -------------------------------------------------------------------------- 239151497Sru.TP 24075584Sru.B \-v 241151497SruPrint the 242151497Sru.B hpftodit 243151497Sruversion number. 244151497Sru.\" -------------------------------------------------------------------------- 24575584Sru.TP 24675584Sru.B \-s 24775584SruThe font is special. 248151497SruThis option adds the 24975584Sru.B special 250151497Srucommand to the font file, and affects the order in which HP symbol sets 251151497Sruare searched for each glyph. 252151497SruWithout the 253151497Sru.B \-s 254151497Sruoption, the \(lqtext\(rq sets are searched before 255151497Sruthe \(lqmathematical\(rq symbol sets. 256151497SruWith the 257151497Sru.B \-s 258151497Sruoption, the search order is reversed. 259151497Sru.\" -------------------------------------------------------------------------- 26075584Sru.TP 26175584Sru.BI \-i n 262151497SruGenerate an italic correction for each character so that the character's 263151497Sruwidth plus the character's italic correction is equal to 26475584Sru.I n 265151497Sruthousandths of an em plus the amount by which the right edge of the 266151497Srucharacter's bounding is to the right of the character's origin. 267151497SruIf this would result in a negative italic correction, use a zero italic 268151497Srucorrection instead. 26975584Sru.IP 27075584SruAlso generate a subscript correction equal to the 27175584Sruproduct of the tangent of the slant of the font and 27275584Srufour fifths of the x-height of the font. 27375584SruIf this would result in a subscript correction greater than the italic 27475584Srucorrection, use a subscript correction equal to the italic correction 27575584Sruinstead. 27675584Sru.IP 27775584SruAlso generate a left italic correction for each character 27875584Sruequal to 27975584Sru.I n 280151497Sruthousandths of an em plus the amount by which the left edge of the 281151497Srucharacter's bounding box is to the left of the character's origin. 28275584SruThe left italic correction may be negative. 28375584Sru.IP 284151497SruThis option normally is needed only with italic or oblique fonts; 285151497Srua value of 50 (0.05 em) usually is a reasonable choice. 286151497Sru.\" -------------------------------------------------------------------------- 28775584Sru.SH FILES 288151497Sru.\" -------------------------------------------------------------------------- 289151497Sru.ad 0 290151497Sru.TP \w'\fB@FONTDIR@/devlj4/generate/\fP\fI*\fP.map'u+2n 29175584Sru.B @FONTDIR@/devlj4/DESC 29275584SruDevice description file. 29375584Sru.TP 29475584Sru.BI @FONTDIR@/devlj4/ F 29575584SruFont description file for font 29675584Sru.IR F . 297151497Sru.TP 298151497Sru.BI @FONTDIR@/devlj4/generate/ * .map 299151497SruSymbol mapping files 300151497Sru.\" -------------------------------------------------------------------------- 30175584Sru.SH "SEE ALSO" 302151497Sru.\" -------------------------------------------------------------------------- 30375584Sru.BR groff (@MAN1EXT@), 304151497Sru.BR groff_diff (@MAN1EXT@), 30575584Sru.BR grolj4 (@MAN1EXT@), 306151497Sru.BR groff_font (@MAN5EXT@), 307151497Sru.BR lj4_font (@MAN5EXT@) 30879543Sru. 30979543Sru.\" Local Variables: 31079543Sru.\" mode: nroff 31179543Sru.\" End: 312