# grolbp

## Name



           grolbp - _groff_ output driver for Canon CaPSL printers
    


## Synopsis



           **grolbp**[**-l**] [**-c** _num-copies_] [**-F** _font-directory_] [**-o** _orientation_]
                  [**-p** _paper-format_] [**-w** _width_] [_file_ ...]
    
           **grolbp**[**--copies=**_num-copies_] [**--fontdir=**_font-directory_]
                  [**--landscape**] [**--linewidth=**_width_]
                  [**--orientation=**_orientation_] [**--papersize=**_paper-format_]
                  [_file_ ...]
    
           **grolbp -h**
    
           **grolbp --help**
    
           **grolbp -v**
    
           **grolbp --version**
    


## Description



           This GNU _roff_ output driver translates the output of _troff_(1) into
           a CaPSL and VDM format suitable for Canon LBP-4 and LBP-8
           printers.  Normally, _grolbp_ is invoked by _groff_(1) when the latter
           is given the “**-T lbp** ” 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 “-”, _grolbp_ reads the standard input stream.  It writes to the
           standard output stream.
    
       **Typefaces**
           The driver supports the Dutch, Swiss, and Swiss-Narrow scalable
           typefaces, each in the regular, bold, italic, and bold-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** │  **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 format, orientation, and device description file**
           _grolbp_ supports paper formats “**A4** ”, “**letter** ”, “**legal** ”, and
           “**executive** ”.  These are matched case-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_ (case-insensitively) recognizes an
           **orientation** directive accepting one mandatory argument, **portrait**
           or **landscape**.  The first valid orientation directive encountered
           controls.  The **-l** , **-o** , and **--orientation** command-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
           _groff_font_(5), _grolbp_ recognizes **lbpname** , which maps the _groff_
           font name to the font name used internally by the printer.  Its
           syntax is as follows.
                  lbpname _printer-font-name_
           **lbpname** 's argument is case-sensitive.  The printer's font names
           are encoded as follows.
    
           For bitmapped fonts, _printer-font_name_ has the form **N** ⟨ _base-font-_
           _name_ ⟩⟨ _font-style_ ⟩.  _base-font-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.  _font-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 “font listing A”
           shows “Nelite12I.ISO_USA”, 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 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-italic style, which
           appears in the font listing as “Swiss-BoldOblique”, “**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 _grolj4_(1), an additional drawing command is
           available.
    
           **\D'R** _dh dv_**'**
                  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** _num-copies_
           **--copies=**_num-copies_
                  Produce _num-copies_ copies of each page.
    
           **-F** _font-directory_
           **--fontdir=**_font-directory_
                  Prepend directory font-directory _/dev_ name 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
                  “**portrait** ” or “**landscape** ”.
    
           **-p** _paper-format_
           **--papersize=**_paper-format_
                  Set the paper format to _paper-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).
    


## Exit status



           _grolbp_ exits with status **0** on successful operation, status **2** if
           the program cannot interpret its command-line arguments, and
           status **1** if it encounters an error during operation.
    


## Environment



           _GROFF_FONT_PATH_
                  lists directories in which to seek the selected output
                  device's directory of device and font description files.
                  See _troff_(1) and _groff_font_(5).
    


## Files



           _/usr/local/share/groff/1.23.0/font/devlbp/DESC_
                  describes the **lbp** output device.
    
           _/usr/local/share/groff/1.23.0/font/devlbp/_ F
                  describes the font known as _F_ on device **lbp**.
    
           _/usr/local/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



           _groff_(1), _troff_(1), _groff_out_(5), _groff_font_(5), _groff_char_(7)
    


* * *