www.LinuxHowtos.org

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.

Index

Name

Synopsis

Description

Typefaces
Paper format, orientation, and device description file
Font description files
Drawing commands