1grolbp(1) General Commands Manual grolbp(1)
2
6 grolbp - groff output driver for Canon CaPSL printers
7
9 grolbp [-l] [-c num-copies] [-F font-directory] [-o orientation]
10 [-p paper-format] [-w width] [file ...]
11 grolbp [--copies=num-copies] [--fontdir=font-directory] [--landscape]
12 [--linewidth=width] [--orientation=orientation]
13 [--papersize=paper-format] [file ...]
14 grolbp -h
16 grolbp --help
17 grolbp -v
19 grolbp --version
20
22 This GNU roff output driver translates the output of troff(1) into a
23 CaPSL and VDM format suitable for Canon LBP-4 and LBP-8 printers. Nor‐
24 mally, grolbp is invoked by groff(1) when the latter is given the
25 “-T lbp” option. (In this installation, ps is the default output de‐
26 vice.) Use groff's -P option to pass any options shown above to
27 grolbp. If no file arguments are given, or if file is “-”, grolbp
28 reads the standard input stream. Output is written to the standard
29 output stream.
30 Typefaces
32 The driver supports the Dutch, Swiss, and Swiss-Narrow scalable type‐
33 faces, each in the regular, bold, italic, and bold-italic styles. Ad‐
34 ditionally, the bitmapped, monospaced Courier and Elite typefaces are
35 available in regular, bold, and italic styles; Courier at 8 and 12
36 points, Elite at 8 and 10 points. The following chart summarizes the
37 groff font names used to access them.
38 ┌──────────────┬─────────┬────────┬──────────┬──────────────┐
40 │ Typeface │ Roman │ Bold │ Italic │ Bold-Italic │
41 ├──────────────┼─────────┼────────┼──────────┼──────────────┤
42 │Dutch │ TR │ TB │ TI │ TBI │
43 ├──────────────┼─────────┼────────┼──────────┼──────────────┤
44 │Swiss │ HR │ HB │ HI │ HBI │
45 ├──────────────┼─────────┼────────┼──────────┼──────────────┤
46 │Swiss Narrow │ HNR │ HNB │ HNI │ HNBI │
47 ├──────────────┼─────────┼────────┼──────────┼──────────────┤
48 │Courier │ CR │ CB │ CI │ │
49 ├──────────────┼─────────┼────────┼──────────┼──────────────┤
50 │Elite │ ER │ EB │ EI │ │
51 └──────────────┴─────────┴────────┴──────────┴──────────────┘
52 Paper format, orientation, and device description file
53 grolbp supports paper formats “A4”, “letter”, “legal”, and “executive”.
54 These are matched case-insensitively. The -p, --papersize option over‐
55 rides any setting in the device description file DESC. If neither
56 specifies a paper format, A4 is assumed.
57 In its DESC file, grolbp (case-insensitively) recognizes an orientation
59 directive accepting one mandatory argument, portrait or landscape. The
60 first valid orientation directive encountered controls. The -l, -o,
61 and --orientation command-line options override any setting in DESC.
62 If none of the foregoing specify the orientation, portrait is assumed.
63 Font description files
65 In addition to the font description file directives documented in
66 groff_font(5), grolbp recognizes lbpname, which maps the groff font
67 name to the font name used internally by the printer. Its syntax is as
68 follows.
69 lbpname printer-font-name
70 lbpname's argument is case-sensitive. The printer's font names are en‐
71 coded as follows.
72 For bitmapped fonts, printer-font_name has the form
74 N⟨base-font-name⟩⟨font-style⟩
75 base-font-name is the font name as it appears in the printer's font
76 listings without the first letter, up to (but not including) the font
77 size. font-style can be one of the letters R, I, or B, indicating the
78 roman, italic, and bold styles, respectively. For instance, if the
79 printer's “font listing A” shows “Nelite12I.ISO_USA”, the corresponding
80 entry in the groff font description file is
81 lbpname NeliteI
82 You may need to modify grolbp to add support for new bitmapped fonts,
83 since the available font names and font sizes of bitmapped fonts (as
84 documented above) are hard-coded into the program.
85 For scalable fonts, printer-font-name is identical to the font name as
87 it appears in the printer's “font listing A”. For instance, to select
88 the “Swiss” font in bold-italic style, which appears in the font list‐
89 ing as “Swiss-BoldOblique”,
90 lbpname Swiss-BoldOblique
91 is the required directive, and this is what we find in the groff font
92 description file HBI for the lbp device.
93 Drawing commands
95 For compatibility with grolj4(1), an additional drawing command is
96 available.
97 \D'R dh dv'
99 Draw a rule (solid black rectangle) with one corner at the draw‐
100 ing position, and the diagonally opposite corner at the drawing
101 position +(dh,dv).
102
104 -h and --help display a usage message, while -v and --version show ver‐
105 sion information; all exit afterward.
106 -c num-copies
108 --copies=num-copies
109 Produce num-copies copies of each page.
110 -F font-directory
112 --fontdir=font-directory
113 Prepend directory font-directory/devname to the search path for
114 font and device description files; name is the name of the de‐
115 vice, usually lbp.
116 -l
118 --landscape
119 Format the document in landscape orientation.
120 -o orientation
122 --orientation=orientation
123 Format the document in the given orientation, which must be
124 “portrait” or “landscape”.
125 -p paper-format
127 --papersize=paper-format
128 Set the paper format to paper-format, which must be a valid pa‐
129 per format as described above.
130 -w width
132 --linewidth=width
133 Set the default line thickness to width thousandths of an em;
134 the default is 40 (0.04 em).
135
137 GROFF_FONT_PATH
138 lists directories in which to seek the selected output device's
139 directory of device and font description files. See troff(1)
140 and groff_font(5).
141
143 /usr/share/groff/1.23.0/font/devlbp/DESC
144 describes the lbp output device.
145 /usr/share/groff/1.23.0/font/devlbp/F
147 describes the font known as F on device lbp.
148 /usr/share/groff/1.23.0/tmac/lbp.tmac
150 defines macros for use with the lbp output device. It is auto‐
151 matically loaded by troffrc when the lbp output device is se‐
152 lected.
153
155 groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7)
156groff 1.23.0 2 November 2023 grolbp(1)