GROLBP
Section: User Commands (1)
Updated: 21 March 2020
Index
Return to Main Contents
NAME
grolbp - groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser printers)
SYNOPSIS
[ -l ]
[ -c num-copies ]
[ -F font-directory ]
[ -o orientation ]
[ -p paper-size ]
[ -w width ]
[file
...]
[--copies=num-copies] [--fontdir=font-directory] [--landscape] [--linewidth=width] [--orientation=orientation] [--papersize=paper-size]
[file
...]
-h
--help
-v
--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 |
| Swiss Narrow |
| Courier |
| Elite |
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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- TYPEFACES
-
- PAPER SIZES
-
- PAGE ORIENTATION
-
- FONT FILE FORMAT
-
- ENVIRONMENT
-
- FILES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 08:55:11 GMT, December 16, 2021