FONTFILT(1) Unix Programmer's Manual FONTFILT(1) BNBABMBE fontfilt - font filter for cawf BSBYBNBOBPBSBIBS BfBoBnBtBfBiBlBt [ B-Bc IcIoInIfIiIg ] [ B-Bd IdIeIvIiIcIe ] [ B-Bf IfIoInIt ] [ B-Bh ] [ IfIiIlIe(Is) ] BDBEBSBCBRBIBPBTBIBOBN IFIoInItIfIiIlIt enhances IcIaIwIf(1) output with device-specific control sequences that select fonts and display bold and italic characters. (The IcIaIwIf B-BfBe option must be used to identify bold and italic characters.) BOBPBTBIBOBNBS IFIoInItIfIiIlIt options select the configuration file, the device, the font and the input source. B-Bc IcIoInIfIiIg specifies the name of the configuration file. (See the BDBEBVBIBCBEBS BABNBD BFBOBNBTBS and BCBOBNBFBIBGBUBRBABTBIBOBN BFBIBLBE sections for more information.) B-Bd IdIeIvIiIcIe specifies the printer output device. The default is the name of the last device in the configuration file, usually ``ansi''. B-Bf IfIoInIt specifies the desired printer font name. The default is device specific. B-Bh requests a usage information display (help) that includes a list of the devices and fonts that are supported. IfIiIlIe(Is) specify the paths to IcIaIwIf output files. BDBEBVBIBCBEBS BABNBD BFBOBNBTBS The devices and fonts that IfIoInItIfIiIlIt supports are defined in a configuration file. The default configuration file is named IfIoInItIfIiIlIt.IcIf and is located in Ic:/IsIyIs/IlIiIb/IcIaIwIf (the author's MS-DOS environment default). The IfIoInItIfIiIlIt.IcIf configuration file of this distribution defines the following devices and fonts. Use the B-Bh option to see the definitions of your active configuration file. (The first font named in the following listing and in the B-Bh display is the default for the device.) ansi ANSI terminal display (ANSI.SYS driver required for MS-DOS) Italic: Underscore Fonts: none epson dot matrix printer in Epson FX-86e/FX-800 mode Bold: Double-strike Fonts: none May, 1991 1 FONTFILT(1) Unix Programmer's Manual FONTFILT(1) ibmppds IBM Personal Printer Data Stream (PPDS) protocol Bold: Double-strike Italic: Underline Fonts: none kxp1180 Panasonic KX-P1180 dot matrix printer in PGM mode Bold: Emphasized Fonts: c10 10 Characters Per Inch (CPI) Courier c12 12 CPI Courier bps10 10 CPI Bold PS bps12 12 CPI Bold PS p10 10 CPI Prestige p12 12 CPI Prestige ss10 10 CPI Sans Serif ss12 12 CPI Sans Serif lj3 HP LaserJet III Fonts: c10 10 point, 12 Characters Per Inch (CPI) Courier c12ibm 12 point, 10 CPI Courier, IBM-PC Symbol Set lg12 12 point, 12 CPI Letter Gothic vgamono VGA monochrome monitor for MS-DOS (ANSI.SYS driver required for MS-DOS) Italic: Reverse-video Fonts: none BEBXBABMBPBLBEBS The IcIaIwIf invocation must use its B-BfBe option. The following example selects the 12 CPI Prestige font on a Panasonic KX-P1180 printer. cawf -fe -man cawf.1 | fontfilt -d kxp1180 -f p12 The following example selects the 12 CPI Letter Gothic font on an HP LaserJet III printer. cawf -fe -man cawf.1 > lj3.tmp fontfilt -dlj3 -flg12 lj3.tmp > lpt1: BCBOBNBFBIBGBUBRBABTBIBOBN BFBIBLBE IFIoInItIfIiIlIt searches for its configuration file in Ic:/IsIyIs/IlIiIb/IcIaIwIf (the author's MS-DOS environment default). This default can be overridden by the CAWFLIB environment variable, or changed in the source code. The configuration file has a simple format that conforms to the following rules. 1. Lines that begin with a pound sign (`#') a space or are zero in length are ignored. 2. Lines that begin with an alphabetic character name a device. 3. Device lines may be followed by lines that define the device escape control sequences for bold, italic and Roman characters, or font definitions. These definition lines must begin with a TAB, followed May, 1991 2 FONTFILT(1) Unix Programmer's Manual FONTFILT(1) by a single character defining the type of definition, followed by an equal sign (`='). 4. The bold, italic and Roman definition types are `b', `i' and `r'. An equal sign follows the single type character, and the device escape control sequence follows it. (See rule 6 for a description of the encoding of the control sequence.) 5. The font definition type is `f'. It's followed by an equal sign, the name of the font (it must not include an equal sign); another equal sign, terminating the font name; and after the second equal sign, the device control sequence to make the font active. (See rule 6 for a description of the encoding of the control sequence.) The first font definition for a device is assumed to be the default font for the device. 6. All characters following the equal sign up to the terminal end-of-line character are part of an escape control sequence. The sequence may contain any printable ASCII characters. Non-printable characters can be encoded in octal with the `\nnn' form, or in hexadecimal with the `\xnn' form. The special code, `\E' or `\e' represents the ESC control character, octal 033 (hexadecimal 1b). Here's an example showing the definition for the HP LaserJet III. All of its non-printable characters are ESC's; the first is coded with the octal form (`\033'); the second, with `\E'; the rest, with the hexadecimal form `\x1b'. # HP LaserJet III lj3 b=\033(s7B i=\E(s1S r=\x1b(s0B\x1b(s0S f=c10=\x1b&l0O\x1b(8U\x1b(s0p12h10v0s0b3T f=c12ibm=\x1b&l0O\x1b(10U\x1b(s0p10.00h12.0v0s0b3T f=lg12=\x1b&l0O\x1b(8U\x1b(s12h12v0s0b6T BSBEBE BABLBSBO bsfilt(1), cawf(1) and nroff(1). BDBIBABGBNBOBSBTBIBCBS Diagnostic messages are delivered to the standard error file. BHBIBSBTBOBRBY IFIoInItIfIiIlIt was written by Vic Abell, . Chet Creider had the idea for it and provided some device-specific prototypes, adapted from the IrIo work of Ted A. Campbell. (Campbell's IrIo is based on ROFF4.) May, 1991 3