Provided by: groff_1.22.4-10_amd64 
NAME
grolbp - groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser printers)
SYNOPSIS
grolbp [-l] [-c num-copies] [-F font-directory] [-o orientation] [-p paper-size]
[-w width] [file ...]
grolbp [--copies=num-copies] [--fontdir=font-directory] [--landscape] [--linewidth=width]
[--orientation=orientation] [--papersize=paper-size] [file ...]
grolbp -h
grolbp --help
grolbp -v
grolbp --version
DESCRIPTION
grolbp is a driver for groff that produces output in CAPSL and VDM format suitable for
Canon LBP-4 and LBP-8 printers.
For compatibility with grolj4(1) there is an additional drawing command available:
\D'R dh dv'
Draw a rule (i.e., a solid black rectangle), with one corner at the current
position, and the diagonally opposite corner at the current position +(dh,dv).
OPTIONS
Note that there can be whitespace between a one-letter option and its argument; on the
other hand, there must be whitespace and/or an equal sign (‘=’) between a long-name option
and its argument.
-c num-copies
--copies=num-copies
Print num-copies copies of each page.
-F font-directory
--fontdir=font-directory
Prepend directory font-directory/devname to the search path for font and device
description files; name is the name of the device, usually lbp.
-h
--help Print a short help text.
-l
--landscape
Print the document with a landscape orientation.
-o orientation
--orientation=orientation
Print the document with orientation orientation, which must be ‘portrait’ or
‘landscape’.
-p paper-size
--papersize=paper-size
Set the paper size to paper-size, which must be a valid paper size description as
indicated in section “Paper Sizes”, below.
-v
--version
Print the version number.
-w width
--linewidth=width
Set the default line thickness to width thousandths of an em. If this option isn't
specified, the line thickness defaults to 0.04 em.
TYPEFACES
The driver supports the Dutch, Swiss and Swiss-Narrow scalable typefaces, each one in the
Regular, Bold, Italic and Bold-Italic styles. Additionally, the Courier and Elite
monospaced typefaces at the sizes 8 and 12 points (for Courier) resp. 8 and 10 points (for
Elite) are supported, each one in the Regular, Bold and Italic styles.
The following chart summarizes the font names you can use to access these fonts:
┌────────────────┬───────────┬────────┬──────────┬──────────────┐
│ Typeface │ Regular │ Bold │ Italic │ Bold-Italic │
├────────────────┼───────────┼────────┼──────────┼──────────────┤
│ Dutch │ TR │ TB │ TI │ TBI │
├────────────────┼───────────┼────────┼──────────┼──────────────┤
│ Swiss │ HR │ HB │ HI │ HBI │
├────────────────┼───────────┼────────┼──────────┼──────────────┤
│ Swiss Narrow │ HNR │ HNB │ HNI │ HNBI │
├────────────────┼───────────┼────────┼──────────┼──────────────┤
│ Courier │ CR │ CB │ CI │ │
├────────────────┼───────────┼────────┼──────────┼──────────────┤
│ Elite │ ER │ EB │ EI │ │
└────────────────┴───────────┴────────┴──────────┴──────────────┘
PAPER SIZES
The paper size can be set in the DESC file or with command-line options to grolbp. If the
paper size is specified both ways, the command-line options take precedence over the
contents of the DESC file (this applies to the page orientation too).
See groff_font(5) how to set the paper dimensions in the DESC file.
To set the paper size in the command line, add
-p paper-size
or
--papersize=paper-size
to the other grolbp options, where paper-size is in the same format as in the DESC file.
If no paper size is specified in the DESC file or the command line, a default size of A4
is used.
PAGE ORIENTATION
As with the page size, the orientation of the printed page (portrait or landscape) can be
set in the DESC file or with command-line options. It is also case insensitive.
To set the orientation in the DESC file, insert a line with the following content:
orientation [portrait|landscape]
Only the first valid orientation command in the DESC file is used.
To set the page orientation with command-line options you can use the -o or --orientation
option with the same parameters (portrait or landscape) as in the DESC file. Or you can
use the -l option to force the pages to be printed in landscape.
FONT FILE FORMAT
In addition to the usual commands described in groff_font(5), grolbp provides the command
lbpname which sets the font name sent to the printer when requesting this font. The
syntax of this command is:
lbpname printer_font_name
• For bitmapped fonts, printer_font_name has the form
N⟨base_fontname⟩⟨font_style⟩
base_fontname is the font name as it appears in the printers font listings without
the first letter, up to (but not including) the font size. font_style can be one
of the letters R, I, or B, indicating the font styles Roman, Italic and Bold
respectively.
For instance, if the printer's font listing A shows font ‘Nelite12I.ISO_USA’, the
corresponding entry in the font description file is
lbpname NeliteI
Note that you may need to modify grolbp to add support for new bitmapped fonts,
since the available font names and font sizes of bitmapped fonts (as documented
above) are hard-coded into the program.
• For scalable fonts, printer_font_name is identical to the font name as it appears
in the printer's font listing A.
For instance, to select the ‘Swiss’ font in bold style, which appears in the
printer's font listing A as ‘Swiss-Bold’, the required lbpname command line is
lbpname Swiss-Bold
The argument of lbpname is case sensitive.
ENVIRONMENT
GROFF_FONT_PATH
A list of directories in which to search for the devname directory in addition to
the default ones. See troff(1) and groff_font(5) for more details.
FILES
/usr/share/groff/1.22.4/font/devlbp/DESC
Device description file.
/usr/share/groff/1.22.4/font/devlbp/F
Font description file for font F.
/usr/share/groff/1.22.4/tmac/lbp.tmac
Macros for use with grolbp.
SEE ALSO
groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7)