grolbp
Section: User Commands (1)
Updated: 2 July 2023
Index
Return to Main Contents
Name
grolbp -
groff
output driver for Canon CaPSL printers
.nr d-fallback 1
.nr d-fallback 1
Synopsis
[
-l]
[
-c~nu-copies]
[
-F~fon-directory]
[
-o~orientation]
[
-p~pape-format]
[
-w~width]
[
file~...]
[
--copies=nu-copies] [
--fontdir=fon-directory] [
--landscape] [
--linewidth=width] [
--orientation=orientation] [
--papersize=pape-format]
[
file~...]
-h
--help
-v
--version
Description
This GNU
roff
output driver translates the output of
into a CaPSL and VDM format suitable for Canon LB-4 and LB-8 printers.
Normally,
grolbp
is invoked by
when the latter is given the
[lq]
-T~lbp[rq]
option.
(In this installation,
ps
is the default output device.)
Use
groff's
-P
option to pass any options shown above to
grolbp.
If no
file
arguments are given,
or if
file
is [lq]-[rq],
grolbp
reads the standard input stream.
Output is written to the standard output stream.
Typefaces
The driver supports the Dutch,
Swiss,
and Swis-Narrow scalable typefaces,
each in the regular,
bold,
italic,
and bol-italic styles.
Additionally,
the bitmapped,
monospaced Courier and Elite typefaces are available in regular,
bold,
and
italic styles;
Courier at 8 and 12 points,
Elite at 8 and 10 points.
The following chart summarizes the
groff
font names used to access them.
| Typeface | Roman | Bold | Italic | Bol-Italic
|
| Dutch | TR | TB | TI | TBI
|
| Swiss |
| Swiss Narrow |
| Courier |
| Elite |
Paper format, orientation, and device description file
grolbp
supports paper formats
[lq]
A4[rq],
[lq]
letter[rq],
[lq]
legal[rq],
and
[lq]
executive[rq].
These are matched cas-insensitively.
The
-p,
--papersize
option overrides any setting in the device description file
DESC.
If neither specifies a paper format,
A4 is assumed.
In its
DESC
file,
grolbp
(cas-insensitively) recognizes an
orientation
directive accepting one mandatory argument,
portrait
or
landscape.
The first valid orientation directive encountered controls.
The
-l,
-o,
and
--orientation
comman-line options
override any setting in
DESC.
If none of the foregoing specify the orientation,
portrait is assumed.
Font description files
In addition to the font description file directives documented in
grolbp
recognizes
lbpname,
which maps the
groff
font name to the font name used internally by the printer.
Its syntax is as follows.
-
lbpname~printe-fon-name
lbpname's
argument is cas-sensitive.
The printer's font names are encoded as follows.
For bitmapped fonts,
printe-font_name
has the form
-
N[la]bas-fon-name[ra][la]fon-style[ra]
bas-fon-name
is the font name as it appears in the printer's font listings without
the first letter,
up to
(but not including)
the font size.
fon-style
can be one of the letters
R,
I,
or
B,
indicating the roman,
italic,
and bold styles,
respectively.
For instance,
if the printer's [lq]font listing A[rq]
shows [lq]Nelite12I.ISO_USA[rq],
the corresponding entry in the
groff
font description file is
-
lbpname NeliteI
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 har-coded into the program.
For scalable fonts,
printe-fon-name
is identical to the font name as it appears in the printer's [lq]font
listing A[rq].
For instance,
to select the [lq]Swiss[rq] font in bol-italic style,
which appears in the font listing
as [lq]Swiss-BoldOblique[rq],
-
lbpname Swiss-BoldOblique
is the required directive,
and this is what we find in the
groff
font description file
HBI
for the
lbp
device.
Drawing commands
For compatibility with
an additional drawing command is available.
- [rs]D[aq]R~dh dv[aq]
-
Draw a rule
(solid black rectangle)
with one corner at the drawing position,
and the diagonally opposite corner at the drawing position
+(dh,dv).
Options
-h
and
--help
display a usage message,
while
-v
and
--version
show version information;
all exit afterward.
- -c nu-copies
-
--copies=nu-copies
Produce
nu-copies
copies of each page.
- -F fon-directory
-
--fontdir=fon-directory
Prepend directory
fon-directory/devname
to the search path for font and device description files;
name
is the name of the device,
usually
lbp.
- -l
-
--landscape
Format the document in landscape orientation.
- -o orientation
-
--orientation=orientation
Format the document in the given
orientation,
which must be
[lq]portrait[rq]
or
[lq]landscape[rq].
- -p pape-format
-
--papersize=pape-format
Set the paper format to
pape-format,
which must be a valid paper format as described above.
- -w width
-
--linewidth=width
Set the default line thickness to
width
thousandths of an em;
the default is
40
(0.04~em).
Environment
- GROFF_FONT_PATH
-
lists directories in which to seek the selected output device's
directory of device and font description files.
See
and
Files
- /usr/:share/:groff/:1.23.0/:font/:devlbp/:DESC
-
describes the
lbp
output device.
- /usr/:share/:groff/:1.23.0/:font/:devlbp/F
-
describes the font known
as~F
on device
lbp.
- /usr/:share/:groff/:1.23.0/:tmac/:lbp:.tmac
-
defines macros for use with the
lbp
output device.
It is automatically loaded by
troffrc
when the
lbp
output device is selected.
See also
Index
- Name
-
- Synopsis
-
- Description
-
- Typefaces
-
- Paper format, orientation, and device description file
-
- Font description files
-
- Drawing commands
-
- Options
-
- Environment
-
- Files
-
- See also
-
|
|
- Running on 
-
:
