# grolbp(1) - man - phpMan [GROLBP(1)](https://www.chedong.com/phpMan.php/man/GROLBP/1/markdown) General Commands Manual [GROLBP(1)](https://www.chedong.com/phpMan.php/man/GROLBP/1/markdown) ## 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)](https://www.chedong.com/phpMan.php/man/grolj4/1/markdown) 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 **--copies=**_num-copies_ Print _num-copies_ copies of each page. ### -F **--fontdir=**_font-directory_ Prepend directory font-directory_/dev_name to the search path for font and device de‐ scription 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_ Print the document with _orientation_ orientation, which must be ‘portrait’ or ‘land‐ scape’. ### -p **--papersize=**_paper-size_ Set the paper size to _paper-size_, which must be a valid paper size description as in‐ dicated in section “Paper Sizes”, below. ### -v ### --version Print the version number. ### -w **--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)](https://www.chedong.com/phpMan.php/man/font/5/markdown) 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** op‐ tion 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)](https://www.chedong.com/phpMan.php/man/font/5/markdown), **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 cor‐ responding 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 _dev_name directory in addition to the default ones. See [**troff**(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown) and **groff**___**[font**(5)](https://www.chedong.com/phpMan.php/man/font/5/markdown) 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)](https://www.chedong.com/phpMan.php/man/groff/1/markdown), [**troff**(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown), **groff**___**[out**(5)](https://www.chedong.com/phpMan.php/man/out/5/markdown), **groff**___**[font**(5)](https://www.chedong.com/phpMan.php/man/font/5/markdown), **groff**___**[char**(7)](https://www.chedong.com/phpMan.php/man/char/7/markdown) groff 1.22.4 23 March 2022 [GROLBP(1)](https://www.chedong.com/phpMan.php/man/GROLBP/1/markdown)